文档分类
文档分类
文档分类用于按模型组织文档,维护分类层级、模板、显示状态和分类自定义字段。
入口路径
后台顶部菜单 →「内容」→「文档分类」。实际地址:/system/archive/category,需要管理员权限(canAdmin)。
功能说明
分类按文档模型分组展示,支持**分类、子分类、批量添加、模板指定、排序、显示/隐藏,以及分类自定义字段。
界面截图

列表字段说明
| 字段 | 含义 | 取值或来源 | 对操作的影响 |
|---|---|---|---|
| ID / 排序 | 分类编号与排序值 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 分类名称 | 前台显示名称 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 文档模型 | 分类所属模型 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 分类模板 | 分类页使用的模板,默认继承模型 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 文档模板 | 该分类下文档使用的模板 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 文档数量 | 当前分类下的文档数 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 显示状态 | 显示 / 隐藏 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| 操作 | 文档列表、增加子类、批量增加子类、修改、删除 | 后台记录,只读 | 用于识别与筛选,不可直接编辑 |
| :— | :— | ||
| ID / 排序 | 分类编号与排序值 | ||
| 分类名称 | 前台显示名称 | ||
| 文档模型 | 分类所属模型 | ||
| 分类模板 | 分类页使用的模板,默认继承模型 | ||
| 文档模板 | 该分类下文档使用的模板 | ||
| 文档数量 | 当前分类下的文档数 | ||
| 显示状态 | 显示 / 隐藏 | ||
| 操作 | 文档列表、增加子类、批量增加子类、修改、删除 |
操作步骤
- 进入「内容 → 文档分类」。
- 点击「添加**分类」或「批量添加分类」创建分类。
- 在已有分类上点「增加子类」建立层级。
- 点击「修改」设置模板、排序和显示状态。
- 文档数量不准时,点击「更新文档计数」。
适用场景与建议
- 分类层级不宜过深,三级以上会让前台筛选和模板编写复杂化。
- 需要不同列表样式时,为分类指定独立的「分类模板」。
- 分类字段用于存放 SEO 文案、图片等额外信息,配置方法见自定义字段教程。
前台调用示例
分类列表通过 categoryList 标签调用:
{% categoryList categories with moduleId="1" parentId="0" %}
{% for item in categories %}
<a href="{{ item.Link }}">{{ item.Spacer|safe }}{{ item.Title }}</a>
{% endfor %}
{% endcategoryList %}
分类详情字段通过 categoryDetail 标签读取,自定义字段也用该标签按字段名调用。
注意事项
- 删除分类前先确认其下的文档已转移,否则文档会失去分类归属。
- 修改模板文件名后,模板文件必须真实存在,否则前台列表页会报错。
- 隐藏分类不会删除文档,但前台通常不再展示该分类入口。