安企CMS：如何在网站页面上获取并展示所有顶级分类列表

作为一名网站运营人员，我深知清晰的网站结构对于用户体验和搜索引擎优化（SEO）的重要性。分类导航是网站内容组织的核心要素之一，它不仅能引导用户快速找到所需信息，还能帮助搜索引擎更好地理解网站内容层级。安企CMS (AnQiCMS) 提供了一套直观且强大的模板标签系统，让网站运营者能够轻松地管理和展示网站的分类结构。

理解安企CMS的分类体系

在安企CMS中，内容是以“分类”的形式进行组织的。每个分类都归属于一个特定的“内容模型”（例如文章模型、产品模型），这使得内容管理更加灵活和结构化。要获取网站的分类列表，我们首先需要理解这些分类是如何与内容模型关联的，因为在调用分类数据时，往往需要指定所属的内容模型ID。

运用 categoryList 标签获取分类数据

安企CMS的模板系统提供了一个名为 categoryList 的专用标签，用于获取和循环展示网站的分类数据。这个标签设计得非常灵活，可以根据不同的需求（如获取特定模型的分类、获取子分类、获取所有分类等）进行参数配置。对于我们当前的需求——获取所有顶级分类列表，categoryList 标签的关键在于其 parentId 参数。

精准获取顶级分类列表

为了准确检索出所有不属于任何上级分类的顶级分类，我们需要将 parentId 参数设置为 "0"。此外，由于安企CMS中的每个分类都绑定到特定的内容模型，我们在获取顶级分类时，还需要明确指定这些分类所属的 moduleId。例如，如果我们要获取文章模型（通常 moduleId="1"）下的所有顶级分类，那么组合起来的标签就会指定 moduleId="1" 和 parentId="0"。这样，categoryList 标签就能精确地返回我们所需的顶级分类数据。

在页面上展示顶级分类列表

一旦我们通过 categoryList 标签获取到顶级分类数据，就可以通过 for 循环来遍历这些数据并在页面上进行展示。在循环内部，我们可以轻松访问每个分类的各种属性，例如分类的ID (item.Id)、标题 (item.Title)、链接 (item.Link) 等。以下是一个具体的模板代码示例，演示了如何获取文章模型（假设 moduleId 为 1）下的所有顶级分类，并以列表形式展示它们的标题和链接：

{# 假设要获取文章模型（moduleId="1"）的所有顶级分类 #}
<nav class="main-category-navigation">
    <ul>
        {% categoryList categories with moduleId="1" parentId="0" %}
            {% for item in categories %}
                <li>
                    <a href="{{ item.Link }}">{{ item.Title }}</a>
                    {# 如果需要，可以根据 item.HasChildren 判断是否有子分类并决定是否加载更多内容 #}
                </li>
            {% empty %}
                <li>目前没有顶级分类可供显示。</li>
            {% endfor %}
        {% endcategoryList %}
    </ul>
</nav>

在这个示例中，categories 是我们为顶级分类列表定义的变量名。通过 {{ item.Link }} 和 {{ item.Title }}，我们分别输出了分类的访问地址和显示名称。{% empty %} 块是一个非常实用的特性，当没有任何分类数据返回时，它将显示友好的提示信息，提升用户体验。

将代码集成到您的网站模板

这段代码可以根据网站的设计需求，放置在模板的不同位置。例如，如果这是网站主导航的一部分，它可能会被包含在 partial/header.html 或 base.html 这样的公共模板文件中，以确保在所有页面中都保持一致。如果它是一个侧边栏的分类列表，则可以放置在 partial/aside.html 或直接嵌入到需要它的页面模板中，如 index/index.html。无论放置在何处，categoryList 标签都能确保动态地加载最新的分类数据，而无需手动更新。

内容模型ID的关键性

在实际操作中，请务必确保 moduleId 的数值与你想要获取的分类所关联的内容模型ID相匹配。安企CMS允许用户自定义内容模型，因此不同网站的 moduleId 可能会有所不同。你可以在安企CMS后台的“内容管理”菜单中，选择“内容模型”进行查看和管理。正确指定 moduleId 是获取准确分类列表的关键步骤。

通过 categoryList 标签配合 moduleId 和 parentId="0" 参数，安企CMS提供了一种高效且灵活的方式来获取并展示网站的所有顶级分类。这种方法不仅能够保持网站结构的清晰和整洁，还能极大地提升内容的可发现性和用户体验。作为一名运营人员，我深知工具的易用性是提升效率的关键，安企CMS在这方面做得非常出色。

常见问题解答 (FAQ)

1. 如何知道我的内容模型的 moduleId 是多少？

您可以通过登录安企CMS后台，导航到“内容管理”菜单，然后选择“内容模型”。在那里，您将看到所有已定义的内容模型及其对应的ID。例如，“文章模型”通常ID为1，“产品模型”ID为2，但自定义的模型会有其特定的ID。务必使用此处显示的确切数字ID。

2. 如果我希望在顶级分类下同时显示其子分类，应该如何修改代码？

如果您希望在顶级分类下显示子分类，可以在顶级分类的 for 循环内部，再次使用 categoryList 标签，并将 parentId 参数设置为当前顶级分类的 item.Id。例如：{% categoryList subCategories with parentId=item.Id %}，然后在这个新的 subCategories 循环中展示子分类。这可以构建出多层级的导航结构。

3. 为什么我的顶级分类列表没有显示任何内容？

这可能有几个原因。首先，请检查 moduleId 参数是否正确指定了您想要获取内容的模型ID。其次，确认安企CMS后台的“内容管理”->“文档分类”中确实存在顶级分类，并且这些分类的“上级分类”字段是空的，这表明它们本身就是顶级分类。最后，请确保您的模板文件已保存为UTF-8编码格式，并且没有语法错误导致标签未能正确解析。