作为一位资深的网站运营专家，我深知内容管理系统（CMS）的灵活性对于高效运营至关重要。安企CMS（AnQiCMS）以其强大的内容模型功能，在这方面表现尤为出色。今天，我们就来深入探讨一个常见的需求：如何利用 categoryList 标签，精准地只显示特定内容模型（例如文章或产品）下的分类。

在安企CMS中，每个内容都有其归属的模型，例如您网站上的新闻稿件可能属于“文章模型”，而待售商品则会归类到“产品模型”。这种设计让内容管理变得井然有序。而 categoryList 标签，正是您在前端模板中调取和展示这些分类信息的强大工具。

理解安企CMS的内容模型与分类关联

在安企CMS中，内容模型就好比是您网站上不同类型内容的蓝图。它定义了特定类型内容（如文章、产品、新闻、案例等）应该包含哪些字段、如何组织和展示。例如，“文章模型”可能有标题、作者、发布日期等字段，而“产品模型”则可能包含产品名称、价格、库存、图片集等字段。

每个分类都紧密关联着一个特定的内容模型。这意味着，当您创建一个分类时，您需要指定它属于哪个内容模型。这个设计逻辑确保了分类内容的专一性，例如“公司新闻”分类必然属于“文章模型”，“手机配件”分类则属于“产品模型”。

正是这种模型与分类的紧密绑定关系，使得我们能够通过内容模型的标识（即 moduleId），来精确筛选出我们想要的分类列表。

categoryList 标签的核心作用与 moduleId 的妙用

categoryList 标签是安企CMS模板中用于获取分类列表的关键工具。它提供了多种参数来帮助您灵活地控制所显示的分类，而其中最核心、最能满足我们今天讨论需求的参数，就是 moduleId。

moduleId 参数允许您指定您希望获取分类列表的内容模型ID。在安企CMS的后台，每个内容模型都有一个唯一的数字ID。通常情况下，“文章模型”的 moduleId 默认为 1，而“产品模型”的 moduleId 默认为 2。如果您创建了自定义内容模型，它们也会有相应的ID。您可以在后台的“内容管理” -> “内容模型”中查看每个模型的ID。

通过在 categoryList 标签中设置 moduleId 参数，您可以轻松地过滤出只属于特定内容模型的分类，避免将不同类型的分类混杂在一起，从而使您的网站结构更加清晰，内容展示更加精准。

实战演练：一步步构建特定模型的分类列表

现在，让我们通过具体的模板代码示例，来学习如何运用 moduleId 参数。

示例一：获取文章模型下的所有顶级分类

假设您希望在网站的导航栏或某个侧边栏中，只显示所有关于文章的顶级分类（例如“公司新闻”、“行业动态”等），并且这些分类都属于“文章模型”。

您可以使用如下代码：

