公共字段是全站通用的自定义字段：不挂在某个内容类型下，全站只有一份值，适合维护客服电话、微信二维码、公司地址、公告开关这类「站点级」信息。入口在后台**「设置 → 站点设置」**页的「公共字段」区块，字段由管理员自助添加，无需改代码、无需改模板文件。
添加字段
- 进入「设置 → 站点设置」，找到「公共字段」区块；
- 点击区块右上角**「添加公共字段」**按钮；
- 在弹窗中填写：
| 弹窗项 | 说明 |
|---|---|
| 字段名称 | 后台显示名，如「客服电话」 |
| 字段标识 | 模板调用用的 key，如 kefu_phone，保存后用于 [site:标识] 取值 |
| 字段类型 | 决定录入控件与模板输出格式，见下表 |
| 选项 | 仅下拉选择 / 多选类型出现，维护「键 => 显示值」 |
| 显示顺序 | 数字越小越靠前，控制区块内字段排列 |
- 确认后区块内立即出现该字段的录入项，填好内容、点击页面底部**「保存设置」**即生效。
字段类型与模板输出
| 类型 | 录入控件 | 模板输出 |
|---|---|---|
| 单行文本 | 文本框 | 原文 |
| 多行文本 | 文本域 | 原文 |
| 图片 | 媒体库选择 / 直接上传 | 图片 URL |
| 文件 | 媒体库选择 / 直接上传 | 文件 URL |
| 下拉选择 | 下拉框 | 选中项标识 |
| 多选 | 多选框 | 各选中项以「、」连接 |
| 开关 | 切换钮 | 是 / 否 |
| 日期 | 日历选择（带「填入当前日期」） | 日期，支持 format= 格式化 |
| 数字 | 数字输入框 | 数值 |
富文本、JSON、问答（FAQ）属于内容详情场景，仅内容类型的自定义字段可用，不开放为公共字段。
编辑与删除
- 每个字段录入项右上角有**「编辑」**：可改名称、类型、排序；修改标识时已填内容会自动迁移到新标识，但主题模板里引用的旧标识需要同步调整，否则取不到值；
- 「删除」：二次确认后删除，模板中
[site:标识]将输出空串（不会报错），该字段已填内容一并清除。
字段标识规则
- 小写字母开头，仅小写字母、数字、下划线（如
kefu_phone、erweima）； - 全局唯一，
definitions为系统保留标识不可使用； - 建议语义化命名，模板里可读性更好。
模板调用
模板中以 [site:标识] 调用，任意页面任意位置可用，不依赖任何块标签：
<span>客服电话：[site:kefu_phone]</span>
<img src="[site:erweima]" alt="微信二维码">- 输出默认 HTML 转义，
[site:标识 raw=1]原样输出； - 日期类型支持
[site:标识 format=Y-m-d]； - 字段未定义或未填值时输出空串。
完整语法与更多示例见模板标签参考。
静态化站点提醒
公共字段的值输出在模板里，静态化模式下改完字段值需重新生成静态页面才会更新前台（与修改站点名称的行为一致）。保存设置时若站点已有公共字段，系统会弹出此提醒；生成入口在「设置 → 静态化设置」。