在AnQiCMS中,有效管理和展示网站分类是提升用户体验和内容组织性的关键。无论是构建导航菜单、侧边栏内容,还是在特定页面展示分类结构,灵活获取分类的名称、描述、链接及其下级分类列表都是一项常见需求。本篇文章将详细介绍如何利用AnQiCMS的模板标签,轻松实现这些功能。


灵活获取并展示指定分类的信息及子分类列表

网站内容的清晰分类不仅方便用户浏览,也对搜索引擎优化(SEO)大有裨益。AnQiCMS强大的模板系统为我们提供了直观且易用的标签,能够精准地获取和展示所需的分类数据。要实现获取指定分类的详细信息及其下级分类列表,我们主要会用到两个核心模板标签:categoryDetailcategoryList

核心工具:categoryDetailcategoryList

categoryDetail 标签,顾名思义,是用来获取单个指定分类的详细信息。它能帮助我们提取出某个特定分类的标题、描述、链接等各种属性。而 categoryList 标签则专注于获取一组分类的列表,非常适合用来列出某个父分类下的所有子分类,或者特定内容模型下的所有顶级分类。理解并恰当运用这两个标签,是实现我们目标的关键。

获取指定分类的详细信息

首先,我们可能需要获取一个特定分类的基本信息,例如它的名称、描述和链接。这时,categoryDetail 标签是我们的理想选择。它允许我们通过分类的唯一ID(id)或URL别名(token)来精确指定目标分类。

举个例子,如果您网站上有一个ID为 5 的分类,并且您想在页面上显示它的标题、描述和链接,您可以这样编写模板代码:

{# 假设要获取ID为5的分类的详细信息 #}
{% categoryDetail myCategory with id="5" %}
<section class="category-detail-section">
    <h1>分类名称:{{ myCategory.Title }}</h1>
    <p>分类描述:{{ myCategory.Description }}</p>
    <a href="{{ myCategory.Link }}">前往{{ myCategory.Title }}分类页面</a>
</section>

在这段代码中,我们将ID为 5 的分类信息获取并赋值给了 myCategory 变量。随后,我们就可以通过 myCategory.TitlemyCategory.DescriptionmyCategory.Link 等属性来轻松访问并显示分类的名称、描述和链接了。categoryDetail 标签还提供了其他丰富的字段,如 Content(分类的富文本内容)、Logo(分类大图)、Thumb(分类缩略图)等,您可以根据需要灵活调用。

展示指定分类的下级分类列表

获取了指定分类的详细信息后,下一步通常是展示该分类下的所有子分类。这时,categoryList 标签便闪亮登场。categoryList 通过 parentId 参数来指定我们希望获取哪个父分类下的子分类。

继续以上面的例子,如果我们要列出ID为 5 的分类(即 myCategory)的所有直接子分类,可以这样操作:

<section class="sub-categories-list">
    <h2>{{ myCategory.Title }}的子分类</h2>
    <ul>
        {% categoryList subCategories with parentId=myCategory.Id %}
        {% for subItem in subCategories %}
        <li>
            <a href="{{ subItem.Link }}">{{ subItem.Title }}</a>
        </li>
        {% endfor %}
        {% endcategoryList %}
    </ul>
</section>

在这里,categoryList 标签的 `