{% categoryList categories with moduleId="1" parentId="0" %}
    <ul>
        {% for item in categories %}
            <li>
                <a href="{{ item.Link }}">{{ item.Title }}</a>
                {# 这里可以根据需要，进一步展示子分类或该分类下的文档数量等信息 #}
                <span>({{ item.ArchiveCount }}篇文章)</span>
            </li>
        {% else %}
            <li>暂无文章分类。</li>
        {% endfor %}
    </ul>
{% endcategoryList %}

在这段代码中：

  • moduleId="1" 明确告诉 categoryList 标签，我们只关心ID为1的内容模型（即文章模型）下的分类。
  • parentId="0" 则表示我们只想获取这些文章分类中的顶级分类。

示例二：获取产品模型下的二级分类

如果您想在一个产品分类页面中，显示当前分类下的所有二级子分类，并且这些分类都属于“产品模型”，您可以这样操作：

{# 假设当前页面已经识别出所属的产品分类，我们想显示其下的子分类 #}
{# 首先，获取当前页面的分类ID，通常页面上下文会自动提供，这里假设为 currentCategoryId #}
{# 或者，如果您在产品列表页，可以直接使用 item.Id 来获取当前遍历的分类ID #}

{% categoryList subCategories with moduleId="2" parentId=currentCategoryId %}
    <div class="product-sub-categories">
        <h3>当前分类的子分类：</h3>
        <ul>
            {% for subItem in subCategories %}
                <li>
                    <a href="{{ subItem.Link }}">{{ subItem.Title }}</a>
                    <span> (包含{{ subItem.ArchiveCount }}款产品)</span>
                </li>
            {% else %}
                <li>当前产品分类下暂无子分类。</li>
            {% endfor %}
        </ul>
    </div>
{% endcategoryList %}

这里：

  • moduleId="2" 确保我们获取的分类是专属于产品模型的。
  • parentId=currentCategoryId 则动态地获取当前页面的分类ID，并显示其直接子分类。currentCategoryId 应该替换为实际的当前分类ID变量，在列表页中通常可以直接使用 item.Id。

不仅仅是列表：分类信息的丰富展示

一旦您通过 moduleId 成功筛选出了所需的分类列表，您就可以在循环中使用 item 对象的各种属性来丰富分类信息的展示，例如：

  • {{ item.Title }}：显示分类名称。
  • {{ item.Link }}：生成分类详情页的链接。
  • {{ item.Description }}：展示分类的简介。
  • {{ item.Logo }} 或 {{ item.Thumb }}：显示分类的封面大图或缩略图，适用于有图片需求的分类。
  • {{ item.ArchiveCount }}：显示该分类下有多少篇文档（文章、产品等）。
  • {{ item.HasChildren }}：判断当前分类是否有子分类，以便进行条件渲染。

这些属性的灵活运用，能够让您的分类列表不仅功能强大，而且界面美观、信息丰富，极大地提升用户体验。

总结

安企CMS的 categoryList 标签结合 moduleId 参数，为网站运营者提供了极高的灵活性，使得内容的分类展示可以根据不同的业务需求和内容模型进行精准控制。这不仅让您的网站结构更加清晰，也大大简化了模板开发的复杂性，提升了内容管理的效率。掌握这一技巧，您就能更自如地构建功能强大、条理分明的网站内容架构，从而更好地服务于您的用户和业务目标。

常见问题 (FAQ)

1. 我如何确定我的“文章模型”或“产品模型”对应的 moduleId 具体是多少？

通常情况下，安企CMS内置的“文章模型”的 moduleId 是 1，而“产品模型”的 moduleId 是 2。如果您想确认或查看自定义模型的ID，可以登录安企CMS后台，进入“内容管理” -> “内容模型”页面。每个内容模型都会在其名称旁边或详情页面的URL中显示其ID。

2. parentId 参数在 categoryList 中有什么作用？如果我想显示所有分类，应该怎么设置？

parentId 参数用于指定获取特定父分类下的子分类。当 parentId="0" 时，它会获取所有顶级分类。如果您想获取某个特定分类的所有子分类，可以将 parentId 设置为该父分类的ID。如果您想显示所有模型下，不论层级的分类，您可以使用 all=true 参数，例如 {% categoryList categories with moduleId="1" all=true %}。但请注意，all=true 会返回所有层级的分类，可能需要您在模板中自行处理层级展示逻辑。

3. 我能否在一个 categoryList 标签中，同时显示来自“文章模型”和“产品模型”的分类？

不行，moduleId 参数是针对单一内容模型进行筛选的。一个 categoryList 标签只能指定一个 moduleId。如果您确实需要在同一个列表中展示来自不同内容模型的分类，您需要分别使用两个（或更多） categoryList 标签，各自指定不同的 moduleId，然后将它们的结果手动合并或在前端通过JavaScript进行处理。例如，您可以先获取文章分类列表，再获取产品分类列表，然后在模板中将它们分别渲染或组合起来。