說明：用于獲取文檔的分類詳情

使用方法：{% categoryDetail 變量名稱 with name="字段名稱" id="1" %} 變量名稱不是必須的，設(shè)置了變量名稱后，后續(xù)可以通過變量名稱來調(diào)用，而不設(shè)置變量名稱，則是直接輸出結(jié)果。

categoryDetail 支持的參數(shù)有：

• 分類ID id id 不是必須的，默認(rèn)會獲取當(dāng)前分類。如果需要指定分類，可以通過設(shè)置id來達(dá)到目的。
• 分類URL別名 token token 不是必須的，默認(rèn)會獲取當(dāng)前分類。如果需要指定分類，可以通過設(shè)置id或token來達(dá)到目的。
• 站點ID siteId siteId 一般不需要填寫，如果你使用后臺的多站點管理創(chuàng)建了多個站點，并且想調(diào)用其他站點的數(shù)據(jù)，則可以通過指定 siteId 來實現(xiàn)調(diào)用指定站點的數(shù)據(jù)。

name 參數(shù)可用的字段有：

• 分類ID Id
• 分類標(biāo)題 Title
• 分類鏈接 Link
• 分類描述 Description
• 分類內(nèi)容 Content
• 上級分類ID ParentId
• 分類縮略圖大圖 Logo
• 分類縮略圖 Thumb
• 分類幻燈片組圖 Images
• 分類的文檔數(shù)量 ArchiveCount
• 文檔模型設(shè)置的分類其他字段參數(shù)

分類ID Id

標(biāo)簽用法：{% categoryDetail with name="Id" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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>

分類標(biāo)題 Title

標(biāo)簽用法：{% categoryDetail with name="Title" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<div>分類標(biāo)題：{% categoryDetail with name="Title" %}</div>
{# 獲取指定分類id的分類字段 #}
<div>分類標(biāo)題：{% categoryDetail with name="Title" id="1" %}</div>
{# 自定義字段名稱 #}
<div>分類標(biāo)題：{% categoryDetail categoryTitle with name="Title" %}{{categoryTitle}}</div>
<div>分類標(biāo)題：{% categoryDetail categoryTitle with name="Title" id="1" %}{{categoryTitle}}</div>

分類鏈接 Link

標(biāo)簽用法：{% categoryDetail with name="Link" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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

標(biāo)簽用法：{% categoryDetail with name="Description" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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>

分類內(nèi)容 Content

標(biāo)簽用法：{% categoryDetail with name="Content" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<div>分類內(nèi)容：{% categoryDetail with name="Content" %}</div>
{# 獲取指定分類id的分類字段 #}
<div>分類內(nèi)容：{% categoryDetail with name="Content" id="1" %}</div>
{# 自定義字段名稱 #}
<div>分類內(nèi)容：{% categoryDetail categoryContent with name="Content" %}{{categoryContent|safe}}</div>
<div>分類內(nèi)容：{% categoryDetail categoryContent with name="Content" id="1" %}{{categoryContent|safe}}</div>

Content字段在開啟Markdown編輯器后，會自動對內(nèi)容進(jìn)行Markdown轉(zhuǎn)html操作，關(guān)閉Markdown編輯器編輯器后，Content內(nèi)容不會自動對內(nèi)容進(jìn)行Markdown轉(zhuǎn)html操作。但你可以手動指定是否進(jìn)行轉(zhuǎn)換，需要添加render參數(shù)。接受false|true兩個值。render=false不進(jìn)行Markdown轉(zhuǎn)html操作，render=true進(jìn)行轉(zhuǎn)換。

上級分類ID ParentId

標(biāo)簽用法：{% categoryDetail with name="ParentId" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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>

分類的文檔數(shù)量 ArchiveCount

標(biāo)簽用法：{% categoryDetail with name="ArchiveCount" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<div>分類文檔數(shù)量：{% categoryDetail with name="ArchiveCount" %}</div>
{# 獲取指定分類id的分類字段 #}
<div>分類文檔數(shù)量：{% categoryDetail with name="ArchiveCount" id="1" %}</div>
{# 自定義字段名稱 #}
<div>分類文檔數(shù)量：{% categoryDetail archiveCount with name="ArchiveCount" %}{{archiveCount}}</div>
<div>分類文檔數(shù)量：{% categoryDetail archiveCount with name="ArchiveCount" id="1" %}{{archiveCount}}</div>

文檔模型設(shè)置的分類其他字段參數(shù)

如果你想顯示某個自定義字段的內(nèi)容，如你自定義字段為 author，那么在模板中就可以這樣調(diào)用：

{% categoryDetail with name="author" %}

分類縮略圖大圖 Logo

標(biāo)簽用法：{% categoryDetail with name="Logo" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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

標(biāo)簽用法：{% categoryDetail with name="Thumb" %}

{# 默認(rèn)用法，自動獲取當(dāng)前頁面分類 #}
<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

標(biāo)簽用法：{% 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>