pbootcms单页模板教程

pbootcms单页模板基础文件准备

PbootCMS的单页模板默认命名为‌page.html‌，存放在/template/你的模板目录/下，专门用于渲染“关于我们”“联系方式”这类固定单页内容 。

先在模板目录中创建page.html文件，编码必须设为‌UTF-8 无BOM‌。
公共头部、底部直接用{pboot:include(‘header.html’)}和{pboot:include(‘footer.html’)}引入，避免重复写代码。
所有CSS、JS、图片资源路径统一用{pboot:templatepath}/static/引用，防止路径出错 。

单页核心标签调用方法

单页内容通过{pboot:single}标签实现，用scode参数指定后台设置的单页标识码，即可完整调取对应页面的所有字段 。

html
{pboot:single scode=’about’}
<h1>{single:title}</h1>
<div class=”content”>{single:content}</div>
{/pboot:single}

基础字段：{single:title}输出单页标题，{single:content}输出富文本正文。
SEO字段：可直接调用{single:keywords}、{single:description}设置页面TDK。
扩展字段：后台自定义的扩展属性，用{single:ext_字段名}调用，比如电话、邮箱、专属Banner图 。
性能优化：添加cache=3600参数，可将单页内容缓存1小时，大幅降低数据库查询压力。

完整单页模板实战示例

这是一套可直接复用的标准单页模板代码，适配企业官网的“关于我们”场景：

html
{pboot:include(‘header.html’)}
<main class=”single-page”>
<!– 页面Banner –>
<div class=”page-banner”>
{pboot:single scode=’about’}
<img src=”{single:ext_banner}” alt=”{single:title}”>
<h1>{single:title}</h1>
{/pboot:single}
</div>
<!– 正文内容区 –>
<div class=”container”>
{pboot:single scode=’about’}
<div class=”page-content”>
{single:content}
</div>
<!– 扩展信息 –>
<div class=”contact-info”>
<p>联系电话：{single:ext_tel}</p>
<p>公司地址：{single:ext_address}</p>
</div>
<!– 最后更新时间 –>
<p class=”update-time”>最后更新：{single:update_time}</p>
{/pboot:single}
</div>
</main>
{pboot:include(‘footer.html’)}

后台配置与模板启用

登录PbootCMS后台，进入‌内容管理 → 单页内容‌，新增单页并设置唯一的小写标识码（如about、contact），这个标识码要和模板中scode参数完全对应 。
若要给某个单页使用完全独立的自定义模板，直接在模板目录新建about.html，上传后在后台对应单页的“高级设置”中，指定该文件作为专属模板即可。
模板上传后，进入‌系统设置 → 模板风格‌，确认当前启用的是你修改后的模板，最后清理静态缓存即可生效。

常见问题排查

单页内容不显示：先检查后台单页的标识码拼写，和模板中scode参数是否完全一致。
标签被直接输出成文本：确认模板文件后缀是.html，不是.txt或其他格式。
扩展字段为空：检查后台单页的扩展字段名称，和模板中ext_后的字段名完全匹配，不能有大小写差异 。