如何通过分类ID或分类别名(token),精确调用指定分类的详细信息?

📅 👁️ 71

作为一名资深的网站运营专家,我深知在管理网站内容时,能够精确、灵活地调用数据是提升运营效率和网站性能的关键。安企CMS(AnQiCMS)凭借其强大的模板标签系统,为我们提供了诸多便利,尤其是在调用分类详细信息方面,无论是通过分类ID还是分类别名(token),都能实现精准操作。

今天,我们就来深入探讨如何在安企CMS中,通过这两种方式,获取并展示指定分类的详细信息。

了解安企CMS中的分类及其标识

在安企CMS中,内容分类是网站内容组织的核心骨架。无论是文章、产品还是其他自定义内容模型,都需要归属于特定的分类。每个分类都拥有一些独特的标识符,以便系统和模板能够准确识别和调用:

  1. 分类ID (ID):这是一个系统内部自动生成的唯一数字标识符。它是分类最直接、最稳定的身份证明,通常在后台管理界面或数据库中可见。
  2. 分类别名 (Token):为了更好地支持搜索引擎优化(SEO)和提升URL的可读性,安企CMS允许我们为分类设置一个唯一的英文别名。这个别名会出现在URL中(如果伪静态规则配置得当),例如/category/news中的news就是别名。它更具语义化,对用户和搜索引擎都更加友好。

在内容运营的实践中,我们常常需要根据特定的分类ID或别名,来展示该分类的标题、描述、链接,甚至它所包含的文档数量或自定义字段。这时,安企CMS提供的categoryDetail模板标签便成为了我们的得力助手。

核心利器:categoryDetail 模板标签

categoryDetail 标签是安企CMS中用于获取单个分类详细信息的专用标签。它允许我们通过分类的ID或别名,精确地指定要获取哪个分类的哪一项具体信息。

它的基本使用方法是这样的: {% categoryDetail 变量名称 with name="字段名称" id="分类ID" token="分类别名" %}

让我们拆解一下这个标签的各个部分:

  • 变量名称:这是一个可选参数。如果你希望将获取到的分类信息赋值给一个变量,以便后续在模板中多次使用或进行逻辑判断,就可以在这里定义一个变量名。如果不定义,标签会直接输出结果。
  • name="字段名称":这是最关键的部分,它指定了你想要获取分类的哪个具体字段。例如,name="Title"会获取分类的标题,name="Description"会获取分类的描述。
  • id="分类ID":通过分类的数字ID来指定目标分类。例如,id="5"表示获取ID为5的分类信息。
  • token="分类别名":通过分类的别名(英文token)来指定目标分类。例如,token="products"表示获取别名为products的分类信息。
  • siteId="站点ID":如果你开启了多站点功能,并且希望调用其他站点的数据,可以通过这个参数指定站点ID。通常情况下,这个参数不需要填写,系统会默认调用当前站点的数据。

name 参数可调用的分类字段一览:

安企CMS的categoryDetail标签支持调用分类的丰富信息,常用的包括:

  • Id: 分类的唯一数字ID。
  • Title: 分类的名称或标题。
  • Link: 分类的URL链接。
  • Description: 分类的简短描述,常用于SEO。
  • Content: 分类的详细内容,可以包含HTML。
  • ParentId: 上级分类的ID,用于构建层级关系。
  • Logo: 分类的封面大图地址。
  • Thumb: 分类的缩略图地址。
  • Images: 分类的Banner图组(通常是一个图片数组)。
  • ArchiveCount: 该分类下的文档(内容)数量。
  • 后台自定义字段名称: 如果你在后台为分类模型添加了自定义字段,可以直接通过name="你的自定义字段名"来调用其值。

实战演练:精准调用各类信息

下面,我们通过一些具体的代码示例,来看看如何灵活运用categoryDetail标签。

场景一:在非分类页面调用特定分类的标题和链接

假设你正在首页或某个文章详情页,需要展示“产品分类”这个特定分类的标题,并为其生成一个链接。我们知道“产品分类”的ID是 2,别名是 products

通过ID调用:

