如何获取并循环显示文章或产品的列表？

在AnQiCMS中构建一个充满活力的网站，内容列表的展示是不可或缺的一环。无论是展示最新发布的文章、热门产品，还是特定分类下的内容，AnQiCMS强大的模板引擎都能帮助我们轻松实现。本文将深入探讨如何在AnQiCMS中获取并循环显示文章或产品的列表，助您灵活构建多样化的内容展示页面。

认识AnQiCMS的内容列表机制

AnQiCMS采用了类似Django的模板引擎语法，让内容展示变得直观且易于掌握。在AnQiCMS中，文章和产品都被视为内容的一种，它们共同使用一套灵活的内容模型体系。这意味着我们可以用统一的方式来获取和展示不同类型的内容列表。

核心的模板标签是我们操作内容的入口，它们通常以{% tag %}的形式出现，而要输出的变量则用{{ variable }}包裹。对于循环展示内容，for循环标签是我们的得力助手。

获取文章或产品列表：核心标签archiveList

要获取文章或产品的列表，archiveList标签是您的首选。这个标签非常灵活，能够根据您的需求筛选、排序和限制内容。

使用archiveList标签时，通常会指定一个变量名来存储获取到的内容列表，例如archives或products。基本的结构如下：

{% archiveList archives with moduleId="1" limit="5" %}
    {% for item in archives %}
        {# 在这里展示每个内容项的详细信息 #}
    {% endfor %}
{% endarchiveList %}

接下来，我们详细了解archiveList的一些常用参数，它们是定制内容列表的关键：

1. moduleId：指定内容模型 AnQiCMS支持自定义内容模型，常见的有文章模型（通常moduleId="1"）和产品模型（通常moduleId="2"）。通过这个参数，您可以明确指定要获取哪种类型的内容。

   • 例如，获取文章列表：moduleId="1"
   • 例如，获取产品列表：moduleId="2"

2. categoryId：筛选特定分类 如果您只想显示某个或某些特定分类下的内容，可以使用categoryId。您可以传入单个分类的ID，也可以用逗号分隔传入多个ID。

   • 例如，获取分类ID为10的文章：categoryId="10"
   • 例如，获取分类ID为10、12、15的产品：categoryId="10,12,15"
   • 如果您希望它不自动读取当前页面分类的ID，而是获取全站内容，可以设置为categoryId="0"。

3. limit：控制显示数量或分页范围 limit参数用于限制显示的内容数量。它有两种工作模式：

   • 限制数量：limit="5" 将只显示前5条内容。
   • 偏移模式：limit="2,10" 将从第2条内容开始，获取接下来的10条内容（常用于“从…开始显示”的场景）。

4. order：指定排序方式 内容的显示顺序非常重要。order参数允许您根据多种条件进行排序：

   • id desc：按内容ID倒序排列（最新发布的内容在前）。
   • views desc：按浏览量倒序排列（热门内容在前）。
   • sort desc：按后台设置的自定义排序字段倒序排列。

5. type：列表类型决定功能 type参数定义了列表的用途，这会影响到其他参数的生效方式：

   • type="list"：默认模式，只显示limit指定数量的内容，不带分页。
   • type="page"：分页模式，结合pagination标签可以实现完整的翻页功能。
   • type="related"：相关内容模式，通常用于详情页，自动查找与当前内容相关的其他内容。

6. flag：筛选推荐属性 在后台发布内容时，可以为内容设置多种推荐属性（如头条[h]、推荐[c]、幻灯[f]等）。通过flag参数，您可以只显示具有特定属性的内容。

   • 例如，只显示“推荐”属性的文章：flag="c"
   • 您也可以使用excludeFlag来排除特定属性的内容。

7. q：搜索关键词 当type="page"时，q参数可以用于搜索内容标题中包含特定关键词的内容。如果您在URL中包含?q=关键词的参数，AnQiCMS也会自动读取并应用搜索。

循环遍历与数据访问

一旦使用archiveList获取到内容列表，您就可以通过{% for item in archives %}这样的结构来逐一访问列表中的每个内容项。在循环内部，item就是当前的内容对象，您可以访问它的各种属性，例如：

• {{ item.Id }}：内容ID
• {{ item.Title }}：内容标题
• {{ item.Link }}：内容链接
• {{ item.Description }}：内容摘要/描述
• {{ item.Thumb }}：内容缩略图
• {{ item.Logo }}：内容封面大图
• {{ item.Views }}：内容浏览量
• {{ stampToDate(item.CreatedTime, "2006-01-02") }}：格式化后的发布时间（stampToDate是日期格式化标签，"2006-01-02"是Go语言的时间格式化标准）

示例：展示最新文章标题和链接

<div class="latest-articles">
    <h3>最新文章</h3>
    <ul>
        {% archiveList articles with moduleId="1" order="id desc" limit="5" %}
            {% for item in articles %}
                <li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
            {% empty %}
                <li>暂无文章</li>
            {% endfor %}
        {% endarchiveList %}
    </ul>
</div>

实现分页功能：pagination标签

对于内容量较大的列表，分页是提升用户体验的关键。当archiveList标签的type参数设置为"page"时，它会配合pagination标签一同工作，实现完整的分页导航。

pagination标签的使用方式：

{% pagination pages with show="5" %}
    {# 在这里组织分页链接，例如上一页、下一页、页码等 #}
{% endpagination %}

pagination标签会创建一个pages对象，其中包含丰富的分页信息：

• pages.TotalItems：总内容数量
• pages.TotalPages：总页数
• `pages.Current