作为资深的网站运营专家，我深知一套灵活高效的内容管理系统对网站运营的重要性。安企CMS（AnQiCMS）以其轻量级、高性能和高度可定制的特性，赢得了众多中小企业和内容运营者的青睐。在日常的内容运营中，我们常常需要对网站内容进行精细化的管理和展示，其中，如何精确地获取特定作者的文档，或仅显示当前分类下的内容而排除子分类，是提升用户体验和优化内容结构的关键。今天，我们就来深入探讨 archiveList 标签的这两个强大功能。
安企CMS archiveList 深度解析：精准获取文档与灵活分类控制
在安企CMS中，archiveList 标签无疑是内容展示的核心。它如同一个强大的筛选器，帮助我们从海量内容中提取出符合特定条件的文档（包括文章、产品等），并以各种形式呈现在网站前端。无论是展示最新动态、热门产品，还是构建复杂的专题页面，archiveList 都扮演着不可或缺的角色。它沿用了Django模板引擎的简洁语法，通过 {% tag %} 来定义标签，{{ variable }} 来输出变量，使得模板开发变得直观而高效。
默认情况下，我们可能只是简单地调用 archiveList 来获取某个模型下的最新文档列表：
{% archiveList archives with moduleId="1" type="list" limit="5" %}
{% for item in archives %}
<li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
{% empty %}
<li>暂无文档。</li>
{% endfor %}
{% endarchiveList %}
然而，安企CMS的强大之处远不止于此。当我们需要更精细地控制内容来源时，userId 和 child 这两个参数便能发挥出它们的独特作用。
一、驾驭内容发布者：userId 参数的妙用
在多用户或多作者协作的网站环境中，比如一个由多个专家共同撰写的博客，或者一个展示不同创作者作品的平台，我们可能需要单独列出某位特定作者发布的所有文档。这时，archiveList 的 userId 参数就派上用场了。
userId 参数允许我们指定一个用户ID，archiveList 便会只返回该用户ID下发布的所有文档。这对于构建个人作者专栏、展示编辑精选内容，或是方便用户查看自己发布的内容都极为有用。用户ID通常是安企CMS后台分配给每个管理员或内容发布者的唯一标识。
设想一下，在一个名为“科技探索”的博客中，用户ID为 1 的作者是“张博士”，用户ID为 2 的作者是“李工程师”。如果我们想在某个页面上专门展示“张博士”的所有文章，只需像这样使用 userId 参数：
{% archiveList archives with userId="1" moduleId="1" type="list" limit="5" %}
{% for item in archives %}
<li>【作者 ID: {{ item.UserId }}】<a href="{{ item.Link }}">{{ item.Title }}</a></li>
{% empty %}
<li>该作者暂无文档发布。</li>
{% endfor %}
{% endarchiveList %}
通过这种方式，我们可以轻松地为每位作者创建一个个人主页，动态展示他们的作品集，大大提升了内容的组织性和个性化程度。在运营策略上，这也有助于建立作者个人品牌，增强用户的归属感和粘性。
二、精准聚焦分类：child 参数的魔法
安企CMS的内容分类体系通常支持多级结构，例如“新闻中心”下可能有“公司新闻”、“行业动态”等子分类。在很多情况下，我们需要在父分类页面展示其所有内容，包括子分类的文档，这也是 archiveList 标签的默认行为（child 参数默认为 true）。然而，有时我们的运营目标是让用户仅仅关注当前这个父分类本身的内容，而忽略其子分类的文档，以实现更精准的专题聚焦。
这时，child 参数就显得尤为关键。当我们将 child 参数设置为 false 时，archiveList 将只获取指定 categoryId 下的文档，而不会包含其任何子分类的文档。
举例来说，如果“新闻中心”的 categoryId 是 10，“公司新闻”是 10 的子分类，如果我们希望在“新闻中心”页面上只显示直接发布到“新闻中心”分类下的文档，而不展示任何“公司新闻”或其他子分类的文档，可以这样配置 archiveList：
”`twig {% archiveList archives with categoryId=“10”