高安全性的内容管理系统
一站式建站解决方案
高性能静态网站构建工具
精美的网站模板库
详细的模板开发指南
完整的API接口说明
直观的视频使用指南
常见问题解答集锦
最新产品动态与行业资讯
了解我们的故事
获取支持与合作
说明:用于获取文档的分类详情
使用方法:{% categoryDetail 变量名称 with name="字段名称" id="1" %} 变量名称不是必须的,设置了变量名称后,后续可以通过变量名称来调用,而不设置变量名称,则是直接输出结果。
{% categoryDetail 变量名称 with name="字段名称" id="1" %}
id
token
siteId
Id
Title
Link
Description
Content
ParentId
Logo
Thumb
Images
ArchiveCount
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="Content" %}
{% categoryDetail with name="Content" %}
Content 字段在开启 Markdown 编辑器后,会自动对内容进行 Markdown 转 html 操作,关闭 Markdown 编辑器编辑器后,Content 内容不会自动对内容进行 Markdown 转 html 操作。但你可以手动指定是否进行转换,需要添加render参数。接受false|true两个值。render=false不进行 Markdown 转 html 操作,render=true进行转换。
render
false|true
render=false
render=true
{# 默认用法,自动获取当前页面分类 #} <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>
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="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,那么在模板中就可以这样调用:
author
{% categoryDetail with name="author" %}
自定义字段参数的使用,例如,你自定义了一个组图的字段,为 catimages,并且想在前端展示它们,可以这么写:
catimages
{% categoryDetail catimages with name="catimages" %} <ul class="category-images"> {% for img in catimages %} <li><img src="{{img}}" /></li> {% endfor %} </ul>
如果你想要将自定义字段全部循环出来,可以这么用:
{% categoryDetail extras with name="Extra" %} {% for field in extras %} <div>{{field.Name}}:{{field.Value}}</div> {% endfor %}
默认它是会循环出所有自定义字段,如果你不想某个自定义字段出现,比如,不希望author、price字段显示在页面上,可以这样用:
price
{% categoryDetail extras with name="Extra" %} {% for field in extras %} {% if field.Name != 'author' and field.Name != 'price' %} <div>{{field.Name}}:{{field.Value}}</div> {% endif %} {% endfor %}
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail with name="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>
标签用法:{% categoryDetail categoryImages with name="Images" %}{% for item in categoryImages %}<img src="{{item}}" alt="{% categoryDetail with name="Title" %}" />{% endfor %}
{% 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>