pbootcms单页模型建站技巧

一、调用技巧（最容易写错的地方）

‌1）三套标签别混用，看场景选‌
场景 用哪个 字段前缀
单页自己的模板（如 about.html） {pboot:single scode=’about’} {single:xxx}
首页/侧栏调用指定单页 同上，或 {pboot:content id=1} [content:xxx]
列表循环里动态关联单页 {pboot:single scode='[list:ext_relation]’} {single:xxx}

‌关键点‌：循环体内取列表字段必须用‌方括号‌ [list:xxx]，写在 {pboot:list} 里面还写成 {list:xxx} 会直接失效——这是最高频的错误。

‌2）一个模板喂多个单页，别写死 scode‌

pbootcms模板里写 scode={sort:scode}，同一个 about.html 就能被多个单页共用，不用为每个单页复制一份文件：

{pboot:single scode={sort:scode}}
{single:title}</h1>
{single:content}
{/pboot:single}

‌3）在首页做「简介摘要」，用截取参数‌

后台正文往往是长篇富文本，直接输出会把首页撑爆。用这一套截取参数：

{pboot:content id=1}
[content:content drophtml=1 dropblank=1 len=300 more=’…’]
<a href=”[content:link]”>查看更多</a>
{/pboot:content}

drophtml=1 去掉 HTML 标签，避免首页样式被正文的 class 污染
dropblank=1 去掉空白
len=300 截取 300 个字符
more=’…’ 补省略号

‌4）多语言站加 lng 参数‌

{pboot:single scode=’service’ lng=’en’}

同一页里中英文内容各自调用，不用建两套模板。
二、性能技巧（单页本身很轻，别被写重了）

‌5）固定内容一律上缓存‌

{pboot:single scode=’about’ cache=3600} 表示缓存 1 小时。单页内容常年不变，加缓存几乎零成本，却能省掉大量查询。

‌6）别在列表循环里堆 single 标签‌

{pboot:list} 循环 10 条、每条都套一个 {pboot:single}，等于查 11 次库，列表超过 20 条会明显变慢。‌更好的做法‌是在内容模型里直接加一个 ext_summary 字段存好要展示的文字，而不是靠标签去关联取。

‌7）分页冲突的唯一判定规则‌

只有一个列表能带分页：{pboot:list}（不带 scode）自带分页且一页只能用一次；带 scode= 的默认不分页。同页两个带分页的列表，老版本报错、新版本会显示重复内容。
三、扩展与定制技巧

‌8）用 sort:type 判断栏目类型，一套模板通吃‌

后台栏目类型值是：‌1=单页，2=列表‌。在导航或面包屑里可以直接判断，不用一个栏目写一个模板：

{pboot:if([sort:type]==1)}
<a href=”[sort:link]” class=”single”>[sort:name]</a>
{pboot:else}
<a href=”[sort:link]” class=”list”>[sort:name]</a>
{/pboot:if}

‌9）多选字段必须遍历，不能直出‌

后台配置的”复选”字段存的是逗号串，直接 {single:ext_features} 会挤成一行：

{pboot:checkbox id={single:id} field=ext_features}
<span class=”badge”>[checkbox:text]</span>
{/pboot:checkbox}

[checkbox:n] 从 0 开始、[checkbox:i] 从 1 开始，做不同颜色的角标很好用。

‌10）单页里嵌「相关推荐」，比纯静态页更耐看‌

单页模板底部挂几条最新内容，注意‌必须写 scode‌、‌不要加 page=1‌，否则会破坏单页的 URL 结构：

{pboot:list scode=news num=4 order=’date desc,id desc’}
<a href=”[list:link]”>[list:title]</a>
{/pboot:list}

order=’date desc,id desc’ 这种自定义排序组合是 V1.2.2 之后支持的，比单写 order=date 更可控。
四、URL 与 SEO技巧

‌11）用自定义路由把 /index.php?p=… 美化成 /about-us.html‌

后台可配「单页面路由」，把 scode 映射成漂亮地址。‌踩坑提醒：about 是系统保留关键字，自定义地址里别用它‌，换成 about-us、company 之类。

‌12）每个单页的 TDK 独立设置‌

这是单页模型相比列表页的天然优势——一个单页一个独立 URL，可以精准打长尾词。在 “ 里逐页调用：

{single:title} – {pboot:sitetitle}</title>
<meta name=”keywords” content=”{single:keywords}”>
<meta name=”description” content=”{single:description}”>

‌13）路径全部动态化‌

{pboot:include(‘header.html’)} 引公共头尾，静态资源用 {pboot:sitetplpath}/static/…。写死相对路径的话，换模板目录、装到子目录、开伪静态后基本必 404。
五、避坑与调试技巧

‌14）字段名避开系统保留字段‌

自定义字段标识别和 title、content、ico、tags 这些重名，统一加业务前缀（ext_）最稳。字段标识后台填 tel，前台写 ext_tel，‌大小写必须一字不差‌。

‌15）改完没变化，先清缓存再怀疑代码‌

后台「清除缓存」只是第一步，彻底一点直接删目录，调试时更省事：

bash
rm -rf runtime/cache/* runtime/temp/*

模板文件本身要求 ‌UTF-8 无 BOM‌，后缀必须是 .html——标签被原样输成文本，90% 是这两个原因之一。

‌16）上传字段要设格式白名单‌

图片/文件字段别放 php、exe 这类可执行后缀；默认 2MB 上限，要传大文件得同时调后台设置和服务器 upload_max_filesize、post_max_size。

‌17）{pboot:sql} 别用‌

该标签因安全原因在较新版本已不再支持，老版本用也容易开出注入口子。需要跨表取数时，改成标准标签组合或用自定义控制器。

‌18）整站单页集体不显示（罕见但真实）‌

检查后台「内链替换次数」里是否误填了域名，删掉即可恢复——这个坑排查起来非常费时间，值得记住。

‌一句话总结‌：单页模型省事的核心是 scode={sort:scode} 复用模板 + cache 缓存 + sort:type 条件判断；提速的关键是别在循环里堆 single；保命的三条是字段名带 ext_ 前缀、样式和路径全部动态化、改动后必清缓存。