如何在`categoryList`中实现“当前分类的兄弟分类”列表显示，而不是子分类？
安企CMS作为一款高效、可定制的内容管理系统，在网站运营中扮演着重要的角色。它的模板系统强大而灵活，允许运营者根据实际需求，精细化地控制内容的展示方式。今天，我们就来深入探讨一个在实际运营中非常常见，但初学者可能感到困惑的问题：如何在categoryList标签中，巧妙地展示“当前分类的兄弟分类”，而非其子分类。
在内容组织和用户体验方面，展示兄弟分类列表具有非常重要的意义。它能帮助用户在浏览某个分类内容时，快速发现同级的其他相关分类，从而促进内容发现、提升网站内部链接的质量，进而优化SEO表现。
深入理解categoryList标签的灵活性
安企CMS的categoryList标签是您在模板中调用分类数据的核心工具。它提供了丰富的参数，让您能够精确地筛选和展示所需的分类信息。通常，我们使用它来：
- 获取顶级分类：通过设置
parentId="0"，您可以轻松列出所有不属于任何父分类的顶级分类。 - 获取指定父分类下的子分类：通过指定一个具体的
parentId="某个分类ID"，您可以获取该ID下所有的直接子分类。 - 获取所有分类：当您需要显示整个分类树时，可以设定
all=true并结合moduleId来获取特定模型下的所有分类。
然而，我们今天要关注的重点是，如何超越这些常见用法，实现对“兄弟分类”的精确获取。
实现“当前分类的兄弟分类”列表：parentId="parent"的奥秘
安企CMS的设计者显然考虑到了这一运营场景，并在categoryList标签中预留了一个非常简洁而强大的参数值：parentId="parent"。
当您在分类详情页（或任何能够识别当前分类上下文的页面）使用categoryList标签时，将parentId参数设置为"parent"，系统便会自动识别当前分类的父级，然后列出与当前分类同属于该父级的所有分类。这正是我们所说的“兄弟分类”。
值得一提的是，这个机制非常智能，它省去了您手动获取当前分类的父ID，再用父ID去查询子分类（并排除当前分类自身）的繁琐步骤。它直接替您完成了这一逻辑。
让我们通过一个具体的例子来演示如何实现：
假设我们正在设计一个名为文章的模型下的分类详情页面（例如，用户正在浏览“产品介绍”这个分类），我们希望在侧边栏显示与“产品介绍”同级的其他分类，比如“公司新闻”、“行业动态”等。
{# 首先，确保我们能获取到当前分类的详细信息。
在分类详情页，通常系统会自动提供当前分类的上下文，
或者我们可以使用 categoryDetail 标签明确获取。 #}
{% categoryDetail currentCategory with name="Id" %}
{# currentCategory 变量现在存储了当前分类的完整数据，包括其ID、父ID等 #}
<div class="sibling-categories">
<h3>同级分类</h3>
<ul>
{# 使用 categoryList 标签，关键是设置 parentId="parent" #}
{# 并且为了确保只显示当前模型下的分类，最好加上 moduleId #}
{% categoryList siblings with moduleId=currentCategory.ModuleId parentId="parent" %}
{% for item in siblings %}
{# 排除当前正在浏览的分类自身 #}
{% if item.Id != currentCategory.Id %}
<li class="{% if item.IsCurrent %}active{% endif %}">
<a href="{{ item.Link }}" title="{{ item.Title }}">{{ item.Title }}</a>
</li>
{% endif %}
{% empty %}
<li>暂无其他同级分类</li>
{% endfor %}
{% endcategoryList %}
</ul>
</div>
在这段代码中：
- 我们首先通过
{% categoryDetail currentCategory with name="Id" %}（这里仅获取ID作为示例，实际currentCategory会包含更多字段）来确保我们拥有当前页面的分类上下文。即使在分类列表页，currentCategory变量也可能由系统自动填充。 - 接着，我们调用
{% categoryList siblings with moduleId=currentCategory.ModuleId parentId="parent" %}。这里的moduleId=currentCategory.ModuleId确保我们只获取与当前分类属于同一内容模型（例如“文章”或“产品”）的兄弟分类，避免混淆。而parentId="parent"则是实现获取兄弟分类的关键指令。 - 在
for循环内部，我们添加了一个{% if item.Id != currentCategory.Id %}的条件判断，目的是将当前用户正在访问的分类从兄弟列表中排除，避免重复显示，从而提供更清晰的导航。 {% empty %}标签则优雅地处理了当没有其他兄弟分类可显示时的情景，提升了用户体验。
通过这样简单的配置，您就能在网站的任何分类页面，动态展示其兄弟分类列表，极大地增强网站的导航能力和用户友好性。
运营小贴士
- 侧边栏导航：将兄弟分类列表放置在分类页面的侧边栏，是引导用户发现更多相关内容的高效方式。
- 面包屑导航的补充：虽然面包屑主要展示层级关系，但兄弟分类列表则提供了横向的拓展，二者相辅相成。
- 内容相关性：兄弟分类通常意味着内容主题的紧密相关性，有助于提升页面之间的关联度，对SEO内部链接结构大有裨益。
安企CMS的模板标签设计旨在简化复杂的逻辑，parentId="parent"的用法正是这一理念的绝佳体现。掌握这一技巧，您的网站运营将更上一层楼，用户也能在您的网站中畅游无阻。
常见问题 (FAQ)
Q1: 如果当前分类是一个顶级分类（即它没有父级），使用parentId="parent"会显示什么？
A1: 当您当前所在的分类本身就是一个顶级分类时，它并没有“父级”概念，自然也就不存在“兄弟分类”了。在这种情况下，parentId="parent"将不会返回任何结果，categoryList循环中的{% empty %}部分将得以执行，您可以设置相应的提示信息，例如“暂无同级分类”或“您当前处于顶级分类”。
Q2: 我能否同时获取兄弟分类和子分类，并将它们显示在同一个区域？
A2: 可以的，但您需要分别调用两次categoryList标签来获取这两种数据。一次使用parentId="parent"获取兄弟分类，另一次则可以省略parentId参数（如果当前页面就是分类页，它会默认获取当前分类的子分类），或者明确指定当前分类的ID来获取其子分类。之后，您可以在模板中将它们合并展示，或者分别放在不同的视觉区域。
Q3: categoryList标签中的moduleId参数在这里是必须的吗？
A3: 虽然在某些页面上下文，系统可能能够智能判断moduleId，但为了代码的健壮性和明确性，强烈建议在使用categoryList获取特定类型的分类（如文章分类、产品分类）时，始终明确指定moduleId参数。这样可以确保即使在复杂的模板结构中，也能准确无误地获取到您期望的分类数据，避免不同内容模型之间的分类混淆。通常，currentCategory对象中会包含ModuleId字段，可以直接引用。