Category list label

Description: Used to get the list of articles and product categories

Usage:{% categoryList 变量名称 with moduleId="1|2|3" parentId="0" %}If the variable is defined as categories{% categoryList categories with moduleId="1" parentId="0" %}...{% endcategoryList %}

The parameters supported by categoryList are:

Model IDmoduleId moduleIdCan retrieve the classification list of a specified document model such asmoduleId="1"Retrieve the classification list of the article model.
Parent categoryparentId parentIdIndicates the parent category, can retrieve the child categories under the specified parent category,parentId="parent"Represents the parent category of the current category, represents obtaining the sibling categories of the current category.When parentId is "0", get the top-level category.moduleId
Get all categoriesall allCan get the list of all specified categories, such asall=trueGet all categories, if specified at the same timemoduleId, then get all categories under the specified model.
Show quantitylimit limitYou can specify the number of items to display, for examplelimit="10"Then only 10 items will be displayed,limitSupportoffsetmode, which is,delimiter mode, if you want to start from the second item and get 10 items, you can set it tolimit="2,10".
Site IDsiteId siteIdGenerally, it is not necessary to fill in, if you use the multi-site management on the backend to create multiple sites and want to call data from other sites, you can specifysiteIdTo call the data of the specified site.

If you want to get the sub-categories of the current category, you do not need to specifyparentId. If you want to get the sibling categories of the current category, then specifyparentId="parent", only valid when in the document list.

categories is an array object, therefore it needs to useforloop to output

item is the variable within the for loop, the available fields are:

Category IDId
category titleTitle
Category linkLink
Category descriptionDescription
Category contentContent
Parent Category IDParentId
Category Thumbnail LargeLogo
Category ThumbnailThumb
Subcategory PrefixSpacer
Has SubcategoryHasChildren
Is the current linkIsCurrent
Number of documents in the categoryArchiveCount

Code example

{% categoryList categories with moduleId="1" parentId="0" %}
<ul>
    {% for item in categories %}
    <li>
        {#  如需判断当前是否是循环中的第一条，可以这么写： #}
        {% if forloop.Counter == 1 %}这是第一条{% endif %}
        {# 比如需要给第一条添加额外class="active"，可以这么写： #}
        <a class="{% if forloop.Counter == 1 %}active{% endif %}" href="{{item.Link}}">{{item.Title}}</a>

        <a href="{{ item.Link }}">{{item.Spacer|safe}}{{item.Title}}</a>
        <a href="{{ item.Link }}">
            <span>当前第{{ forloop.Counter }}个，剩余{{ forloop.Revcounter}}ge</span>
            <span>分类ID：{{item.Id}}</span>
            <span>分类名称：{{item.Title}}</span>
            <span>分类链接：{{item.Link}}</span>
            <span>分类描述：{{item.Description}}</span>
            <span>分类内容：{{item.Content|safe}}</span>
            <span>上级分类ID：{{item.ParentId}}</span>
            <span>下级分类前缀：{{item.Spacer|safe}}</span>
            <span>是否有下级分类：{{item.HasChildren}}</span>
        </a>
        <div>缩略图大图：<img style="width: 200px" src="{{item.Logo}}" alt="{{item.Title}}" /></div>
        <div>缩略图：<img style="width: 200px" src="{{item.Thumb}}" alt="{{item.Title}}" /></div>
    </li>
    {% endfor %}
</ul>
{% endcategoryList %}

Nested multi-level category calls

{% categoryList categories with moduleId="1" parentId="0" %}
{#一级分类#}
<ul>
    {% for item in categories %}
    <li>
        <a href="{{ item.Link }}">{{item.Title}}</a>
        <div>
            {% categoryList subCategories with parentId=item.Id %}
            {#二级分类#}
            <ul>
                {% for inner1 in subCategories %}
                <li>
                    <a href="{{ inner1.Link }}">{{inner1.Title}}</a>
                    <div>
                        {% categoryList subCategories2 with parentId=inner1.Id %}
                        {#三级分类#}
                        <ul>
                            {% for inner2 in subCategories2 %}
                            <li>
                                <a href="{{ inner2.Link }}">{{inner2.Title}}</a>
                            </li>
                            {% endfor %}
                        </ul>
                        {% endcategoryList %}
                    </div>
                </li>
                {% endfor %}
            </ul>
            {% endcategoryList %}
        </div>
    </li>
    {% endfor %}
</ul>
{% endcategoryList %}

Common usage examples

Displaying documents under categories in a loop. As shown in the figure:

detail-4

Call code example (code does not include css style control)

{% categoryList categories with moduleId="1" parentId="0" %}
<div>
    {% for item in categories %}
    <div>
        <h3><a href="{{ item.Link }}">{{item.Title}}</a></h3>
        <ul>
            {% archiveList archives with type="list" categoryId=item.Id limit="6" %}
            {% for archive in archives %}
            <li>
                <a href="{{archive.Link}}">
                    <h5>{{archive.Title}}</h5>
                    <div>{{archive.Description}}</div>
                    <div>
                        <span>{{stampToDate(archive.CreatedTime, "2006-01-02")}}</span>
                        <span>{{archive.Views}} 阅读</span>
                    </div>
                </a>
                {% if archive.Thumb %}
                <a href="{{archive.Link}}">
                    <img alt="{{archive.Title}}" src="{{archive.Thumb}}">
                </a>
                {% endif %}
            </li>
            {% empty %}
            <li>
                该列表没有任何内容
            </li>
            {% endfor %}
        {% endarchiveList %}
        </ul>
    </div>
    {% endfor %}
</div>
{% endcategoryList %}

Display the subcategories of the category in a loop, and if there are no subcategories, display the category's document. As shown in the figure:

detail-5