如何按模块或父级关系在 AnQiCMS 模板中列出分类信息？
安企CMS (AnQiCMS) 模板中按模块或父级关系列出分类信息的详细指南
作为一名资深的安企CMS网站运营者，我深知内容组织的重要性。一个清晰、易于导航的分类体系不仅能提升用户体验，更是SEO优化的基石。安企CMS凭借其灵活的内容模型和强大的模板标签系统，为我们提供了多种方式来按模块或父级关系在网站模板中展示分类信息。本文将深入探讨如何利用这些功能，构建高效的分类列表。
理解安企CMS的分类结构
在安企CMS中，分类是组织网站内容的骨架。每个分类都与一个特定的“内容模型”相关联，例如“文章模型”或“产品模型”。这种关联确保了分类内容的结构化和一致性。此外，安企CMS支持多级分类，这意味着分类之间可以存在清晰的“父子”关系，形成一个层次化的内容结构。理解这种结构是我们有效调用分类信息的第一步。
使用 categoryList 标签获取分类信息
categoryList 标签是安企CMS模板系统中用于列出分类信息的核心工具。它允许我们根据不同的条件筛选和显示分类，无论是顶级分类、特定模型下的所有分类，还是某个父级分类的子分类。
这个标签的基本用法是 {% categoryList categories with ... %}，其中 categories 是你为分类列表定义的变量名，... 则是我们用来指定筛选和排序条件的参数。在循环遍历 categories 变量时，我们可以访问到每个分类的详细信息，例如 item.Id（分类ID）、item.Title（分类标题）、item.Link（分类链接）、item.Description（分类描述）以及 item.HasChildren（是否包含子分类）等。
按内容模块列出顶级分类
在构建网站的主导航或特定模块的入口时，我们经常需要列出属于某个特定内容模型的顶级分类。例如，你可能想在网站首页展示“文章”和“产品”两个主要模块下的所有一级分类。
要实现这一点，我们需要使用 moduleId 参数来指定目标内容模型的ID，并设置 parentId="0" 来明确只获取顶级分类。文章模型通常默认为 moduleId="1"，产品模型可能为 moduleId="2"，具体ID可以在后台的内容模型管理中查看。
{# 假设文章模型的ID是1 #}
<div class="main-articles-nav">
<h3>文章分类</h3>
<ul>
{% categoryList topCategories with moduleId="1" parentId="0" %}
{% for category in topCategories %}
<li><a href="{{ category.Link }}">{{ category.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
</ul>
</div>
{# 假设产品模型的ID是2 #}
<div class="main-products-nav">
<h3>产品分类</h3>
<ul>
{% categoryList productCategories with moduleId="2" parentId="0" %}
{% for category in productCategories %}
<li><a href="{{ category.Link }}">{{ category.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
</ul>
</div>
通过这样的方式，我们能够清晰地将不同内容模块的分类独立展示，为用户提供有针对性的导航入口。
按父级关系列出子分类
除了列出顶级分类，构建多级导航或在分类详情页显示子分类是常见的需求。安企CMS的 categoryList 标签通过 parentId 参数完美支持这一功能。
要获取某个特定分类的直接子分类，你可以将该父分类的 Id 传递给 parentId 参数。如果当前页面本身就是一个分类页，我们还可以结合 categoryDetail 标签动态获取当前分类的ID，进而列出其子分类。
{# 假设我们正在一个文章分类详情页，需要列出当前分类的所有子分类 #}
{# 首先获取当前分类的ID #}
{% categoryDetail currentCategoryId with name="Id" %}
<div class="sub-category-list">
<h3>当前分类的子分类</h3>
<ul>
{% categoryList subCategories with parentId=currentCategoryId %}
{% for subCategory in subCategories %}
<li><a href="{{ subCategory.Link }}">{{ subCategory.Title }}</a></li>
{% endfor %}
{% endcategoryList %}
</ul>
</div>
我们也可以实现多级分类的嵌套展示，这在构建复杂的树状导航时非常有用。这需要多层 categoryList 标签的嵌套，每一层都以上一层的分类ID作为 parentId。
{# 嵌套多级分类示例：列出文章模型下的三级分类 #}
<nav class="multi-level-nav">
{% categoryList level1Categories with moduleId="1" parentId="0" %}
<ul>
{% for level1 in level1Categories %}
<li>
<a href="{{ level1.Link }}">{{ level1.Title }}</a>
{# 判断是否存在子分类 #}
{% if level1.HasChildren %}
{% categoryList level2Categories with parentId=level1.Id %}
<ul>
{% for level2 in level2Categories %}
<li>
<a href="{{ level2.Link }}">{{ level2.Title }}</a>
{% if level2.HasChildren %}
{% categoryList level3Categories with parentId=level2.Id %}
<ul>
{% for level3 in level3Categories %}
<li><a href="{{ level3.Link }}">{{ level3.Title }}</a></li>
{% endfor %}
</ul>
{% endcategoryList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
</nav>
结合分类列表展示关联文档
更进一步的应用场景是，你可能希望在列出分类的同时，也展示每个分类下的部分文档，例如在首页的“最新文章”板块，按分类展示几篇最新文章。这可以通过将 archiveList 标签嵌套在 categoryList 标签内部来实现。
<div class="category-with-archives">
{% categoryList categories with moduleId="1" parentId="0" limit="4" %} {# 假设只显示4个顶级分类 #}
<section>
<h3><a href="{{ category.Link }}">{{ category.Title }}</a></h3>
<ul>
{% archiveList archives with type="list" categoryId=category.Id limit="5" %} {# 每个分类显示5篇文档 #}
{% for archive in archives %}
<li>
<a href="{{ archive.Link }}">
<img src="{{ archive.Thumb }}" alt="{{ archive.Title }}">
{{ archive.Title }}
</a>
</li>
{% empty %}
<li>暂无相关文档。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</section>
{% endcategoryList %}
</div>
实践中的优化与注意事项
在实际操作中，为了确保网站性能和用户体验，请注意以下几点：
- 明确
moduleId和parentId：始终明确你想要获取哪个内容模型下的分类，以及这些分类属于哪个层级。这将帮助categoryList标签高效地查询数据。 - 控制
limit参数：在列表标签中合理使用limit参数来限制返回的数量，避免一次性加载过多的数据，尤其是在首页或侧边栏等位置。 - 利用
HasChildren：在构建多级导航时，使用item.HasChildren条件判断来决定是否渲染子分类的容器，这样可以避免生成空的HTML结构。 - 模板缓存：安企CMS内置缓存机制，合理利用可以加速页面加载。在进行复杂的数据调用时，如果数据不经常变动，可以考虑相关的缓存策略。
- 伪静态规则：确保你的分类链接 (
item.Link) 在前端能够正常访问。安企CMS提供了灵活的伪静态规则配置，确保生成的URL是SEO友好的。
通过精细化地运用 categoryList 标签及其参数，我们可以灵活地在安企CMS模板中构建出任何你想要的分类展示方式，无论是简洁的模块导航，还是复杂的多级内容结构，都能轻松实现，从而为访客提供一个结构清晰、内容丰富且易于探索的网站。
常见问题 (FAQ)
Q1: 如何在任何页面都列出所有内容模型下的所有分类，而不仅仅是特定模块的分类？
A1: 你可以使用 categoryList 标签并设置 all=true 来获取所有内容模型下的所有分类。如果仍然需要区分，可以在循环内部通过 item.ModuleId 或 item.ModuleName（如果 ModuleName 字段可用，文档中未明确列出，但 item.ModuleId 是有的）进行判断和分组展示。例如：{% categoryList allCategories with all=true %}。
Q2: 如果我的分类层级很深，使用多层嵌套 categoryList 标签会不会影响网站性能？
A2: 确实，过多的嵌套循环可能会对前端渲染性能产生一定影响，尤其是在数据量庞大时。对于深层嵌套的分类，建议优化你的模板逻辑，或者考虑通过JavaScript在前端进行懒加载或异步请求子分类数据。在后端，安企CMS的Go语言高性能架构通常能较好地处理这些查询，但前端渲染仍然是瓶颈所在。在后台设计分类时，也应考虑合理的层级深度，避免不必要的复杂性。
Q3: 我想在分类列表中显示每个分类下的文档总数，categoryList 标签是否支持？
A3: 是的，categoryList 标签的循环项 item 中包含了 ArchiveCount 字段，可以直接调用以显示该分类下的文档数量。例如：{{ item.Title }} ({{ item.ArchiveCount }})。这对于用户了解分类内容量非常有帮助。