分类详情标签

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

使用方法：{% 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
• 分类的文档数量 ArchiveCount
• 文档模型设置的分类其他字段参数

分类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>

Content字段在开启Markdown编辑器后，会自动对内容进行Markdown转html操作，关闭Markdown编辑器编辑器后，Content内容不会自动对内容进行Markdown转html操作。但你可以手动指定是否进行转换，需要添加render参数。接受false|true两个值。render=false不进行Markdown转html操作，render=true进行转换。

上级分类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>

分类的文档数量 ArchiveCount

标签用法：{% categoryDetail with name="ArchiveCount" %}

{# 默认用法，自动获取当前页面分类 #}
<div>分类文档数量：{% categoryDetail with name="ArchiveCount" %}</div>
{# 获取指定分类id的分类字段 #}
<div>分类文档数量：{% categoryDetail with name="ArchiveCount" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类文档数量：{% categoryDetail archiveCount with name="ArchiveCount" %}{{archiveCount}}</div>
<div>分类文档数量：{% categoryDetail archiveCount with name="ArchiveCount" id="1" %}{{archiveCount}}</div>

文档模型设置的分类其他字段参数

如果你想显示某个自定义字段的内容，如你自定义字段为 author，那么在模板中就可以这样调用：

{% categoryDetail with name="author" %}

分类缩略图大图 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>