在网站内容管理中，我们经常会遇到这样的需求：希望在某个页面上展示特定分类下的文章，但又不想包含该分类下的子分类文章，以保持内容的纯粹性和聚焦性。例如，您可能有一个“公司新闻”分类，其中包含“企业动态”、“行业资讯”等子分类，但在首页只想展示纯粹的“公司新闻”，而不希望将所有子分类内容混杂进来。
安企CMS作为一款功能强大且灵活的内容管理系统，提供了简洁高效的方式来满足这类精细化的内容展示需求。本文将深入解析如何在AnQiCMS中实现这一目标。
理解核心需求：精准内容定位
为什么会有这样的需求呢？通常是为了：
- 保持主题聚焦： 确保展示的内容严格符合当前分类的主题，避免子分类的细分内容分散主旨。
- 优化用户体验： 帮助用户快速找到他们感兴趣的特定内容，减少信息过载。
- 简化页面结构： 让页面布局更清晰，内容层级更分明，便于用户浏览和理解。
- 支持特定营销策略： 例如，只在一个特定区域展示某个一级分类的最新动态，而将更详细的分类内容放在其他页面。
安企CMS的解决方案：巧用 archiveList 标签的 child 参数
在AnQiCMS中，要实现“仅显示某个分类下的文章，而不包含其子分类的文章”，我们主要依赖模板中的 archiveList 标签及其一个关键参数：child。
archiveList 标签是AnQiCMS用于调用文章列表的核心工具。它提供了丰富的参数来控制文章的筛选、排序和展示方式。其中，child 参数正是我们解决这个问题的关键。
categoryId参数： 这个参数用于指定您希望获取文章的分类ID。您可以在AnQiCMS后台的“内容管理”->“文档分类”中找到对应分类的ID。child参数： 这是实现不包含子分类文章的核心。根据AnQiCMS的文档说明，child参数的默认值是true，意味着它会显示指定分类及其所有子分类的文章。而当您明确将其设置为false时，archiveList标签将只获取指定categoryId下的文章，完全排除其子分类中的内容。
结合这两个参数，我们就能精准地控制文章的展示范围。
实战操作：三步轻松实现
现在，我们来一步步看看具体如何操作。
第一步：确定目标分类ID
首先，您需要知道您想要展示文章的那个分类的ID。
进入AnQiCMS后台，导航到左侧菜单的“内容管理”->“文档分类”。在分类列表中，您可以找到每个分类对应的ID（通常在表格的第一列或通过编辑分类时查看URL）。记下您目标分类的ID，例如，假设您的“公司新闻”分类ID是 5。
第二步：编辑模板文件
接下来，我们需要编辑您网站中需要展示这些文章的模板文件。
AnQiCMS的模板文件通常位于 /template 目录下，并以 .html 作为后缀。您可以通过后台的“模板设计”功能在线编辑模板，或者通过FTP/SFTP工具直接修改服务器上的文件。
例如，您可能想在网站的首页 (index/index.html 或 index.html) 或某个自定义内容块中展示这些文章。
第三步：插入 archiveList 标签代码
在找到并打开您希望修改的模板文件后，您需要插入 archiveList 标签代码。这里，我们将使用 categoryId 参数来指定分类，并设置 child=false 来排除子分类文章。
以下是一个具体的代码示例，假设我们要显示ID为 5 的分类下的最新10篇文章，且不包含子分类：
{# 假设我们只想显示分类ID为5（例如“公司新闻”）下的文章，不包含其子分类 #}
<div class="news-list-section">
<h3>最新公司新闻</h3>
<ul>
{# 使用 archiveList 标签调用文章列表 #}
{# categoryId 指定分类ID，child=false 确保不包含子分类文章 #}
{# type="list" 表示以列表形式获取，limit="10" 限制显示10篇文章 #}
{% archiveList articles with categoryId="5" child=false type="list" limit="10" %}
{% for item in articles %}
<li>
<a href="{{ item.Link }}" title="{{ item.Title }}">
{# 显示文章标题 #}
<h4>{{ item.Title }}</h4>
{# 显示文章发布时间，使用 stampToDate 格式化时间戳 #}
<span class="publish-date">{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
{# 如果文章有缩略图，可以显示 #}
{% if item.Thumb %}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="article-thumb">
{% endif %}
{# 显示文章简介 #}
<p>{{ item.Description|truncatechars:100 }}</p>
</a>
</li>
{% empty %}
{# 如果分类下没有文章，显示此消息 #}
<li>目前该分类下没有可展示的文章。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
代码解释：
{% archiveList articles with categoryId="5" child=false type="list" limit="10" %}：这是核心标签，它定义了一个名为articles的变量来存储获取到的文章列表。categoryId="5"：告诉系统只从ID为5的分类中获取文章。child=false：这个是关键！ 它明确指示系统不要从ID为5的任何子分类中获取文章。type="list"：表示获取的是一个简单的文章列表，而不是分页列表（如果需要分页，可以使用type="page"并结合pagination标签）。limit="10"：限制只显示最新的10篇文章。
{% for item in articles %}…{% endfor %}：这是一个循环结构，用于遍历articles变量中存储的每一篇文章。{{ item.Link }}：输出文章的链接。{{ item.Title }}：输出文章的标题。{{ stampToDate(item.CreatedTime, "2006-01-02") }}：格式化并输出文章的发布时间。stampToDate是AnQiCMS提供的便捷时间格式化函数。{{ item.Description|truncatechars:100 }}：输出文章的简介，并使用truncatechars过滤器截取前100个字符。{% empty %}：如果articles列表为空（即该分类下没有文章），则会显示{% empty %}和{% endfor %}之间的内容。
一些实用的建议
- 测试与验证： 完成代码修改后，务必在前端页面进行测试。检查文章是否确实来自指定分类，且没有子分类的文章出现。
- 缓存清理： 如果修改模板后前端没有立即生效，尝试清理AnQiCMS的系统缓存（通常在后台有“更新缓存”选项）。
- 分类结构清晰： 保持后台的分类结构清晰有助于管理和调用。定期检查分类ID，确保与模板中的设置一致。
通过上述步骤，您就能在AnQiCMS中精准地控制文章展示，仅显示您希望的特定分类内容，从而提升网站的信息架构和用户体验。AnQiCMS的这种灵活性使得内容运营变得更加高效和精准。
常见问题 (FAQ)
1. 我想显示某个分类下的文章，同时包含其所有子分类的文章，应该怎么做？
答：这其实是 archiveList 标签的默认行为。您只需要移除 child=false 这个参数，或者将其明确设置为 child=true 即可。例如：
{% archiveList articles with categoryId="5" type="list" limit="10" %}
这样就会获取分类ID为5及其所有子分类下的文章。
2. 如何在同一页面显示多个不含子分类的特定分类文章？
答：如果您想显示多个一级分类（例如公司新闻、产品动态），且都不包含各自的子分类，您可以在 categoryId 参数中使用逗号分隔多个分类ID，并继续使用 child=false。例如，要显示分类ID为5和8的文章（不含各自子分类）：
{% archiveList articles with categoryId="5,8" child=false type="list" limit="20" %}
这将从这两个分类中获取总共20篇文章。
3. 为什么我设置了 child=false 却没有生效，或者页面文章数量不对？
答：遇到这种情况，可以从以下几个方面进行排查：
- 分类ID是否正确？ 再次确认您在
categoryId中填写的ID是否确实是您想要的目标分类。 - 代码拼写错误？ 检查
child=false是否有任何拼写错误，例如chlid=false或child="false"（虽然大部分情况下AnQiCMS的模板引擎会自动转换布尔字符串，但明确写false更规范）。 - 缓存问题？ 清理AnQiCMS后台缓存和您的浏览器缓存，确保加载的是最新的模板文件。
- 文章是否存在？ 确认您目标分类下确实存在已发布的文章，并且这些文章没有被设置为草稿或未显示状态。