模板内容设置

📅 2026-11-21 👁️ 0

模板内容设置

模板内容设置用于维护当前模板的自定义内容参数,可在不修改模板代码的情况下调整电话、地址等全局内容。

入口路径

后台顶部菜单 →「设计」→「模板内容设置」。实际地址:/system/design/diyfield,需要管理员权限(canAdmin)。

功能说明

页面按模块组(如「未分组」)展示自定义参数,支持添加参数并在前台通过 diy 标签调用。

界面截图

模板内容设置

设置项说明

设置项 作用 取值 / 默认 怎么选 / 填写建议 影响 / 注意
参数名 模板调用使用的名称 保存时首字母会自动大写,模板中大小写必须一致 填便于识别的名称,与前台展示保持一致 名称变更会影响展示与调用,注意同步
备注 后台识别说明 — 简明描述,避免空泛 是否展示由模板决定
模块组 把参数分组显示 后台按组折叠 按页面提示与业务需要填写 配置以前台实际表现为准
字段类型 决定填写控件 支持文本、图片、文件、文本列表等 13 种 按页面提示与业务需要填写 配置以前台实际表现为准
默认值 参数初始内容 — 按字段类型填写初始值 留空则无默认值

配置项详解

参数名大小写

出现条件:添加参数时 [实测]。

源码确认参数名保存时首字母自动大写 [源码+i18n]。

推荐值:直接填 SitePhone 这样的形式,模板中用 {% diy with name="SitePhone" %} 调用。

填错后果:模板调用时大小写不一致会读不到值。

字段类型

出现条件:添加参数时 [实测]。

支持文本、图片、文件、文本列表等 13 种,不支持日期、时间、日期时间、颜色和动态时间线 [源码]。

填错后果:类型不匹配会导致前台渲染异常。

操作步骤

  1. 进入「设计 → 模板内容设置」。
  2. 添加参数,填写参数名、备注、模块组和字段类型。
  3. 保存后在对应参数中填写内容。
  4. 点击「提交」保存整体设置。
  5. 在模板中按大写后的参数名调用。

适用场景与建议

  • 把联系电话、地址、统计代码等全局内容做成参数,方便非技术人员维护。
  • 模块组按用途划分,如「基础信息」「联系方式」。

前台调用示例

{% diy with name="SitePhone" %}

{% diy sitePhone with name="SitePhone" %}
<a href="tel:{{ sitePhone }}">{{ sitePhone }}</a>

参数名填写 SitePhone 时,模板中必须使用 name="SitePhone",大小写一致。

注意事项

  • 参数名保存时会自动首字母大写,填写 sitePhone 会变成 SitePhone。
  • 支持 13 种字段类型,不支持日期、时间、日期时间、颜色和动态时间线。
  • 修改后前台没有变化,先清理缓存。
  • 参数类型与配置细节见自定义字段教程。

相关文档