分类详情标签

说明:用于获取文档的分类详情

使用方法:{% categoryDetail with name="变量名称" id="1" %} 变量名称不是必须的,设置了变量名称后,后续可以通过变量名称来调用,而不设置变量名称,则是直接输出结果。

categoryDetail 支持的参数有:

  • 分类ID id
    id 不是必须的,默认会获取当前分类。如果需要指定分类,可以通过设置id来达到目的。
  • 分类URL别名 token
    token 不是必须的,默认会获取当前分类。如果需要指定分类,可以通过设置id或token来达到目的。
  • 站点ID siteId
    siteId 一般不需要填写,如果你使用后台的多站点管理创建了多个站点,并且想调用其他站点的数据,则可以通过指定 siteId 来实现调用指定站点的数据。

name 参数可用的字段有:

  • 分类ID Id
  • 分类标题 Title
  • 分类链接 Link
  • 分类描述 Description
  • 分类内容 Content
  • 上级分类ID ParentId
  • 分类缩略图大图 Logo
  • 分类缩略图 Thumb
  • 分类幻灯片组图 Images

分类ID Id

标签用法:{% categoryDetail with name="Id" %}

{# 默认用法,自动获取当前页面分类 #}
<div>分类ID:{% categoryDetail with name="Id" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类ID:{% categoryDetail with name="Id" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类ID:{% categoryDetail categoryId with name="Id" %}{{categoryId}}</div>
<div>分类ID:{% categoryDetail categoryId with name="Id" id="1" %}{{categoryId}}</div>

分类标题 Title

标签用法:{% categoryDetail with name="Title" %}

{# 默认用法,自动获取当前页面分类 #}
<div>分类标题:{% categoryDetail with name="Title" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类标题:{% categoryDetail with name="Title" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类标题:{% categoryDetail categoryTitle with name="Title" %}{{categoryTitle}}</div>
<div>分类标题:{% categoryDetail categoryTitle with name="Title" id="1" %}{{categoryTitle}}</div>

分类链接 Link

标签用法:{% categoryDetail with name="Link" %}

{# 默认用法,自动获取当前页面分类 #}
<div>分类链接:{% categoryDetail with name="Link" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类链接:{% categoryDetail with name="Link" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类链接:{% categoryDetail categoryLink with name="Link" %}{{categoryLink}}</div>
<div>分类链接:{% categoryDetail categoryLink with name="Link" id="1" %}{{categoryLink}}</div>

分类描述 Description

标签用法:{% categoryDetail with name="Description" %}

{# 默认用法,自动获取当前页面分类 #}
<div>分类描述:{% categoryDetail with name="Description" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类描述:{% categoryDetail with name="Description" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类描述:{% categoryDetail categoryDescription with name="Description" %}{{categoryDescription}}</div>
<div>分类描述:{% categoryDetail categoryDescription with name="Description" id="1" %}{{categoryDescription}}</div>

分类内容 Content

标签用法:{% categoryDetail with name="Content" %}

{# 默认用法,自动获取当前页面分类 #}
<div>分类内容:{% categoryDetail with name="Content" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类内容:{% categoryDetail with name="Content" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类内容:{% categoryDetail categoryContent with name="Content" %}{{categoryContent|safe}}</div>
<div>分类内容:{% categoryDetail categoryContent with name="Content" id="1" %}{{categoryContent|safe}}</div>

上级分类ID ParentId

标签用法:{% categoryDetail with name="ParentId" %}

{# 默认用法,自动获取当前页面分类 #}
<div>上级分类ID:{% categoryDetail with name="ParentId" %}</div>
{# 获取指定分类id的分类字段 #}
<div>上级分类ID:{% categoryDetail with name="ParentId" id="1" %}</div>
{# 自定义字段名称 #}
<div>上级分类ID:{% categoryDetail categoryParentId with name="ParentId" %}{{categoryParentId}}</div>
<div>上级分类ID:{% categoryDetail categoryParentId with name="ParentId" id="1" %}{{categoryParentId}}</div>

分类缩略图大图 Logo

标签用法:{% categoryDetail with name="Logo" %}

{# 默认用法,自动获取当前页面分类 #}
<div>缩略图大图:<img style="width: 200px" src="{% categoryDetail with name="Logo" %}" alt="{% categoryDetail with name="Title" %}" /></div>
{# 获取指定分类id的分类字段 #}
<div>缩略图大图:<img style="width: 200px" src="{% categoryDetail with name="Logo" id="1" %}" alt="{% categoryDetail with name="Title" id="1" %}" /></div>
{# 自定义字段名称 #}
<div>缩略图大图:{% categoryDetail categoryLogo with name="Logo" %}<img style="width: 200px" src="{{categoryLogo}}" alt="{% categoryDetail with name="Title" %}" /></div>
<div>缩略图大图:{% categoryDetail categoryLogo with name="Logo" id="1" %}<img style="width: 200px" src="{{categoryLogo}}" alt="{% categoryDetail with name="Title" %}" /></div>

分类缩略图 Thumb

标签用法:{% categoryDetail with name="Thumb" %}

{# 默认用法,自动获取当前页面分类 #}
<div>缩略图大图:<img style="width: 200px" src="{% categoryDetail with name="Thumb" %}" alt="{% categoryDetail with name="Title" %}" /></div>
{# 获取指定分类id的分类字段 #}
<div>缩略图大图:<img style="width: 200px" src="{% categoryDetail with name="Thumb" id="1" %}" alt="{% categoryDetail with name="Title" id="1" %}" /></div>
{# 自定义字段名称 #}
<div>缩略图大图:{% categoryDetail categoryThumb with name="Thumb" %}<img style="width: 200px" src="{{categoryThumb}}" alt="{% categoryDetail with name="Title" %}" /></div>
<div>缩略图大图:{% categoryDetail categoryThumb with name="Thumb" id="1" %}<img style="width: 200px" src="{{categoryThumb}}" alt="{% categoryDetail with name="Title" %}" /></div>

分类幻灯片组图 Images

标签用法:{% categoryDetail categoryImages with name="Images" %}{% for item in categoryImages %}<img src="{{item}}" alt="{% categoryDetail with name="Title" %}" />{% endfor %}

{% categoryDetail categoryImages with name="Images" %}
<ul>
{% for item in categoryImages %}
  <li>
    <img src="{{item}}" alt="{% categoryDetail with name="Title" %}" />
  </li>
{% endfor %}
</ul>

上面的代码将会展示多张幻灯片。
如果你只需要第一张图,并判断图片是否存在,可以使用以下的方法:

{% categoryDetail bannerImages with name="Images" %}
{% if bannerImages %}
{% set pageBanner = bannerImages[0] %}
{% endif %}
<img src="{{pageBanner}}" />

如果想把它作为背景图,可以这样:

{% categoryDetail bannerImages with name="Images" %}
{% if bannerImages %}
{% set pageBanner = bannerImages[0] %}
{% endif %}
<div class="page-banner" style="background: url({{pageBanner}}) no-repeat;">
</div>