这是做什么的
「扩展字段」让你不用改代码,就能给商品、文章、文档、案例等模块追加自定义字段。比如给商品加「材质」、给文章加「作者」、给案例加「完成时间」。定义好之后,对应模块的新增/编辑页会自动出现这些字段,录入的内容也会在前台页面展示。
系统提供 12 种字段类型:单行文本、多行文本、数字、日期、下拉选择、单选、复选、开关、单图、多图、附件、富文本。
在哪里操作
进入左侧菜单【设置】→【扩展字段】,页面地址形如 ?route=metadata。
页面按模块分组展示字段,每组标题右侧有【新增字段】入口;点分组标题可只看该模块的字段。
【此处插入:扩展字段列表页面截图】
【此处插入:扩展字段新增/编辑页面截图】
操作前准备
- 想清楚字段要加给哪个模块、叫什么名字、用什么类型。
- 多语言站点可先在【设置】→【多语言设置】里建好语言,字段显示名可在定义里为各语言补译名。
新增字段(分步操作)
- 进入对应模块分组的列表页,点右上角【新增字段】。
- 填写下面各字段,点【提交】,提示保存成功即完成。
| 字段 | 填什么 | 是否必填 | 示例 | 填错会怎样 |
|---|---|---|---|---|
| 显示名 | 字段在编辑页和前台显示的名字 | 必填 | 材质 | 不填会提示不能为空 |
| 字段标识 | 程序用的英文短名:小写字母开头,只能小写字母/数字/下划线,最长 30 个字符 | 必填 | material | 重复或格式不对会提示错误 |
| 所属模块 | 加给哪个模块 | 必填 | 商品 | 从分组进入时已自动带出,不可更改 |
| 字段类型 | 12 种类型里选一种 | 必填 | 单行文本 | 类型创建后不可更改 |
| 选项 | 下拉/单选/复选的候选项 | 该三类必填 | 纯棉、涤纶 | 不填无法保存该类字段 |
| 数量上限 | 多图/复选/附件最多可选几个,0 为不限(多图默认 6 个槽位,上限 20) | 按需 | 6 | 超出范围会提示错误 |
| 附件类型 | 附件字段允许的扩展名(平台允许范围内) | 附件字段按需 | pdf,zip | 含不允许的扩展名会提示错误 |
| 是否必填 | 开启后录入内容时必填(仅默认语言校验) | 必填 | 否 | 选错影响录入 |
| 排序 | 数字,决定字段在编辑页和前台的出现顺序 | 按需 | 50 | 数字相同先后不确定 |
| 状态 | 停用后编辑页和前台都不显示(数据保留) | 必填 | 显示 | — |
字段标识和字段类型创建后不可修改,换类型只能删除后重建;单个模块最多 100 个字段。
在内容编辑页录入
- 打开商品、文章等模块的新增/编辑页,定义好的扩展字段会出现在表单里,按控件提示填写:文本直接输入,日期用日期控件,单图/多图/附件点上传按钮,富文本用编辑器排版。
- 多语言站点:默认语言直接填写;其它语言在字段旁的翻译抽屉里填写,勾选「继承默认」表示该语言沿用默认语言内容。多图不支持多语言。
编辑 / 删除字段
- 编辑:在列表里点字段右侧的【编辑】,可改显示名、选项、必填、排序、状态等;字段标识和类型不可改。
- 删除:点【删除】并确认。删除只移除定义,已录入的内容和附件会保留;重建同标识的字段后数据可恢复显示。
- 暂时不想展示的字段,把状态设为停用比删除更稳妥。
前台显示
- 定义并录入后,前台对应模块的详情页会输出扩展字段:
metadata.<字段标识>提供显示名和展示值;metadata_list按定义顺序列出全部字段,适合整段循环展示。 - 展示样式由主题模板决定:默认主题已内置写法,自定义主题可参考默认主题的商品详情页(product.dwt)。
常见问题 / 小贴士
- 编辑页看不到新加的字段? 检查字段状态是否为「显示」,以及字段是否加在了正确的模块下。
- 字段标识为什么改不了? 标识创建后锁定,是为了保证已录入的数据不丢失;确实要换就删掉重建(数据保留)。
- 删除字段会丢数据吗? 不会。内容和附件保留,重建同标识字段即可恢复显示。
- 复选字段前台显示成什么样? 按勾选顺序把选中项拼成一段文本输出。
- 富文本字段前台输出的是什么? 输出去掉标签后的纯文本;需要原始 HTML 时主题模板可从字段详情取 html 值。