文档列表

📅 2026-11-21 👁️ 0

文档列表

文档列表是全站文档的管理中心,用于筛选、查找、编辑、批量处理文档,以及进入回收站和批量导入。

入口路径

后台顶部菜单 →「内容」→「文档列表」。实际地址:/system/archive/list,需要管理员权限(canAdmin)。

功能说明

列表按文档模型分组展示,提供标题、模型、分类、Flag、状态等筛选条件,以及添加文档、批量导入、批量替换关键词、回收站等入口。

界面截图

文档列表

列表字段说明

字段 含义 取值或来源 对操作的影响
ID 文档**编号 后台记录,只读 用于识别与筛选,不可直接编辑
标题 文档标题 后台记录,只读 用于识别与筛选,不可直接编辑
thumb 是否有缩略图 后台记录,只读 用于识别与筛选,不可直接编辑
文档模型 文档所属模型(文章模块/产品模块/案例模块等) 后台记录,只读 用于识别与筛选,不可直接编辑
所属分类 文档所属分类 后台记录,只读 用于识别与筛选,不可直接编辑
浏览 浏览次数 后台记录,只读 用于识别与筛选,不可直接编辑
状态 正常 / 草稿 / 待发布 后台记录,只读 用于识别与筛选,不可直接编辑
发布/更新时间 发布与最后更新时间 后台记录,只读 用于识别与筛选,不可直接编辑
操作 修改、快速编辑、更多(删除等) 后台记录,只读 用于识别与筛选,不可直接编辑
取值 / 默认 怎么选 / 填写建议 影响 / 注意
:— :— :— :—
ID 文档**编号 — 系统生成或按平台要求填写
标题 文档标题 — 填便于识别的名称,与前台展示保持一致
thumb 是否有缩略图 — 按模板要求的尺寸与比例上传
文档模型 文档所属模型(文章模块/产品模块/案例模块等) — 按实际业务范围选择,可多选
所属分类 文档所属分类 — 按实际业务范围选择,可多选
浏览 浏览次数 — 按页面提示与业务需要填写
状态 正常 / 草稿 / 待发布 — 按业务需要选择启用或停用
发布/更新时间 发布与最后更新时间 — 按业务节奏设置,参考默认值
操作 修改、快速编辑、更多(删除等) — 按需点击对应操作

筛选条件

  • 标题:输入关键词连续匹配,不会拆词。
  • 文档模型:按模型过滤,切换后只显示该模型文档。
  • 所属分类:只列出当前分类及其子分类下的文档。
  • Flag:按推荐属性筛选。
  • 状态:正常 / 草稿 / 待发布。

批量操作与状态流转

  • 「批量导入文档」:按接口规范导入外部内容。
  • 「批量替换关键词」:批量替换标题或正文中的指定词。
  • 「文档回收站」:查看已删除文档,可恢复或彻底删除。
  • 状态流转:正常文档可转为草稿或待发布;待发布文档经过发布后变为正常。

筛选条件

筛选项 取值 匹配规则
标题 关键词 连续匹配,不拆分词
文档模型 各模型 切换后只显示该模型文档
所属分类 各分类 含当前分类及其子分类
Flag 不限制/各推荐属性 按推荐属性筛选
状态 正常/草稿/待发布 按发布状态筛选

状态流转

状态 含义 可执行动作
正常 已发布,前台可见 修改、转入草稿、删除
草稿 未发布 编辑后发布
待发布 定时发布待生效 到设定时间自动发布
回收站 已删除 恢复或彻底删除

操作步骤

  1. 进入「内容 → 文档列表」。
  2. 用筛选条件缩小范围。
  3. 点击「修改」进入完整编辑页,或点「快速编辑」改少量字段。
  4. 使用「更多」执行删除等操作。

适用场景与建议

  • 内容多的站点优先用「文档模型 + 分类」两级筛选,比标题搜索更快定位。
  • 批量改-link 或品牌词时用「批量替换关键词」,不要逐篇修改。

前台调用示例

文档列表通过 archiveList 标签调用:

{% archiveList archives with type="list" moduleId="1" categoryId="1" limit="10" %}
  {% for item in archives %}
    <a href="{{ item.Link }}">{{ item.Title }}</a>
  {% endfor %}
{% endarchiveList %}

type="page" 时配合 {% pagination pages with show="5" %} 输出分页。列表项可用 item.CreatedTime、item.UpdatedTime 等字段,时间戳需经 stampToDate 格式化。

注意事项

  • 标题筛选是连续匹配,输入「模板标签」不会匹配只含「模板」和「标签」但分开出现的标题。
  • 删除文档会进入回收站,不是立即彻底删除。
  • 筛选条件较多时,先清除旧条件再重新筛选,避免结果为零却误以为没有数据。

相关文档