自定义分类模型字段

分类:功能模块 · 更新于 2026-11-05 · 约 957 字

用自定义字段给分类增加筛选项与发布项,并在列表页与内容页调用字段值。

一、用途与数据表

自定义字段模型的作用是为某个分类增加专属筛选项,同时增加用户发布时需要填写的内容,让列表页有差异化筛选、内容页有结构化参数。相关表为 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}

保存模板后刷新列表页与内容页,确认字段已正确输出。

五、常见坑与检查

  1. 改了字段变量名,模板里的旧标签会失效,需同步修改。
  2. 字段加进模型但没绑定到分类,发布页不会出现该字段。
  3. 只改电脑端模板、漏改手机端,手机会丢字段。
  4. 单选、多选务必配好选项值,否则前台无可选内容。
  5. 检查清单:发布页出现新字段 → 列表筛选可命中 → 内容页正确显示 → 手机端同样正常。

相关教程

文档对不上实际界面?可在常见问题中查找排查步骤,或按「安装部署」中的环境要求核对版本。