作为一名AnQiCMS的资深网站运营人员，我深知高效的内容组织和展示对于用户体验和SEO至关重要。分类列表，尤其是多级嵌套的分类列表，能够清晰地呈现网站内容的层级结构，引导用户发现更多感兴趣的内容，同时也为搜索引擎提供了明确的站点结构信息。本文将详细阐述如何在AnQiCMS模板中调用文章或产品分类列表，并实现多级嵌套的展示效果。
理解AnQiCMS的模板基础与分类逻辑
AnQiCMS采用了类似Django模板引擎的语法，这使得模板的开发和定制变得直观且易于上手。在AnQiCMS中，内容（如文章、产品）是与“内容模型”紧密关联的，而分类则进一步组织这些内容。每个分类都属于且仅属于一个内容模型，这意味着文章分类和产品分类是相互独立的。在模板中调用分类列表时，我们需要指定所属的内容模型ID，例如文章模型通常为ID 1，产品模型通常为ID 2。
AnQiCMS的模板文件通常存放在/template目录下，通过结构化的标签（以{%和%}包裹）进行逻辑控制，变量则使用双花括号{{}}进行输出。这种设计使得我们可以通过嵌套循环和条件判断，灵活地构建出复杂的分类导航结构。
调用基础分类列表
要在一个页面上展示最基本的分类列表，例如网站顶部的导航菜单，我们可以使用categoryList标签。这个标签允许我们根据模型ID和父级分类ID来筛选和获取分类数据。
例如，如果您想获取所有顶级文章分类列表，可以使用以下代码：
{% categoryList categories with moduleId="1" parentId="0" %}
<ul>
{% for item in categories %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
</li>
{% endfor %}
</ul>
{% endcategoryList %}
在这段代码中：
categoryList是分类列表标签，categories是我们为获取到的分类数据定义的变量名。moduleId="1"指定了我们要获取的是文章模型（ID为1）的分类。parentId="0"表示我们只获取没有父级分类的顶级分类。for循环遍历categories变量中的每一个分类项。item.Link和item.Title分别用于输出分类的链接和标题。
通过这种方式，您可以轻松地构建出网站的主导航菜单或某个内容区域的顶级分类展示。
实现多级分类嵌套
多级分类嵌套是构建复杂导航和内容索引的关键。AnQiCMS的categoryList标签通过parentId参数和分类项自带的HasChildren属性，使得实现多级嵌套变得非常便捷。我们可以在一个分类循环内部，再次调用categoryList标签来获取当前分类的子分类。
下面是一个实现三级分类嵌套的典型代码示例：
{% categoryList categories with moduleId="1" parentId="0" %}
{# 一级分类开始 #}
<ul>
{% for item in categories %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
{# 判断当前一级分类是否有子分类 #}
{% if item.HasChildren %}
{# 二级分类开始：调用当前一级分类的子分类 #}
<ul>
{% categoryList subCategories with parentId=item.Id %}
{% for inner1 in subCategories %}
<li>
<a href="{{ inner1.Link }}">{{inner1.Title}}</a>
{# 判断当前二级分类是否有子分类 #}
{% if inner1.HasChildren %}
{# 三级分类开始：调用当前二级分类的子分类 #}
<ul>
{% categoryList subCategories2 with parentId=inner1.Id %}
{% for inner2 in subCategories2 %}
<li>
<a href="{{ inner2.Link }}">{{inner2.Title}}</a>
</li>
{% endfor %}
</ul>
{% endcategoryList %}
{# 三级分类结束 #}
{% endif %}
</li>
{% endfor %}
</ul>
{% endcategoryList %}
{# 二级分类结束 #}
{% endif %}
</li>
{% endfor %}
</ul>
{# 一级分类结束 #}
{% endcategoryList %}
在这个示例中：
- 外层的
categoryList获取顶级分类 (parentId="0")。 - 在第一个
for循环内，我们使用{% if item.HasChildren %}来判断当前分类是否有子分类。 - 如果有子分类，则再次调用
categoryList，这次将parentId设置为当前循环项的item.Id，以获取其直接子分类。我们将这些子分类存储在subCategories变量中。 - 这个模式可以依此类推，通过不断嵌套
categoryList和for循环，配合HasChildren判断，实现任意深度的分类嵌套。
分类与文章/产品内容的整合展示
除了仅仅展示分类结构，您还可能需要在分类下直接展示相关的文章或产品列表，或者在没有子分类时展示内容。这可以通过结合archiveList标签来实现。
例如，在一个产品分类导航中，如果一个分类有子分类，我们希望显示其子分类；如果它没有子分类，我们则希望显示该分类下的产品列表：
<div>
{% categoryList productCategories with moduleId="2" parentId="0" %}
{% for item in productCategories %}
<a href="{{item.Link}}">{{item.Title}}</a>
<ul class="ind-pro-nav-ul">
{% if item.HasChildren %}
{# 如果有子分类，显示子分类列表 #}
{% categoryList subCategories with parentId=item.Id %}
{% for inner in subCategories %}
<li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
{% endfor %}
{% endcategoryList %}
{% else %}
{# 如果没有子分类，显示当前分类下的产品列表 #}
{% archiveList products with type="list" categoryId=item.Id limit="8" %}
{% for inner in products %}
<li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
{% endfor %}
{% endarchiveList %}
{% endif %}
</ul>
{% endfor %}
{% endcategoryList %}
</div>
此示例展示了如何根据HasChildren属性的布尔值，在分类导航中动态地渲染子分类或直接展示该分类下的内容。这对于构建灵活的产品目录或文章专题非常有用，能够根据内容的实际组织方式提供**的用户体验。
优化与**实践
在构建分类列表时，考虑以下几点可以进一步优化网站的性能和可维护性：
- 样式分离：模板代码专注于数据逻辑和结构，而列表和导航的视觉样式应通过外部CSS文件进行控制。这有助于保持模板代码的整洁和可读性。
- 模型ID的精确使用：始终明确指定
moduleId，以确保您获取到的是所需内容模型（文章或产品）下的分类，避免混淆或错误的数据调用。 - 利用公共代码片段：对于复杂的、多处重复使用的分类列表结构，可以考虑将其封装为公共代码片段（partial），通过
{% include "partial/your_category_list.html" %}进行调用。这提高了代码的复用性，简化了模板结构。 - 控制显示数量：使用
limit参数限制每次调用的分类或文章数量，尤其是在首页或其他加载量大的页面上。这有助于提升页面加载速度，优化用户体验。
通过熟练运用AnQiCMS提供的categoryList和archiveList标签，并结合其灵活的模板语法，您可以为您的网站构建出强大且用户友好的分类导航系统，从而有效地管理和展示您的内容。
常见问题 (FAQ)
1. 如何确保我只获取到顶级分类，而不是所有分类？
您可以通过在categoryList标签中设置parentId="0"参数来明确指定只获取顶级分类。例如：{% categoryList categories with moduleId="1" parentId="0" %}。
2. 为什么我的分类列表没有显示子分类，即使我已经在后台设置了？
确保您在循环父级分类时，在内部使用{% if item.HasChildren %}进行判断，并且在条件成立时，再次调用categoryList并将其parentId参数设置为当前父级分类的Id。例如：{% categoryList subCategories with parentId=item.Id %}。如果子分类数据量很大，可能也需要检查是否设置了limit参数，导致未能全部显示。
3. 我能否在一个分类列表的循环中，同时判断是否有子分类和是否有文章/产品？
是的，您可以在for循环中利用item.HasChildren来判断是否存在子分类。如果item.HasChildren为true，则可以调用子分类列表；如果为false，则