自定义分类模型字段
用自定义字段给分类增加筛选项与发布项,并在列表页与内容页调用字段值。
一、用途与数据表
自定义字段模型的作用是为某个分类增加专属筛选项,同时增加用户发布时需要填写的内容,让列表页有差异化筛选、内容页有结构化参数。相关表为 kf_info_typemodel(模型)、kf_info_typeoption(字段选项)、kf_info_config(信息配置)。典型场景:给"二手房"增加"户型""朝向""租金",给"二手车"增加"年份""里程"。
二、第一步:创建字段
在「后台 → 分类 → 自定义字段」中新增字段,逐个填写:
| 设置项 | 说明 |
|---|---|
| 变量名 | 英文标识,模板调用时使用,一经使用不建议再改 |
| 字段名称 | 前台显示的名称,如"租金" |
| 字段类型 | 文本、下拉、单选、多选等 |
| 选项值 | 单选、下拉、多选类型需填可选项 |
变量名如同字段的"钥匙",列表和内容页都靠它取值,命名尽量简短且与含义对应。
三、第二步:创建模型并绑定分类
字段创建完成后进入「后台 → 分类 → 模型管理」新建模型,把需要的字段加入模型,并调整排序决定前台展示顺序。随后在「后台 → 分类 → 信息分类」找到目标分类,修改该分类并选择刚建好的模型。这样该分类的发布表单会自动出现这些字段,列表页也会出现对应筛选。
四、第三步:在模板中调用
字段值需要在模板里写标签才会显示。电脑端模板在 template/pc/info,手机端在 template/wap/info,列表与内容页模板分别调用:
- 列表标题中调用筛选文字:
${kInfoList_变量名_value},当筛选被选中时替换为对应选项文字。 - 列表中或内容页中调用字段值:
${kCol变量名,0}。 - 下拉、单选、多选类型取选项文字:
${kCol变量名__value,0}。
例如租金字段变量名为 zhujin,在内容页写:
租金:${kColzhujin,0}
保存模板后刷新列表页与内容页,确认字段已正确输出。
五、常见坑与检查
- 改了字段变量名,模板里的旧标签会失效,需同步修改。
- 字段加进模型但没绑定到分类,发布页不会出现该字段。
- 只改电脑端模板、漏改手机端,手机会丢字段。
- 单选、多选务必配好选项值,否则前台无可选内容。
- 检查清单:发布页出现新字段 → 列表筛选可命中 → 内容页正确显示 → 手机端同样正常。