如何在模板中循环显示最新发布的10篇文章列表？

作为一位资深的安企CMS网站运营人员，我深知内容在网站运营中的核心地位。动态展示最新内容不仅能提升用户体验，还能有效增加网站的活跃度和搜索引擎的抓取频率。下面，我将详细阐述如何在AnQiCMS模板中循环显示最新发布的10篇文章列表。

在AnQiCMS模板中循环显示最新发布的10篇文章列表

在AnQiCMS中，模板的创建和管理遵循一套简洁高效的规则，其语法类似于Django模板引擎，使得前端开发者能够轻松上手。要实现在网站页面上动态展示最新发布的10篇文章，我们需要利用AnQiCMS内置的模板标签和循环结构。

安企CMS的模板文件通常以.html为后缀，并存放在/template目录下的特定模板文件夹中。静态资源如样式、脚本和图片则放置在/public/static/目录。在模板文件中，变量使用双花括号{{变量}}定义，而条件判断和循环控制等逻辑标签则使用单花括号和百分号{% 标签 %}定义，并且需要使用结束标签来闭合，例如{% for ... %}需要{% endfor %}。

要获取文章列表，我们主要依赖AnQiCMS提供的archiveList标签。这个标签是获取文章、产品等内容列表的强大工具。通过合理配置其参数，我们可以精确控制所需内容的数量、排序方式以及所属分类等。

首先，我们需要在希望展示最新文章的模板文件中，使用archiveList标签来获取数据。这个标签允许我们指定多种条件来筛选文章，其中最关键的是限制数量和排序方式。为了获取最新发布的10篇文章，我们会将type参数设置为"list"（表示获取一个列表而非分页），limit参数设置为"10"（限制获取10篇文章），并使用order参数指定排序方式为"CreatedTime desc"，这意味着文章将按照创建时间降序排列，确保最新发布的文章排在前面。此外，moduleId参数用于指定内容模型，文章通常使用默认的文章模型ID，一般无需特别指定或根据实际配置填写。

{# 获取最新发布的10篇文章 #}
{% archiveList archives with type="list" limit="10" order="CreatedTime desc" %}
    {# 检查是否有文章存在，如果列表为空，则显示“没有内容” #}
    {% for item in archives %}
        <div class="latest-article-item">
            {# 文章标题及链接 #}
            <h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
            {# 文章发布时间，使用stampToDate标签格式化 #}
            <p class="article-date">发布于：{{ stampToDate(item.CreatedTime, "2006-01-02 15:04") }}</p>
            {# 文章简介 #}
            <p class="article-description">{{ item.Description }}</p>
            {# 如果文章有缩略图，则显示 #}
            {% if item.Thumb %}
                <div class="article-thumbnail">
                    <img src="{{ item.Thumb }}" alt="{{ item.Title }}">
                </div>
            {% endif %}
            {# 可以根据需要添加更多文章信息，例如分类、浏览量等 #}
            <p class="article-meta">
                {% if item.CategoryId %}
                    {# 获取文章所属分类的名称和链接 #}
                    <span>分类：<a href="{% categoryDetail with name='Link' id=item.CategoryId %}">{% categoryDetail with name='Title' id=item.CategoryId %}</a></span>
                {% endif %}
                <span>浏览量：{{ item.Views }}</span>
            </p>
        </div>
    {% empty %}
        <p>目前还没有任何最新文章发布。</p>
    {% endfor %}
{% endarchiveList %}

在上述代码中，{% archiveList archives with type="list" limit="10" order="CreatedTime desc" %}这一行代码是核心，它会从数据库中获取符合条件的文章数据，并将结果存储在名为archives的变量中。接着，{% for item in archives %}循环遍历这个archives数组，每次循环都会将当前文章的数据赋值给item变量。

在循环体内，我们可以访问item对象的各种属性来显示文章的详细信息，例如{{ item.Title }}获取文章标题，{{ item.Link }}获取文章详情页链接，{{ item.Description }}获取文章简介。特别地，{{ stampToDate(item.CreatedTime, "2006-01-02 15:04") }}这行代码展示了如何使用stampToDate标签将Unix时间戳格式化为可读的日期和时间。其中的"2006-01-02 15:04"是Go语言特有的日期格式化字符串。我们还通过{% if item.Thumb %}判断文章是否有缩略图，并进行显示。通过嵌套categoryDetail标签，可以获取到每篇文章所属分类的名称和链接。

如果archiveList获取到的文章列表为空，{% empty %}标签内的内容将被执行，提供友好的提示信息。最后，{% endarchiveList %}和{% endfor %}标签分别用于闭合archiveList和for循环。

在实际应用中，请务必将上述代码片段放置在您的AnQiCMS模板文件（例如index.html或您自定义的某个公共片段文件）中。同时，请确保您的模板文件使用UTF-8编码，以避免出现乱码问题。任何对模板文件的修改，可能需要您在后台管理界面点击“更新缓存”来确保前端页面的内容得到及时刷新。通过这样的方式，您的网站就能动态地展示最新、最有吸引力的内容，从而更好地服务于您的读者。

常见问题 (FAQ)

1. 如何修改显示文章的数量或者调整排序方式？

您可以通过调整archiveList标签中的limit和order参数来轻松实现。例如，如果您想显示5篇文章，可以将limit="10"改为limit="5"。如果您希望按文章的浏览量降序排列（最受欢迎的文章），可以将order="CreatedTime desc"改为order="views desc"。这些参数提供了极大的灵活性，以满足您不同的内容展示需求。

2. 如果我想显示特定分类下的最新文章怎么办？

在archiveList标签中添加categoryId参数即可。例如，如果您只想显示分类ID为10的最新文章，可以将archiveList标签修改为{% archiveList archives with type="list" limit="10" order="CreatedTime desc" categoryId="10" %}。您也可以通过逗号分隔多个分类ID，如categoryId="10,12,15"，以显示多个指定分类下的最新文章。

3. 这段代码可以用于显示除了文章以外的其他内容模型吗，比如最新产品？

可以的。AnQiCMS的设计允许不同内容模型重用相同的列表标签。如果您想显示最新产品，您需要知道产品模型对应的moduleId。通常，文章模型的moduleId是1，产品模型的moduleId是2（具体数值请查阅您的AnQiCMS后台内容模型配置）。只需在archiveList标签中将moduleId参数设置为产品模型的ID，例如{% archiveList products with type="list" limit="10" order="CreatedTime desc" moduleId="2" %}，然后将archives变量名改为products（或任何您喜欢的名称）以保持代码清晰，即可显示最新产品列表。