{% set productCategoryTitle = "" %}
{% categoryDetail productCategoryTitle with name="Title" id="2" %}{# 将ID为2的分类标题赋值给productCategoryTitle变量 #}

{% set productCategoryLink = "" %}
{% categoryDetail productCategoryLink with name="Link" id="2" %}{# 将ID为2的分类链接赋值给productCategoryLink变量 #}

<p>前往 <a href="{{ productCategoryLink }}">{{ productCategoryTitle }}</a> 页面。</p>

或者,如果你不需要赋值给变量,直接输出:

<p>前往 <a href="{% categoryDetail with name='Link' id='2' %}">{% categoryDetail with name='Title' id='2' %}</a> 页面。</p>

通过别名(token)调用:

{% set productCategoryTitleByToken = "" %}
{% categoryDetail productCategoryTitleByToken with name="Title" token="products" %}

{% set productCategoryLinkByToken = "" %}
{% categoryDetail productCategoryLinkByToken with name="Link" token="products" %}

<p>探索我们的 <a href="{{ productCategoryLinkByToken }}">{{ productCategoryTitleByToken }}</a>。</p>

场景二:获取分类的描述信息,用于SEO元标签

假设我们需要在自定义的_header.html模板中,根据当前页面分类的别名(假设为news)来获取其描述信息,填充到<meta name="description">中。

”`twig <meta name=“description” content=“{% categoryDetail with name=“Description

相关文章

安企CMS中,“分类详情标签”的主要用途和应用场景是什么?

作为一位资深的网站运营专家,我深知在内容管理系统中,如何灵活、高效地展示信息是网站成功的关键。安企CMS(AnQiCMS)凭借其强大的功能,在这方面提供了诸多便利。今天,我们就来深入探讨安企CMS中一个非常实用且功能强大的模板标签——**分类详情标签(`categoryDetail`)**,看看它如何在内容运营中发挥核心作用。 安企CMS的设计理念,就是为用户提供一个高度可定制

2025-11-06

AnQiCMS留言验证码在低带宽网络环境下加载速度如何,是否可优化?

作为一名资深的网站运营专家,我深知在日益复杂的网络环境中,用户体验与网站安全之间如何取得平衡至关重要。安企CMS(AnQiCMS)凭借其基于Go语言的高性能架构,在内容管理领域赢得了不少用户的青睐。今天,我们就来深入探讨一个在实际运营中经常被提及的问题:“AnQiCMS留言验证码在低带宽网络环境下加载速度如何,是否可优化?” ### 揭秘安企CMS留言验证码

2025-11-06

AnQiCMS的验证码字段`name="captcha"`在提交时会如何被后端程序处理?

作为一位资深的网站运营专家,我非常了解在内容管理系统中,每一个看似微小的字段都承载着重要的功能和安全责任。安企CMS(AnQiCMS)作为一个以Go语言为核心、注重高效与安全的系统,其验证码机制的设计自然也体现了这一理念。今天,我们就来深入探讨一下AnQiCMS中`name="captcha"`这个字段在表单提交时,后端程序是如何巧妙地对其进行处理的。 ###

2025-11-06

使用AnQiCMS内置的留言验证码后,是否还需要考虑集成第三方反垃圾评论服务?

作为一位资深的网站运营专家,我深知在日益复杂的网络环境中,如何高效地管理网站内容并确保其安全性是核心挑战之一。安企CMS(AnQiCMS)以其轻量高效、安全易用的特性,为我们的内容管理工作提供了坚实的基础。在日常运营中,我们经常会遇到一个关于用户互动质量的重要问题:留言评论中的垃圾信息。AnQiCMS为此提供了内置的留言验证码功能,但这是否意味着我们可以对垃圾评论高枕无忧

2025-11-06

获取当前页面的分类标题、分类链接和分类描述的标签语法是什么?

作为一位资深的网站运营专家,我深知在安企CMS(AnQiCMS)这样高效的内容管理系统中,灵活调用页面数据对于构建用户友好且SEO友好的网站至关重要。今天,我们将聚焦一个常见而核心的需求:如何在安企CMS模板中,精准地获取当前页面的分类标题、分类链接和分类描述。 ### 安企CMS模板秘籍:轻松获取当前页面分类标题、链接与描述 在安企CMS的强大世界里

2025-11-06

分类详情标签能否显示分类的完整内容(Content)?如何操作才能确保正确渲染?

作为一名资深的网站运营专家,我深知在内容管理系统中,如何灵活且准确地展示内容是运营成功的关键。今天,我们就来深入探讨安企CMS(AnQiCMS)中一个常见但又容易让人困惑的问题:“分类详情标签能否显示分类的完整内容(Content)?以及如何操作才能确保正确渲染?” ### 分类详情标签与分类内容的展示能力 答案是肯定的,安企CMS

2025-11-06

Markdown格式的分类内容,如何通过分类详情标签自动渲染为HTML格式?

在 AnQiCMS 网站运营的日常工作中,内容创作者常常需要在创作效率和最终呈现效果之间寻找**平衡。Markdown 格式凭借其简洁、直观的语法,无疑成为了许多内容编辑者的首选工具。那么,如何在 AnQiCMS 这款强大的内容管理系统中,将那些以 Markdown 撰写的分类内容,优雅而高效地自动渲染为浏览器可识别的 HTML 格式呢?今天,我们就来深入探讨这一既实用又高效的策略

2025-11-06

如何获取分类的SEO标题、关键词和描述,以优化分类页面的搜索引擎收录?

在网站运营的广阔天地中,分类页面如同导航的灯塔,引导用户找到他们感兴趣的内容,同时也向搜索引擎展示网站内容的组织结构和深度。一个优化得当的分类页面,不仅能显著提升用户体验,更是获取搜索引擎青睐、赢得自然流量的关键。作为一位资深的网站运营专家,我深知在安企CMS(AnQiCMS)这样功能强大的内容管理系统中,如何精确地获取并优化分类的SEO标题、关键词和描述,对提升分类页面的搜索引擎收录至关重要

2025-11-06