如何利用`categoryList`构建一个扁平化的所有分类列表，不分层级显示？
作为一名资深的网站运营专家，我深知在构建网站内容结构时，灵活地展示分类列表是多么重要。安企CMS（AnQiCMS）凭借其强大的模板标签系统，为我们提供了极大的便利。今天，我们就来深入探讨一个看似简单却极为实用的功能：如何利用categoryList标签，优雅地构建一个扁平化的所有分类列表，让所有分类不分层级地清晰呈现在您的网站上。
一、为何需要扁平化的分类列表？
在内容管理中，我们常常需要树状、层级分明的分类结构来组织内容，这有助于用户逐步深入探索特定主题。但有时，我们也需要一种更直接、更全面的方式来展示所有分类，例如：
- 网站地图（Sitemap）页面：用户希望一眼看到网站的所有内容范围。
- 页面底部（Footer）导航：提供网站内容的概览，方便用户快速跳转到任何一个分类。
- 相关内容推荐区域：以标签云或热门分类的形式，引导用户发现更多兴趣点。
- 数据统计或管理视图：在某些定制化的管理界面中，可能需要查看所有分类，而不关心其层级关系。
在这种场景下，AnQiCMS 的 categoryList 标签配合一个巧妙的参数，就能完美实现我们的需求。
二、揭秘 categoryList 标签的核心能力
安企CMS的categoryList标签是用于获取文章、产品等内容模型下的分类列表的万能工具。它功能强大，既能获取特定父级下的子分类，也能筛选特定模型下的分类。但要实现扁平化展示所有分类，其核心秘诀在于一个特殊的参数：all=true。
通常情况下，当我们使用categoryList并指定parentId="0"时，我们获取的是顶级分类。然而，如果您的分类结构是多级的，仅仅获取顶级分类是不足以展示全部的。此时，all=true参数就派上了大用场，它指示系统忽略层级关系，一股脑地将所有符合条件的分类都提取出来。
同时，我们还需要关注moduleId参数，它能帮助我们精确指定是获取“文章模型”下的所有分类，还是“产品模型”下的所有分类，或者其他自定义模型下的分类。这确保了我们获取的列表是相关且有意义的。
三、动手实践：构建扁平化分类列表
现在，让我们通过一个实际的代码示例，来看看如何使用categoryList标签来构建一个扁平化的所有分类列表。
假设我们希望在网站底部显示所有文章分类的链接，不分层级，列表形式展示。
<div class="footer-categories">
<h3>探索更多分类</h3>
<ul>
{#
使用 categoryList 标签获取所有分类。
- all=true: 告诉系统获取所有分类，忽略层级。
- moduleId="1": 指定我们只获取“文章模型”下的分类 (通常文章模型ID为1，请根据您的实际后台配置调整)。
- categories: 我们将获取到的分类列表命名为 categories，方便后续在for循环中使用。
#}
{% categoryList categories with all=true moduleId="1" %}
{# 遍历获取到的每一个分类项 #}
{% for item in categories %}
<li>
<a href="{{ item.Link }}" title="{{ item.Title }}">
{{ item.Title }}
</a>
</li>
{% endfor %}
{% endcategoryList %}
</ul>
</div>
在这段代码中：
- 我们首先定义了一个
div容器，用于承载我们的扁平化分类列表。 {% categoryList categories with all=true moduleId="1" %}是关键所在。all=true：这是实现扁平化展示的核心。它会让categoryList返回所有分类，无论它们处于哪个层级。moduleId="1"：假设您的文章模型ID是1。如果您想获取产品分类，可能需要将其改为moduleId="2"（具体ID请根据您的安企CMS后台内容模型设置确认）。这个参数确保了我们只获取特定内容模型下的分类，避免了将不相关的分类（如产品分类混入文章分类列表）混杂在一起。
{% for item in categories %}：我们使用一个标准的for循环来遍历categoryList标签返回的每一个分类项。- 在循环内部，
{{ item.Link }}会输出分类的链接地址，{{ item.Title }}则会输出分类的名称。我们特意避免了使用item.Spacer或item.HasChildren这类与层级结构相关的字段，以保持列表的完全扁平化。
通过这样的设置，无论您的分类结构有多么复杂（一级分类、二级分类、三级分类），最终在前端展示出来的都将是一个简洁、不带层级感的分类列表。
四、进阶思考与调整
- 限制显示数量：如果您的分类数量庞大，可能不希望一次性显示所有。您可以添加
limit参数来控制显示的分类数量，例如limit="20"来只显示前20个分类。 - 指定多个内容模型：如果您需要同时显示来自不同内容模型的分类，但依然保持扁平化，
categoryList目前不支持同时指定多个moduleId。您可能需要分别调用categoryList标签，然后将它们的结果合并，或者通过后台更精细地管理需要展示的分类集合。 - 添加简单样式：上述代码仅展示了结构，您可以通过CSS为
.footer-categories下的ul和li添加样式，使其美观大方，例如调整字体大小、间距，或者实现横向排列等。
总结
安企CMS的categoryList标签配合all=true参数，为网站运营者提供了一种极其便捷的方式来构建扁平化的所有分类列表。这种灵活性使得我们能够根据不同的运营需求，轻松调整网站的内容展示策略，无论是为了提升SEO效果，还是改善用户导航体验，都提供了强大的支持。掌握这一技巧，将让您在网站内容运营中更加游刃有余。
常见问题 (FAQ)
Q1: 如果我只希望显示顶级分类，而不是所有分类，应该怎么做？
A1: 如果您只想显示顶级分类，而非所有层级的分类，您需要将all=true参数移除，并确保设置parentId="0"。例如：{% categoryList categories with moduleId="1" parentId="0" %}。这样，系统只会返回没有上级分类的最高层级分类。
Q2: 我能否只获取某个特定内容模型（例如“产品模型”）下的所有分类？
A2: 当然可以。您只需要调整moduleId参数即可。例如，如果您的产品模型ID是2，您可以这样使用：{% categoryList categories with all=true moduleId="2" %}。这样就能确保列表中只包含产品相关的分类。
Q3: 如何对扁平化显示的所有分类进行排序，例如按名称首字母排序？
A3: categoryList标签本身在获取所有分类（all=true）时，文档中并未直接提供order参数来控制返回结果的排序方式。通常，分类的显示顺序会遵循您在AnQiCMS后台设置的分类排序。如果需要更复杂的排序（如按名称首字母），您可能需要考虑在前端通过JavaScript对获取到的列表进行二次排序处理，或者在后台自定义分类列表的查询逻辑（这通常需要模板引擎之外的开发支持）。