在AnQiCMS中,有效管理和展示网站分类是提升用户体验和内容组织性的关键。无论是构建导航菜单、侧边栏内容,还是在特定页面展示分类结构,灵活获取分类的名称、描述、链接及其下级分类列表都是一项常见需求。本篇文章将详细介绍如何利用AnQiCMS的模板标签,轻松实现这些功能。
灵活获取并展示指定分类的信息及子分类列表
网站内容的清晰分类不仅方便用户浏览,也对搜索引擎优化(SEO)大有裨益。AnQiCMS强大的模板系统为我们提供了直观且易用的标签,能够精准地获取和展示所需的分类数据。要实现获取指定分类的详细信息及其下级分类列表,我们主要会用到两个核心模板标签:categoryDetail 和 categoryList。
核心工具:categoryDetail 与 categoryList
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.Title、myCategory.Description 和 myCategory.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 标签的 `