站点自定义设置
校对日期:2026-11-16。适用于社区版及全部商业版。
服务热线、公司地址、二维码这类全站只有一份、又会在多个页面出现的内容,可以做成站点的自定义设置: 先在模型里定义有哪些项,再在站点设置里填写,模板从站点上读取。以后要改,只改站点设置,不用动模板。
主题可以自带“主题设置”:默认主题页脚的版权单位、ICP 备案号、公安备案号就是主题设置里的项,不需要另外定义。 先看主题自己的设置项够不够用(见模板编写的“主题设置”一节); 自定义设置适合主题没有提供、需要自己在模板里加的内容。
一、定义有哪些设置项
进入 配置 → 模型管理,切到 站点设置模型 页签,在本站使用的模型上点 自定义字段。

在设计器里从左侧点击或拖入字段类型(如 单行文本),在右侧填写 字段代码 和 字段名称,点 保存。 字段代码是模板里读取时用的名字,只能用字母和数字;字段名称是填写时看到的标签。

字段类型、属性和修改字段代码的注意事项与其它模型相同,见模型管理的“自定义字段”一节。
二、填写
进入 配置 → 站点设置 → 自定义设置,页面上就是上一步定义的字段,填好后点 保存。
模型里还没有自定义字段时,这个页签只有一句提示和一个通往 模型管理 的按钮:

三、在模板里读取
模板里通过 site.customs 读取,方括号里是字段代码:
html
[#if (site.customs['hotline'])?has_content]
<p>服务热线:${site.customs['hotline']}</p>
[/#if]- 没有填写的项是空值,输出前用
?has_content判断,或写成${site.。customs['hotline']!} - 单选、下拉这类绑定字典的字段,
site.是选中项的名称,customs['代码'] site.是键值;多选字段两者都是列表。customs['代码Key'] - 富文本字段的值是 HTML,要放在
[#noescape]…[/里输出。#noescape] - 图片、文件上传字段的值是文件地址。
四、规则
- 站点用哪个模型:在 配置 → 站点设置 → 基础设置 的 自定义设置模型 里选择。新安装的系统自带一个全局共享的“站点设置模型”。
- 全局共享的模型改字段会影响所有使用它的站点,并且需要“全局数据权限”。只想给本站加字段时,在模型管理里 复制 出一个 本站私有的模型,加好字段,再到基础设置里改选它。
- 开启了静态化的站点,修改自定义设置后,已经生成的静态页不会自动更新,需要到 系统 → 生成管理 重新生成。
- 所有站点共用的内容 可以放在全局设置里:字段在 配置 → 模型管理 → 全局设置模型 中定义,在 配置 → 全局设置 → 自定义设置 里填写,模板通过
config.读取。customs['字段代码']
五、常见问题
模板里输出是空的。 检查方括号里的字段代码与模型里的是否一致(区分大小写),以及站点设置里是否已填写并保存。 修改过字段代码的,原来填的值不再显示,需要重新填写,或把代码改回去。
“自定义设置”页签里没有刚加的字段。 字段加在了别的站点设置模型上,核对基础设置里的 自定义设置模型。