模板内容设置
📅 2026-11-21
👁️ 0
模板内容设置
模板内容设置用于维护当前模板的自定义内容参数,可在不修改模板代码的情况下调整电话、地址等全局内容。
入口路径
后台顶部菜单 →「设计」→「模板内容设置」。实际地址:/system/design/diyfield,需要管理员权限(canAdmin)。
功能说明
页面按模块组(如「未分组」)展示自定义参数,支持添加参数并在前台通过 diy 标签调用。
界面截图

设置项说明
| 设置项 | 作用 | 取值 / 默认 | 怎么选 / 填写建议 | 影响 / 注意 |
|---|---|---|---|---|
| 参数名 | 模板调用使用的名称 | 保存时首字母会自动大写,模板中大小写必须一致 | 填便于识别的名称,与前台展示保持一致 | 名称变更会影响展示与调用,注意同步 |
| 备注 | 后台识别说明 | — | 简明描述,避免空泛 | 是否展示由模板决定 |
| 模块组 | 把参数分组显示 | 后台按组折叠 | 按页面提示与业务需要填写 | 配置以前台实际表现为准 |
| 字段类型 | 决定填写控件 | 支持文本、图片、文件、文本列表等 13 种 | 按页面提示与业务需要填写 | 配置以前台实际表现为准 |
| 默认值 | 参数初始内容 | — | 按字段类型填写初始值 | 留空则无默认值 |
配置项详解
参数名大小写
出现条件:添加参数时 [实测]。
源码确认参数名保存时首字母自动大写 [源码+i18n]。
推荐值:直接填 SitePhone 这样的形式,模板中用 {% diy with name="SitePhone" %} 调用。
填错后果:模板调用时大小写不一致会读不到值。
字段类型
出现条件:添加参数时 [实测]。
支持文本、图片、文件、文本列表等 13 种,不支持日期、时间、日期时间、颜色和动态时间线 [源码]。
填错后果:类型不匹配会导致前台渲染异常。
操作步骤
- 进入「设计 → 模板内容设置」。
- 添加参数,填写参数名、备注、模块组和字段类型。
- 保存后在对应参数中填写内容。
- 点击「提交」保存整体设置。
- 在模板中按大写后的参数名调用。
适用场景与建议
- 把联系电话、地址、统计代码等全局内容做成参数,方便非技术人员维护。
- 模块组按用途划分,如「基础信息」「联系方式」。
前台调用示例
{% diy with name="SitePhone" %}
{% diy sitePhone with name="SitePhone" %}
<a href="tel:{{ sitePhone }}">{{ sitePhone }}</a>
参数名填写 SitePhone 时,模板中必须使用 name="SitePhone",大小写一致。
注意事项
- 参数名保存时会自动首字母大写,填写
sitePhone会变成SitePhone。 - 支持 13 种字段类型,不支持日期、时间、日期时间、颜色和动态时间线。
- 修改后前台没有变化,先清理缓存。
- 参数类型与配置细节见自定义字段教程。