加载中…
文档目录
扩展字段

这是做什么的

「扩展字段」让你不用改代码,就能给商品、文章、文档、案例等模块追加自定义字段。比如给商品加「材质」、给文章加「作者」、给案例加「完成时间」。定义好之后,对应模块的新增/编辑页会自动出现这些字段,录入的内容也会在前台页面展示。

系统提供 12 种字段类型:单行文本、多行文本、数字、日期、下拉选择、单选、复选、开关、单图、多图、附件、富文本。

在哪里操作

进入左侧菜单【设置】→【扩展字段】,页面地址形如 ?route=metadata。

页面按模块分组展示字段,每组标题右侧有【新增字段】入口;点分组标题可只看该模块的字段。

【此处插入:扩展字段列表页面截图】

【此处插入:扩展字段新增/编辑页面截图】

操作前准备

  • 想清楚字段要加给哪个模块、叫什么名字、用什么类型。
  • 多语言站点可先在【设置】→【多语言设置】里建好语言,字段显示名可在定义里为各语言补译名。

新增字段(分步操作)

  1. 进入对应模块分组的列表页,点右上角【新增字段】。
  2. 填写下面各字段,点【提交】,提示保存成功即完成。
字段 填什么 是否必填 示例 填错会怎样
显示名 字段在编辑页和前台显示的名字 必填 材质 不填会提示不能为空
字段标识 程序用的英文短名:小写字母开头,只能小写字母/数字/下划线,最长 30 个字符 必填 material 重复或格式不对会提示错误
所属模块 加给哪个模块 必填 商品 从分组进入时已自动带出,不可更改
字段类型 12 种类型里选一种 必填 单行文本 类型创建后不可更改
选项 下拉/单选/复选的候选项 该三类必填 纯棉、涤纶 不填无法保存该类字段
数量上限 多图/复选/附件最多可选几个,0 为不限(多图默认 6 个槽位,上限 20) 按需 6 超出范围会提示错误
附件类型 附件字段允许的扩展名(平台允许范围内) 附件字段按需 pdf,zip 含不允许的扩展名会提示错误
是否必填 开启后录入内容时必填(仅默认语言校验) 必填 否 选错影响录入
排序 数字,决定字段在编辑页和前台的出现顺序 按需 50 数字相同先后不确定
状态 停用后编辑页和前台都不显示(数据保留) 必填 显示 —

字段标识和字段类型创建后不可修改,换类型只能删除后重建;单个模块最多 100 个字段。

在内容编辑页录入

  • 打开商品、文章等模块的新增/编辑页,定义好的扩展字段会出现在表单里,按控件提示填写:文本直接输入,日期用日期控件,单图/多图/附件点上传按钮,富文本用编辑器排版。
  • 多语言站点:默认语言直接填写;其它语言在字段旁的翻译抽屉里填写,勾选「继承默认」表示该语言沿用默认语言内容。多图不支持多语言。

编辑 / 删除字段

  • 编辑:在列表里点字段右侧的【编辑】,可改显示名、选项、必填、排序、状态等;字段标识和类型不可改。
  • 删除:点【删除】并确认。删除只移除定义,已录入的内容和附件会保留;重建同标识的字段后数据可恢复显示。
  • 暂时不想展示的字段,把状态设为停用比删除更稳妥。

前台显示

  • 定义并录入后,前台对应模块的详情页会输出扩展字段:metadata.<字段标识> 提供显示名和展示值;metadata_list 按定义顺序列出全部字段,适合整段循环展示。
  • 展示样式由主题模板决定:默认主题已内置写法,自定义主题可参考默认主题的商品详情页(product.dwt)。

常见问题 / 小贴士

  • 编辑页看不到新加的字段? 检查字段状态是否为「显示」,以及字段是否加在了正确的模块下。
  • 字段标识为什么改不了? 标识创建后锁定,是为了保证已录入的数据不丢失;确实要换就删掉重建(数据保留)。
  • 删除字段会丢数据吗? 不会。内容和附件保留,重建同标识字段即可恢复显示。
  • 复选字段前台显示成什么样? 按勾选顺序把选中项拼成一段文本输出。
  • 富文本字段前台输出的是什么? 输出去掉标签后的纯文本;需要原始 HTML 时主题模板可从字段详情取 html 值。
添加日期:2026-10-21