pbootcms单页技巧

上次分享的是「pbootcms单页模型技巧」，这次换成‌单页模板落地时真正用得上的技巧‌——重点放在模板复用、多语言、表单嵌入、SEO 这几块上面，这些恰恰是新手做单页时最容易漏的。
一、模板组织：一个文件管一批单页

‌1）用 scode={sort:scode} 让一份模板服务多个单页‌

别为每个单页复制一份模板。模板里写动态栏目编码，后台新建单页时只要指定同一个模板文件即可：

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

sort:scode 会自动取”当前访问的单页编码”，比写死 scode=’about’ 灵活得多。

‌2）长单页按区块拆成多个单页栏目‌

一个”关于我们”页面如果包含公司简介、发展历程、团队介绍、荣誉资质四大块，运营往往希望‌每块单独改‌。做法是建 4 个单页栏目，在同一个模板里依次调用：

html
{pboot:single scode=’about_intro’} {single:content}</section> {/pboot:single}
{pboot:single scode=’about_history’}{single:content}</section> {/pboot:single}
{pboot:single scode=’about_team’} {single:content}</section> {/pboot:single}

好处是每块有自己的扩展字段（比如”发展历程”块需要配图，”团队”块需要成员名单），互不干扰。

‌3）批量给单页配独立模板‌

若某些单页样式完全不同（如品牌故事页、活动专题页），在模板目录新建 about-story.html、activity.html，然后在后台该单页栏目的「‌内容页模板‌」里逐个指定文件名即可，不影响其他单页。
二、标签调用：三个高频写法

‌4）首页做”简介摘要”，必须去掉 HTML‌

单页正文是富文本，直接输出会把首页布局冲乱：

html
{pboot:content id=1}
[content:content drophtml=1 dropblank=1 len=200 more=’…’]</p>
<a href=”[content:link]”>了解更多</a>
{/pboot:content}

drophtml=1 去标签、len=200 截字数、more=’…’ 补省略号，三个参数配合用。

‌5）循环体内取字段一律用方括号‌

这条几乎人人踩过：在 {pboot:list} 或者关联调用里，取列表字段必须写 [list:xxx]，写成 {list:xxx} 会原样输出成文本。

html
{pboot:list scode=case num=6}
{pboot:single scode='[list:ext_relation]’}
关联页：<a href=”{single:link}”>{single:title}</a></p>
{/pboot:single}
{/pboot:list}

‌6）多选扩展字段要遍历，不能直出‌

后台建了”复选”类型的字段，存的是逗号串，直接 {single:ext_tags} 会挤成一行且带逗号：

html
{pboot:checkbox id={single:id} field=ext_tags}
<span class=”tag”>[checkbox:text]</span>
{/pboot:checkbox}

三、多语言：单页跨语种调用

‌7）加 lng 参数即可调用指定语言版本‌

同一页里中英文内容各自调用，不用建两套模板：

html
{pboot:single scode=’service’ lng=’en’}
{single:title}</h1>{single:content}
{/pboot:single}

‌8）语言切换按钮别手拼链接‌

不同版本写法不同，PB2.0 起 lg 前面用 &：{pboot:lgpath}&lg=en；老版本用 ?。判断当前语言高亮用：

html
<a href=”{pboot:lgpath}&lg=en” {pboot:if(‘{pboot:sitelanguage}’==’en’)}class=”active”{/pboot:if}>English</a>

手写成 /en/ 这种硬编码，一旦后台语言模式切换就全部失效。
四、SEO：单页的天然优势要用足

‌9）每页独立 TDK，单页最适合打长尾词‌

这是单页模型相对列表页的最大优势：一个单页一个独立 URL，可以精准打一个词。“ 里逐页调用：

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

后台每个单页的”SEO 设置”里把这几个字段填上，别留空——留空会降级成全站统一标题，全部页面标题雷同。

‌10）自定义地址填语义化英文，避开保留字‌

给单页栏目填”自定义地址”：about-us、contact-us、service。‌注意 about 是系统保留关键字，别单独用‌，否则和内部路由撞车。所有链接统一走 {single:link}、[sort:link] 输出，后台设的美化地址才会生效。

‌11）把单页加进 sitemap‌

固定单页也应被收录，检查后台 sitemap 生成规则里是否包含单页栏目，或手动在 sitemap 中列出。
五、性能：单页本身就轻，别写重

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

{pboot:single scode=’about’ cache=3600} 缓存 1 小时。单页基本不变，缓存几乎零成本。

‌13）循环里少套 single 标签‌

{pboot:list} 循环 10 条、每条再套一个 single，等于查 11 次库。更好的做法是在内容模型里直接加一个 ext_summary 字段把要展示的文字存进去，靠字段取，而不是靠标签关联。

‌14）列表只需标题和缩略图时加 lfield‌

{pboot:list scode=news num=6 lfield=”title,ico”}，别用 lfield=*，数据量大时性能差一倍以上。
六、进阶：单页里嵌表单（联系页必备）

‌15）后台建表单 + 前台写 HTML，两步搞定‌

进 ‌后台 → 扩展内容 → 自定义表单‌，新建表单填英文标识（如 yuyue）并加字段；前台模板里表单的 action 用系统标签，字段名必须和后台完全一致：

html
<form action=”{pboot:form fcode=’yuyue’}” method=”post”>
<input type=”text” name=”name” placeholder=”您的姓名” required>
<input type=”tel” name=”tel” placeholder=”联系电话” required>
<textarea name=”content” placeholder=”需求描述”></textarea>
<button type=”submit”>提交</button>
</form>

两个关键点：‌提交方式必须是 post‌；‌多选字段的 name 要加中括号‌（name=”like[]”）。后台的字段”类型”只决定后台显示，前台控件类型完全由你写，这是 PbootCMS 表单灵活的地方。
七、避坑清单（照这张表排查基本够用）
表格
现象 原因
单页内容空白 栏目编码拼写不符；或该单页后台没填内容
标签被当文本输出 文件后缀不是 .html，或编码带 BOM（改 UTF-8 无 BOM）
扩展字段为空 后台没填值；或字段标识大小写不一致
循环里的单页不显示 用了 {list:xxx} 而非 [list:xxx]
模板改了没反应 后台清缓存不够，直接删 runtime/cache/*、runtime/temp/*
美化地址不生效 模板里手写了 ?scode=xxx，没走系统链接标签
多选字段挤成一行 没用 {pboot:checkbox} 遍历
表单提交失败 字段名和后台不一致；或表单方法不是 post
语言切换没反应 切换链接手拼；或 lg 前符号用错（2.0 起是 &）
整站单页集体不显示（罕见） 后台「内链替换次数」里误填了域名，删掉即恢复

‌一句话总结‌：单页技巧的核心就三组——‌模板层面‌用 scode={sort:scode} 一份模板管一批、长页面拆成多个单页栏目分块维护；‌调用层面‌循环里用方括号、摘要记得 drophtml、多选记得遍历、多语言加 lng；‌上线层面‌每页独立 TDK 走美化地址、固定内容上缓存、改完必清缓存。