分类列表标签 - 安企CMS(AnqiCMS)

说明：用于获取文章、产品分类列表

使用方法：{% categoryList 变量名称 with moduleId="1|2|3" parentId="0" %} 如将变量定义为 categories {% categoryList categories with moduleId="1" parentId="0" %}...{% endcategoryList %}

categoryList 支持的参数有：

模型ID moduleId
moduleId 可以获取指定文档模型的分类列表如 moduleId="1" 获取文章模型的分类列表。
上级分类 parentId
parentId 表示上级分类，可以获取指定上级分类下的子分类，parentId="parent" 表示上级分类为当前分类的上级分类，表示获取当前分类的兄弟分类。parentId="0"的时候，获取顶级分类。当要获取顶级分类的时候，必须指定模型ID moduleId
获取全部分类 all
all 可以获取指定所有分类列表，如 all=true 获取所有分类，如果同时指定了moduleId，则获取指定模型下的所有分类。
显示数量 limit
limit 可以指定显示数量，比如limit="10"则只会显示10条，limit 支持offset模式，也就是 ,分隔模式，如想从第2条开始，获取10条数据，可以设置成 limit="2,10"。
站点ID siteId
siteId 一般不需要填写，如果你使用后台的多站点管理创建了多个站点，并且想调用其他站点的数据，则可以通过指定 siteId 来实现调用指定站点的数据。

如果想获取当前分类的下级分类，则不需要指定 parentId。如果想获取当前分类的兄弟分类，则指定 parentId="parent"，仅当在文档列表的时候有效。

categories 是一个数组对象，因此需要使用 for 循环来输出

item 为for循环体内的变量，可用的字段有：

分类ID Id
分类标题 Title
分类链接 Link
分类描述 Description
分类内容 Content
上级分类ID ParentId
分类缩略图大图 Logo
分类缩略图 Thumb
下级分类前缀 Spacer
是否有下级分类 HasChildren
是否当前链接 IsCurrent
分类的文档数量 ArchiveCount

代码示例

{% 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 %}

多级分类嵌套调用

{% 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 %}

常见使用实例

在循环多个分类中显示分类下的文档。如图：

调用代码示例（代码不包含css样式控制）

{% 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 %}

在循环多个分类中显示分类的下级分类，如果没有下级分类，则显示分类的文档。如图：

调用代码示例（代码不包含css样式控制）

<div>
    {% categoryList productCategories with moduleId="2" parentId="0" %}
    {% for item in productCategories %}
    <a href="{{item.Link}}">{{item.Title}}</a>
    <ul class="ind-pro-nav-ul">
        {% if item.HasChildren %}
            {% categoryList subCategories with parentId=item.Id %}
            {% for inner in subCategories %}
            <li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
            {% endfor %}
            {% endcategoryList %}
        {% else %}
            {% archiveList products with type="list" categoryId=item.Id limit="8" %}
            {% for inner in products %}
            <li><a href="{{inner.Link}}" title="">{{inner.Title}}</a></li>
            {% endfor %}
            {% endarchiveList %}
        {% endif %}
    </ul>
    {% endfor %}
    {% endcategoryList %}
</div>