很多刚接触 PbootCMS 的人都会有同一个疑问:为什么它的模板里看不到 PHP 代码,只有一堆大括号?这正是 PbootCMS 的设计初衷——把“调数据”这件事从 PHP 里剥离出来,交给一套统一的标签语法。模板文件只负责页面结构,标签负责把数据库里的栏目、文章、留言、标签渲染进去。把这套规则吃透,改模板、做二次开发、给客户交付站点都会快一大截。下面从语法规则讲到实战写法,示例均可直接粘贴使用。
PbootCMS 渲染页面时,先读取 template 目录下的模板文件,再由解析器把 {pboot:...}、[list:...]、{content:...} 这类标记逐层替换成真实数据,最后输出纯 HTML 交给浏览器。整个过程对你完全透明,所以模板里既没有循环语句,也没有数据库查询。
理解机制时记住三点就够了。第一,标签全部小写,大小写混写不会被识别。第二,成对标签必须有闭合标签,缺一个 {/pboot:list} 就会导致整段内容不解析。第三,查询不到数据时,整块标签会被直接替换为空,页面不会报错——这也是为什么栏目为空时前台“什么都没有”,而不是弹出异常。
单标签不需要闭合,用完即走,最典型的是页面 SEO 三件套和站点路径:
{pboot:pagetitle}

