在AnQiCMS中轻松获取指定分类下的文章列表
作为一名资深的网站运营专家，我深知内容管理系统（CMS）的核心价值在于其内容的组织与呈现能力。在众多功能中，如何高效地从特定分类中提取并展示文章，是网站运营者日常工作中不可或缺的一环。今天，我们就来深入探讨AnQiCMS如何帮助您实现这一目标，让技术细节变得直观易懂。
AnQiCMS作为一款基于Go语言的企业级内容管理系统，以其简洁高效的架构，为我们提供了灵活且强大的内容展示机制。其中，获取指定分类下的文章列表，正是通过其精心设计的模板标签来实现的。
理解核心：archiveList 模板标签
在AnQiCMS中，要获取指定分类下的文章列表，我们主要依赖一个功能强大的模板标签：archiveList。这个标签如同一个智能筛选器，能根据我们提供的条件，从庞大的内容库中精准地找到所需文章并呈现出来。
当您在AnQiCMS的模板文件中需要展示特定分类的文章时，首先想到的便是archiveList。它最常见的用法是与categoryId参数结合，明确告诉系统您想获取哪个分类下的文章。例如，如果您有一个分类ID为10的“公司新闻”栏目，您可以使用categoryId="10"来指定这个分类。
让我们来看一个基础的结构：
{% archiveList archives with categoryId="10" limit="5" order="id desc" %}
{% for item in archives %}
<!-- 在这里展示每篇文章的详细信息 -->
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
<p>{{ item.Description }}</p>
<p>发布时间：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</p>
<hr>
{% empty %}
<p>该分类下暂无文章。</p>
{% endfor %}
{% endarchiveList %}
在这段代码中，archives是我们自定义的一个变量名，用来存储archiveList标签返回的文章数据集合。limit="5"告诉系统只显示最新的5篇文章，而order="id desc"则确保这些文章按照ID降序排列，即最新发布的文章在前。{% for item in archives %}循环则遍历这些文章，item变量代表当前遍历到的每一篇文章，您可以通过item.Title、item.Link、item.Description等方式访问文章的各项属性。如果分类下没有文章，{% empty %}块中的内容就会显示。
动态获取分类ID的智慧
在实际运营中，分类ID往往不是固定不变的。例如，当您访问一个分类页面时，可能希望自动显示该分类下的文章，而不是手动输入分类ID。AnQiCMS同样提供了优雅的解决方案。
您可以使用categoryDetail标签来动态获取当前页面的分类信息，包括其ID。
{# 假设当前页面是一个分类列表页 #}
{% categoryDetail currentCategory with name="Id" %}
{% archiveList archives with categoryId=currentCategory limit="10" order="views desc" %}
{% for item in archives %}
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
<p>浏览量：{{ item.Views }}</p>
{% endfor %}
{% endarchiveList %}
在这里，currentCategory变量存储了当前页面的分类ID，并将其传递给了archiveList的categoryId参数。这样一来，无论用户访问哪个分类页面，都会自动显示该分类下的文章。
深入挖掘：更多参数的灵活运用
archiveList标签的强大之处远不止于此，它还提供了多种参数以满足更复杂的需求：
moduleId: AnQiCMS支持灵活的内容模型（如文章、产品等）。如果您只想获取特定内容模型下的文章，可以设置moduleId。例如，moduleId="1"通常代表文章模型。child: 默认情况下，archiveList会获取指定分类及其所有子分类下的文章。如果您只想显示当前分类下的文章，而不包括子分类的内容，可以设置child=false。type: 这个参数非常关键，type="list"表示获取固定数量的文章列表，而type="page"则用于生成可分页的文章列表，通常与pagination标签配合使用，以便实现“上一页/下一页”的导航功能。flag: 如果您的文章设置了推荐属性（如头条[h]、推荐[c]等），可以通过flag="c"来筛选具有特定推荐属性的文章。q: 在搜索页面，您可以使用q参数来指定搜索关键词，archiveList将返回标题中包含该关键词的文章。
示例：结合categoryList遍历显示多个分类的文章
一个常见的需求是，在网站首页或某个聚合页面，展示多个分类及其下的最新文章。这可以通过嵌套categoryList和archiveList标签来实现：
{% categoryList categories with moduleId="1" parentId="0" %} {# 获取所有顶级分类 #}
{% for category in categories %}
<section>
<h2><a href="{{ category.Link }}">{{ category.Title }}</a></h2>
<ul>
{% archiveList articlesInCategory with categoryId=category.Id limit="5" order="id desc" %}
{% for article in articlesInCategory %}
<li>
<a href="{{ article.Link }}">{{ article.Title }}</a>
<span>({{ stampToDate(article.CreatedTime, "01-02") }})</span>
</li>
{% empty %}
<li>此分类下暂无内容。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</section>
{% endfor %}
{% endcategoryList %}
这段代码首先获取所有的顶级文章分类，然后针对每一个分类，再获取其下的5篇最新文章。通过stampToDate过滤器，我们还可以将文章的发布时间格式化成简洁的“月-日”形式。
模板文件的选择与优化
AnQiCMS在模板设计上也非常灵活，支持针对不同分类使用不同的模板。例如，您可以创建{模型table}/list-{分类ID}.html这样的模板文件，让特定分类拥有独特的列表展示样式。这对于实现个性化的内容布局和SEO优化都非常有帮助。
通过以上这些标签和技巧，您便能在AnQiCMS中游刃有余地获取并展示指定分类下的文章列表，无论是简单的列表展示，还是复杂的聚合页面，都能轻松应对。灵活运用这些工具，将极大地提升您网站内容的管理效率和用户体验。
常见问题 (FAQ)
Q1: 我想获取所有分类下的所有文章，应该怎么做？
如果您希望获取网站中所有分类的文章，而不是指定单个分类，可以在使用 archiveList 标签时省略 categoryId 参数，AnQiCMS会默认返回所有文章。当然，为了性能考虑，通常您会配合 limit 参数来限制返回的文章数量，或者使用 type="page" 和 pagination 标签进行分页展示。
Q2: 如果我的文章有不同的内容模型（例如“新闻”和“产品”），如何分别获取它们？
AnQiCMS支持自定义内容模型，每个模型都有一个唯一的 moduleId。当您使用 archiveList 标签时，可以通过 moduleId="X" 来指定您想要获取哪个内容模型的文章，其中X是对应内容模型的ID。例如，如果文章模型的moduleId是1，产品模型的moduleId是2，您可以通过设置moduleId="1"来只获取文章。
Q3: 我想在分类列表页同时展示该分类的子分类，并且在子分类下再列出文章，这能实现吗？
完全可以。您可以通过嵌套 categoryList 标签来实现多级分类的展示。在外层 categoryList 循环中，判断当前分类是否有子分类（item.HasChildren），如果有，则再使用一个 categoryList 标签获取并遍历其子分类；如果没有子分类，或者希望在子分类下方展示文章，则可以在对应的循环中嵌入 archiveList 标签，并将其 categoryId 参数设置为当前分类的ID。文档中“在循环多个分类中显示分类的下级分类，如果没有下级分类，则显示分类的文档”的示例就很好地说明了这一点。