冰雨奇缘 pbootcms单页模板常用字段详细说明
如遇下载链接蓝奏网盘打不开lanzous替换成lanzoux尝试！ 广告
在 PbootCMS 中，单页（通常指后台“专题”模型或特定标识的单页内容）的字段调用非常灵活。为了帮助你更好地定制模板，以下是常用字段的详细分类说明及调用语法。
📌 核心调用语法区别
在开始之前，请明确两种常见的调用场景，语法略有不同：
当前页面直接渲染（如 about.html）：直接使用 {single:字段名} 或 {content:字段名}。
在其他页面调用指定单页（如首页调用“关于我们”）使用 {pboot:single scode=’xxx’}…{/pboot:single} 标签包裹，内部使用 {single:字段名}。
1. 基础信息字段
这些是单页最核心的内容，适用于所有单页。
表格
字段标签 说明 示例用法
{single:title} 标题：单页的标题，常用于 <h1> 或 <title>。 <h1>{single:title}</h1>
{single:content} 正文内容：后台编辑器输入的富文本 HTML 内容。 <div class=”intro”>{single:content}</div>
{single:subname} 副标题：后台设置的副标题字段。 <h2>{single:subname}</h2>
{single:date} 发布时间：默认格式为 Y-m-d H:i:s。 <span>发布：{single:date}</span>
{single:update_time} 更新时间：最后修改的时间戳。 <span>更新：{single:update_time}</span>
💡 技巧：如果需要格式化时间，可以使用 style 参数，例如 {single:date style=Y年m月d日}。
2. SEO优化字段
用于提升搜索引擎收录效果，建议在每个单页模板的 <head> 区域调用。
表格
字段标签 说明 示例用法
{single:keywords} 关键词：后台设置的 SEO 关键词。 <meta name=”keywords” content=”{single:keywords}”>
{single:description} 描述：后台设置的 SEO 描述信息。 <meta name=”description” content=”{single:description}”>
3. 扩展字段（自定义字段）
这是 PbootCMS 强大的地方。你可以在后台“内容管理 -> 单页内容 -> 扩展字段”中自定义任意字段（如电话、地址、Banner图）。
调用规则：{single:ext_字段英文名}
表格
假设后台字段名 前端调用标签 常见应用场景
tel (电话) {single:ext_tel} 联系页面显示联系电话
email (邮箱) {single:ext_email} 联系页面显示电子邮箱
address (地址) {single:ext_address} 地图下方显示详细地址
banner (横幅图) {single:ext_banner} 页面顶部的背景大图
ico (图标) {single:ext_ico} 列表页或侧边栏的小图标
⚠️注意：ext_ 后面的名称必须与后台设置的英文字段名完全一致，区分大小写。如果后台没填值，前端将输出为空。
4. 链接与路径字段
用于生成跳转链接或资源路径。
字段标签 说明 示例用法
{single:link} 页面链接：该单页的静态或动态 URL 地址。 <a href=”{single:link}”>查看更多</a>
{single:ico} 缩略图路径：后台上传的缩略图完整路径。 <img src=”{single:ico}” alt=”{single:title}”>
5. 高级/条件判断字段
用于更复杂的逻辑展示。
字段标签 说明 示例用法
{single:id} 内容ID：单页在数据库中的唯一 ID。 用于 JS 交互或特定样式判断
{single:scode} 栏目编码：即后台设置的 scode。 用于判断当前处于哪个单页
📝 实战代码示例
场景 A：标准的“关于我们”单页模板 (about.html)
html
{pboot:include(‘header.html’)}
<!– 头部 Banner –>
<div class=”page-header” style=”background-image: url(‘{single:ext_banner}’);”>
<h1>{single:title}</h1>
<p>{single:subname}</p>
</div>
<!– 主要内容区 –>
<main class=”container”>
<article class=”content-body”>
<!– 富文本正文 –>
{single:content}
</article>
<!– 联系信息模块（使用扩展字段） –>
<aside class=”contact-info”>
<h3>联系我们</h3>
<ul>
<li>📞 电话：<a href=”tel:{single:ext_tel}”>{single:ext_tel}</a></li>
<li>📧 邮箱：<a href=”mailto:{single:ext_email}”>{single:ext_email}</a></li>
<li>📍 地址：{single:ext_address}</li>
</ul>
</aside>
</main>
{pboot:include(‘footer.html’)}
场景 B：在首页调用“公司简介”单页摘要
如果你想在首页显示公司简介的一部分，可以使用 scode 调用：
html
{pboot:single scode=’about’ cache=3600}
<div class=”home-about”>
<h2>{single:title}</h2>
<!– 截取前200个字符，去除HTML标签 –>
<p>{single:content drophtml=1 lencn=200}…</p>
<a href=”{single:link}” class=”btn-more”>阅读全文</a>
</div>
{/pboot:single}
🛠️ 常见问题排查
字段不显示：检查后台是否已为该单页填写了对应的扩展字段值。
标签原样输出：确保模板文件后缀是 .html，且编码为 UTF-8 无 BOM。
图片路径错误：扩展字段如果是图片，确保后台上传成功，且前端使用 <img src=”{single:ext_xxx}”> 正确引用。
缓存问题：修改模板或后台内容后，记得在后台“系统设置”中清理缓存，或在标签中加入 cache=0 进行调试。
NOTICE:【咨询风格酷】客服微信：wwwxmamcn
NOTICE:【风格酷模板网②群】QQ群：288678775
☉免责声明：本站所有模板均来自用户分享和网络收集，仅供学习与参考，请勿用于商业用途，如果损害了您的权利，请联系网站客服，我们核实后会立即删除。
☉如果源码网盘地址失效！或有其他问题，请点我报错,谢谢合作！
☉人民币与积分汇率为1比10,即1元=10积分.有任何疑问请联系客服！
☉如有其他问题，请加网站客服QQ(1131734965)进行交流。
☉本站提供的源码、模板、软件工具等其他资源，都不包含技术服务，请大家谅解！
☉源码、模板等资源会随着技术、环境的升级而存在部分问题，还请慎重选择。
