安企CMS作为一款灵活高效的内容管理系统，在内容展示方面提供了极大的自由度。对于一个网站而言，文章详情页不仅需要展示文章本身的内容，所属分类的名称、链接，乃至其层级关系，都是提升用户体验、优化网站结构和促进SEO的重要组成部分。清晰的分类信息能帮助用户快速理解文章的定位，方便他们进一步浏览相关内容，也能让搜索引擎更好地抓取和理解网站的结构。

接下来，我们将探讨如何在安企CMS的文章详情页中，优雅地实现文章所属分类的名称、链接及其层级关系的显示。

1. 从文章详情直接获取分类信息

在安企CMS中，当您访问一篇文章的详情页时，系统会自动加载与该文章相关联的各种数据，其中就包括了文章所属分类的信息。通过使用archiveDetail标签，我们可以直接获取到当前文章的分类对象，进而提取分类的名称和链接。

archiveDetail标签用于获取文档的详细数据。它不仅能获取文章标题、内容等，还能获取文章的Category对象。这个Category对象包含了分类的ID、名称、链接等关键信息。

以下是实现此功能的模板代码片段：

{% archiveDetail currentArchive with name="Id" %} {# 获取当前文章ID，用于确保在文章详情页上下文 #}
<div class="article-category">
    {# 使用archiveDetail标签，并指定name="Category"来获取分类对象 #}
    {% archiveDetail archiveCategory with name="Category" %}
    所属分类：<a href="{{ archiveCategory.Link }}">{{ archiveCategory.Title }}</a>
    {% endarchiveDetail %}
</div>

在这段代码中：

  • 我们首先通过{% archiveDetail currentArchive with name="Id" %}获取当前文章的ID（这一步主要是为了明确我们处于文章详情页的上下文，实际获取分类时可以直接跳过，因为archiveDetail在文章详情页默认作用于当前文章）。
  • 然后，{% archiveDetail archiveCategory with name="Category" %}将当前文章的分类信息赋值给名为archiveCategory的变量。
  • 接着，我们就可以通过archiveCategory.Link获取分类的链接，以及通过archiveCategory.Title获取分类的名称，并将其展示在页面上。

这种方法非常简洁高效，适用于只需要展示当前文章直接所属分类的名称和链接的场景。

2. 通过分类ID独立获取分类详情

有时候，我们可能需要更灵活地获取某个分类的信息，或者在当前页面上下文不够明确时。这时，我们可以先从文章详情中获取到分类的ID，再利用categoryDetail标签来独立查询该分类的详细信息。

categoryDetail标签允许您根据分类的ID或URL别名来获取分类的详细数据，包括其名称、链接、描述，甚至上级分类的ID等。

以下是模板代码示例：

{% archiveDetail currentArchive with name="CategoryId" %} {# 获取当前文章所属分类的ID #}

<div class="article-category-detailed">
    {# 使用categoryDetail标签，通过CategoryId来获取分类信息 #}
    {% categoryDetail categoryInfo with id=currentArchive %}
    分类名称：<a href="{{ categoryInfo.Link }}">{{ categoryInfo.Title }}</a>
    {% endcategoryDetail %}
</div>

在此示例中：

  • 我们首先使用{% archiveDetail currentArchive with name="CategoryId" %}来获取当前文章所属分类的ID，并将其赋值给currentArchive变量（这里currentArchive实际上存储的是分类ID）。
  • 随后，{% categoryDetail categoryInfo with id=currentArchive %}则利用这个currentArchive（即分类ID）去查询并获取该分类的完整信息，并赋值给categoryInfo变量。
  • 最后，通过categoryInfo.Link和categoryInfo.Title，我们便能展示分类的链接和名称。

这种方法提供了更大的灵活性，尤其当您需要根据分类ID进行进一步操作时。

3. 巧妙运用面包屑导航展示层级关系（推荐）

对于显示文章所属分类的“层级关系”，安企CMS提供了一个专门且非常强大的标签——breadcrumb。面包屑导航天生就是为了展示页面路径的层级结构而设计的，它能够自动解析当前页面的位置，并生成从首页到当前页面（包括所有中间分类）的完整导航路径，每个层级都包含名称和可点击的链接。这是最推荐用于展示层级关系的方法。

breadcrumb标签使用起来非常简单，通常只需将其放置在页面希望显示面包屑导航的位置即可。

<div class="breadcrumb-nav">
    {% breadcrumb crumbs with index="首页" title=true %}
    <ol>
        {% for item in crumbs %}
            <li>
                {% if not forloop.Last %} {# 如果不是最后一个元素，则显示链接 #}
                    <a href="{{ item.Link }}">{{ item.Name }}</a>
                {% else %} {# 否则只显示名称（当前页面） #}
                    {{ item.Name }}
                {% endif %}
            </li>
            {% if not forloop.Last %} / {% endif %} {# 添加分隔符，除了最后一个元素 #}
        {% endfor %}
    </ol>
    {% endbreadcrumb %}
</div>

这段代码：

  • {% breadcrumb crumbs with index="首页" title=true %}会生成一个名为crumbs的数组，其中包含了从“首页”到当前文章的所有层级信息。index="首页"参数定义了起始点为“首页”，title=true则表示面包屑的最后一个元素会显示当前文章的标题。
  • 通过for循环遍历crumbs数组，每个item都包含了Name（链接名称）和Link（链接地址）。
  • forloop.Last是循环中判断是否为最后一个元素的内置变量，常用于控制链接的显示或分隔符的添加。

使用breadcrumb标签是最为便捷和语义化的方式来展示分类层级，它省去了您手动追踪父级分类的复杂逻辑，由系统自动完成。

总结

安企CMS在内容展示的灵活性上表现出色，无论是直接从文章详情获取当前分类的名称和链接，通过分类ID独立查询分类信息，还是利用强大的面包屑导航标签展示完整的层级关系，都提供了直观且高效的实现途径。您可以根据页面设计的具体需求和复杂度，选择最适合您的方式。推荐在多数情况下，优先考虑使用breadcrumb标签来处理分类层级展示，因为它在提供完整信息的同时，也极大地简化了模板的编写。

常见问题 (FAQ)

Q1: 为什么我的分类链接无法点击或显示错误？

A1: 这通常是由于伪静态规则配置不正确或分类未设置URL别名造成的。安企CMS依赖伪静态规则来生成友好的URL，请确保您的网站已正确配置了伪静态，并且文章所属的分类在后台（内容管理 -> 文档分类 -> 编辑分类 -> 其他参数）中，其“自定义URL”字段已填写或自动生成。如果分类ID在伪静态规则中被移除，链接也可能不正确。

Q2: 我想在文章详情页只显示当前分类的“父级分类名称”，不显示完整面包屑，也不显示当前分类本身的名称，该怎么实现？

A2: 您可以通过archiveDetail获取当前文章的CategoryId，然后用categoryDetail结合ParentId属性来获取父级分类的信息。具体步骤是：

  1. 首先，获取当前文章的CategoryId。
  2. 然后，使用categoryDetail标签，传入上一步获取的CategoryId，获取该分类的ParentId。
  3. 如果ParentId不为0，说明存在父级分类。再用categoryDetail标签传入这个ParentId，即可获取父级分类的名称和链接。 示例代码可能看起来像这样：
{% archiveDetail currentCatId with name="CategoryId" %}
{% categoryDetail currentCategory with id=currentCatId %}
    {% if currentCategory.ParentId > 0 %}
        {% categoryDetail parentCategory with id=currentCategory.ParentId %}
            父级分类：<a href="{{ parentCategory.Link }}">{{ parentCategory.Title }}</a>
        {% endcategoryDetail %}
    {% else %}
        无父级分类
    {% endif %}
{% endcategoryDetail %}

Q3: 如何让显示出来的分类名称链接在新窗口中打开？

A3: 您只需在模板代码中，为生成分类链接的<a>标签添加target="_blank"属性即可