如何自定义pbootcms单页字段

PbootCMS自定义字段是‌挂在”内容模型”上‌的，不是挂在单个页面上——这一点决定了怎么加、加了谁能用。下面是完整流程。
一、先理解：字段加在哪里、谁能用

PbootCMS扩展字段属于‌模型级‌配置，而不是”某一个单页专属”。

单页在后台用的是 ‌”专题”模型‌（也有的版本称为单页模型），你把字段加到这个模型上，‌所有专题单页就都能填这个字段‌。
想让不同单页有完全不同的字段，只能‌新建一个模型‌（如”招聘单页模型”），再给这个模型单独配置字段，然后把栏目挂到新模型上。
字段的存放逻辑是：后台配置出来的字段名会自动带 ext_ 前缀，前台调用时按 ext_字段标识 来写。

二、后台添加字段的步骤

‌入口：后台 → 全局配置 → 内容模型管理 → 选中”专题”（或你的模型）→ 点击【编辑】→ 找到”自定义字段”区域 → 新增字段‌

每个字段要填这几项：
配置项 说明 示例
‌字段名称‌ 后台编辑页显示的中文名，只给人看 联系电话
‌字段标识‌ 真正用于调用的英文名，‌全小写、无空格、无特殊字符‌ tel
‌字段类型‌ 决定后台以什么控件呈现，见下表 单行文本
‌是否必填‌ 必填则编辑内容时不填不让保存 否
‌字段提示‌ 编辑时的灰色提示文字 请填写公司总机号码
‌默认值‌ 新建内容时的预设值 400-000-0000
‌可选值‌ 单选/复选/下拉类型专用，一行一个值 男\n女
‌排序‌ 数字越小越靠前，建议排在核心字段之后 8

‌填完点【保存】，然后必须回到模型编辑页再保存一次模型，字段才真正生效。‌
三、字段类型怎么选
字段类型 后台呈现 适用场景 前台调用注意
单行文本 单行输入框 电话、邮箱、作者、链接 直接输出
多行文本 多行输入框 简短介绍、备注 直接输出
‌编辑器/富文本‌ 富文本编辑器 需要排版的内容块 输出 HTML，需 format=html 之类参数
数字 数字框 价格、人数、面积 直接输出
单选 单选按钮 性别、状态 直接输出选中项文字
‌复选（多选）‌ 复选框 产品特色、标签 需配合 {pboot:checkbox} 遍历
下拉框 下拉选择 省份、分类 直接输出
日期 日期选择器 成立日期、活动时间 可直接格式化
‌图片‌ 单图上传 Banner、Logo、缩略图 输出图片 URL
‌多图‌ 多图上传 产品图集、案例多图 需循环遍历
‌文件上传‌ 文件上传框 说明书、PDF、压缩包 需配上传格式与大小限制

多图、文件上传这类要留意两点：‌允许上传格式‌别写 php、exe 等可执行后缀；‌大小限制‌默认 2MB，要传大文件时除了改这里，还得同步调服务器的 upload_max_filesize、post_max_size。

四、字段命名与调用的对应关系

后台字段标识填 tel，前台就写 ext_tel，‌大小写必须完全一致‌：
位置 调用写法
单页模板（single 场景） {single:ext_tel}
内容详情页 {content:ext_tel}
列表页 [list:ext_tel]
首页调用指定单页 在 {pboot:single scode=’about’} 循环体内用 {single:ext_tel}
五、几类字段的前台调用示例

‌1）普通文本/图片字段‌

html
电话：{single:ext_tel}</p>
邮箱：{single:ext_email}</p>
<img src=”{single:ext_banner}” alt=”页面Banner”>

‌2）多选字段必须遍历输出‌

多选字段存的是逗号分隔的一串值，直接输出会连成一行，要用专用标签拆开：

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

其中 [checkbox:i] 是从 1 开始的序号，[checkbox:n] 是从 0 开始，[checkbox:text] 是文本本身。

‌3）列表页调用自定义字段的坑‌

列表页默认只输出部分字段，如果 [list:ext_xxx] 不显示，在列表标签上补 lfield 参数即可：

html
{pboot:list scode=1 num=10 lfield=’title,ext_price,ext_tel’}

lfield=* 表示输出全部字段，但会拖慢速度，建议只写用到的。

‌4）单页内容与前缀写法二选一‌

注意 PbootCMS 中存在两套命名风格：{pboot:single scode=’about’}…{/pboot:single} 用 {single:xxx}；而部分版本/资料中写 {pboot:content id=1} 用 [content:xxx]。‌看你的版本实际解析情况，选一套用到底‌，不要混着写。
六、加完字段必做的三件事

‌保存模型‌（不是只保存字段）。
‌清缓存‌：后台 → 系统设置 → 清理缓存，否则前台看不到新字段。
‌回填数据‌：进入该单页的编辑页，把字段值一项项填上——‌后台没填值，前台就是空的‌，这不是标签写错。

七、常见问题排查

‌前台字段为空‌：先确认后台该内容是否填了值；再核对字段标识大小写；最后确认模型是否已再次保存。
‌标签被原样输出‌：模板文件后缀必须是 .html，编码 ‌UTF-8 无 BOM‌。
‌多选字段挤成一行‌：没用 {pboot:checkbox} 遍历，直接用 {single:ext_xxx} 输出了。
‌列表页字段不显示‌：{pboot:list} 缺 lfield 参数。
‌改完没变化‌：缓存没清。
‌整站单页/详情页集体不显示内容‌（少见但真实）：检查后台”内链替换次数”里是不是误填了域名，删掉即可恢复。
‌字段名冲突‌：字段标识别和系统默认字段（title、content、date 等）重名，统一加业务前缀更安全，如 ext_prod_price。

‌一句话总结‌：字段是在”内容模型（专题模型）→ 编辑 → 自定义字段”里加的，标识决定调用名，加完要保存模型 + 清缓存 + 回填数据，前台按 {single:ext_标识}（单页）或 [list:ext_标识]（列表）调用。