这里要注意 {pboot:pagetitle} 和站点名称的区别:前者是“当前页面标题”,会自动拼接栏目名、文章标题,适合直接放进 title 标签;{pboot:sitetplpath} 指向模板目录,{pboot:sitepath} 指向站点根路径,做静态资源引用时用前者更稳,换域名也不会失效。
另外两个网址类单标签也很实用:{pboot:httpurl} 输出当前访问域名(带协议),{pboot:pageurl} 输出当前页面完整地址,做分享链接、canonical 或分享回调时直接取用,比用 PHP 拼接省事,也不必担心测试域名和正式域名不一致。
成对标签是 PbootCMS 的主力,写法上有个容易踩坑的细节:外层用大括号 {},内层字段用方括号 []。外层的 {pboot:list} 决定“取哪些数据”,内层的 [list:title] 决定“输出哪些字段”。
{pboot:list num=10 order=date}
[list:title lencn=30]
[list:date style=Y-m-d]
{/pboot:list}
条件标签的骨架是 {pboot@if(条件)}……{else}……{/pboot@if},支持等于、不等于以及 &&、|| 组合。嵌套时不能继续写 if,要改用带序号的写法:
{pboot@if([list:istop]==1)}
置顶
{else}
{pboot:2if([list:isrecommend]==1)}
推荐
{2else}
普通
{/pboot:2if}
{/pboot@if}
公式很简单:第 N 层嵌套用 {pboot:Nif},分支用 {Nelse},闭合用 {/pboot:Nif}。超过两层就建议拆成多个独立判断,可读性会好很多。
{page:bar} 一次性输出完整分页条,适合“不想折腾样式”的场景;要自己控制样式,就拆成 {page:index}、{page:pre}、{page:numbar}、{page:next}、{page:last} 分别摆放,再配合 {page:current}、{page:count}、{page:rows} 显示“第几页/共几条”。判断有无数据时用 {pboot@if({page:rows}>0)},无数据就显示一句“暂无内容”,体验比空白页好得多。
参数写在标签名之后,空格分隔,格式是 key=value,通常不加引号;一个参数要传多个值时用英文逗号连接。比如 {pboot:list num=10 order=date scode=2},三个参数各管一件事。
字段调节符写在字段名之后,用来处理“显示成什么样”,最常用的三个:lencn 按中文长度截断,[list:title lencn=30] 就是超过 30 个中文字符自动省略;len 按纯字符长度截断,适合英文标题;style 控制日期格式,[list:date style=Y-m-d] 输出 2026-11-16,换成 Y年m月d日 就是中文日期。还有一个很实用的 operate,能给数值加基数,[content:visits operate=+1000] 会让访问量显示得更“热闹”,演示站点常用。
导航是最容易被低估的标签,它的参数只有三个却很够用:num 控制条数,parent 指定从哪个栏目下取子级(0 表示顶级),scode 只取指定栏目。内部字段有 [nav:name]、[nav:link]、[nav:scode]、[nav:rows](栏目下文章数)、[nav:soncount](子栏目数)、[nav:i](序号)、[nav:ico]、[nav:pic]。
{pboot:nav num=10 parent=0}
[nav:name]
{/pboot:nav}
这里的技巧是:用 [nav:scode] 和当前页面的 {sort:tcode} 比对,命中就给 li 加 active,一套代码同时解决“一级栏目高亮”和“子页面归属高亮”。要做二级菜单,把 {pboot:nav} 再嵌进循环体里、parent 换成 [nav:scode] 即可,PbootCMS 支持无限极嵌套。
绝大多数页面都靠它。常用参数:num 条数;order 排序,可选 date、id、sorting、visits、random 以及 istop、isrecommend、isheadline;scode 指定栏目(写 * 或不写表示全站);istop=1 只取置顶;isrecommend=1 只取推荐;ispics=1 只取含多图的;tags 按 TAG 过滤;filter 按字段过滤;start 从第几条开始;page=0 关闭分页。
{pboot:list num=6 order=random scode=4 isrecommend=1}
{/pboot:list}
几个实战要点。第一,同一个页面只能有一个带分页的列表,第二个列表必须写 page=0,否则会直接报错提示“请不要在一个页面使用多个具有分页的列表”。第二,[list:ico] 在没有缩略图时会自动回退到正文首图,再没有就退回系统默认图,所以不用额外写判断。第三,filter 的写法是“字段|值”,多个值用逗号,例如 filter='title|建站,模板',配合 fuzzy=0 可以变成精确匹配。
还有两个参数值得单独记住:lfield 用来限定只查哪几个字段,列表不需要正文时写上 lfield='title,date,ico,link',查询量会小很多,数据量上来了差别很明显;start 控制从第几条开始,做“排除当前这篇”的相关推荐时特别好用——start 设为 2 就等于跳过第一条,不用在模板里写额外的判断逻辑。
内容页用的是单标签形式的 {content:xxx},常见字段有 title、content、date、author、source、visits、tags、ico、pics、enclosure,以及上一篇下一篇 {content:precontent}、{content:nextcontent}。如果想在某张页面固定调出另一篇文章,用成对写法按 id 或栏目调用:
{pboot:content id=15}
[content:title]
[content:content]
{/pboot:content}
把 id 换成 scode,就变成“调用某个单页栏目的内容”,公司简介、联系我们这类页面通常就是这么复用的——改后台内容,多个页面同时更新,不用改模板。
顺带提了一个常见问题:{content:content} 输出的是富文本原文,如果要在列表页显示摘要,别直接对它用 lencn 截断,正文里的标签和图片会被截成半截;优先用 description 字段,或在后台单独填好摘要,展示效果和 SEO 都更稳。
这里的“标签”指后台给文章打的 TAG,和模板语法是两回事,别混淆。{pboot:tags} 有三种取数方式:按 id 取某篇文章的 TAG、按 scode 取某栏目下的全部 TAG、两者都不写则取全站。target 决定点击后跳到内容列表还是独立标签页。
{pboot:tags scode=16 num=20 target=list}
[tags:name]
{/pboot:tags}
再配合列表的 tags 参数,就能做出典型的“相关文章”模块:文章页把当前 TAG 传进列表,页面下方自动聚合同类内容,既提升停留时长,也帮搜索引擎建立内容关联。这也是很多站长觉得“标签没什么用”的原因——不是功能弱,是没接上这个闭环。
栏目页和列表页常用 {sort:name}、{sort:scode}、{sort:tcode}(顶级栏目编码)、{sort:link}、{sort:rows}(文章数)、{sort:description}。做栏目 Banner 时,用 {pboot:sortpics scode={sort:scode}} 就能自动读取该栏目后台上传的图片组,比手工换图省事。
还有一批单标签用来读取后台“全局配置”里的内容,比如 {pboot:companyname}、{pboot:companytel}、{pboot:companyemail}、{pboot:companyaddress}、{pboot:sitecopyright}。把它们写进页脚,客户在后台改一次电话,全站同步更新,这是交付时最容易被夸的细节。
技巧一:用条件标签做“空状态”。列表标签查不到数据时会被整体清空,页面结构就塌了。解决办法是先判断,再渲染:把提示语写在 {pboot@if} 的 else 分支里,页面永远有内容可看。
技巧二:用变量思路复用代码块。{include file=comm/head.html} 这类包含标签相当于模板级的公共组件,头部、页脚、面包屑抽成独立文件,改一处全站生效,比在每个模板里重复粘贴靠谱得多。
技巧三:先查真实编码再写死参数。scode 是栏目编码,不同站点、不同栏目都不一样,凭记忆写死是最常见的错误来源。发布或调试前,先在后台栏目列表或接口里确认编码,再往模板里填。
标签原样输出、没有被解析。九成是闭合标签漏了,或大小写写错;也可能是把内层的方括号写成了大括号。
改了模板前台没变化。PbootCMS 有模板缓存,改完要去后台清一次缓存,否则看到的还是旧页面。
字段输出为空。先去后台确认该字段真的录了值,再看字段名拼写;日期格式不对通常是 style 参数写错,不是数据问题。
中文变成乱码或问号。多半是模板文件编码不对,保存成 UTF-8 无 BOM 再上传;页面头部、数据库和文件编码三者一致,基本就不会再出问题。
分页点不动或跳错。检查列表是否在带分页的页面使用、是否误加了 page=0,以及伪静态规则是否配置正确。
页面报“权限不足”或标签被吞掉。先看是否有语法错误导致解析中断,再排查模板里是否残留了不完整的条件语句。
PbootCMS 的标签体系其实只有四条主线:单标签取值、成对标签循环、条件标签判断、分页标签翻页。参数负责“取什么”,字段调节符负责“怎么显示”,两者分开理解,学起来会清晰很多。建议的顺序是先用导航和列表把首页跑通,再套内容页和分页,最后用条件标签和 TAG 聚合做细节。模板写得越干净,后期交付和二次开发越省心。