AnQiCMS 如何在首页显示最新发布文章列表？

在安企CMS中，网站首页承载着吸引访客、展示最新动态的重要职责。通常，在首页显眼位置展示最新发布的文章列表，是提升用户体验、引导内容浏览的有效方式。安企CMS凭借其灵活的模板系统和强大的内容管理功能，让这一操作变得非常直接和高效。

理解安企CMS的内容结构

在着手展示最新文章之前，我们首先需要对安企CMS的内容组织方式有一个基本的了解。安企CMS允许用户通过“内容模型”来定义不同类型的内容，例如“文章模型”、“产品模型”等。每篇文章都归属于一个特定的模型，并且可以进一步划分到不同的分类下。在模板层面，安企CMS提供了丰富的标签，帮助我们从这些结构化的内容中提取并展示所需数据。

在首页展示最新文章列表的核心方法

要在首页显示最新发布的文章列表，我们将主要依赖安企CMS提供的archiveList模板标签。这个标签专门用于获取各类文档（包括文章）的列表数据，并提供了多种参数来精准控制我们想要展示的内容。

首先，确保你的首页模板文件（通常是/template/你的模板名/index.html）已经准备就绪。然后，在你想显示文章列表的位置，添加archiveList标签。

关键参数解析：

• moduleId：这个参数用来指定你想要获取哪个内容模型的文章。默认情况下，文章模型通常对应的moduleId为1。如果你自定义了内容模型，请在后台“内容管理 -> 内容模型”中查看你文章模型对应的ID。
• order：为了获取“最新发布”的文章，我们需要按发布时间倒序排列。你可以设置order="id desc"或order="CreatedTime desc"。id desc通常意味着按照文章在数据库中的创建顺序倒序，而CreatedTime desc则明确是按照发布时间倒序。在实际使用中，两者效果可能相近，但CreatedTime desc更为精确地表达“最新发布”。
• limit：这个参数用于控制显示的文章数量。例如，limit="10"将显示最近的10篇文章。
• type：默认情况下，archiveList标签的type参数设置为"list"即可，它会直接列出指定数量的文章。

如何构建文章列表：

archiveList标签会在其内部创建一个可遍历的文章数组。我们可以使用for循环来逐一处理这些文章，并提取每篇文章的标题、链接、发布时间、摘要或缩略图等信息进行展示。每篇文章在循环中通常被命名为item，你可以通过item.Title、item.Link等方式访问其属性。

对于文章的发布时间，安企CMS返回的是一个时间戳。为了将其显示为我们习惯的日期格式，我们需要使用stampToDate标签进行格式化。这个标签非常灵活，可以根据你提供的格式字符串输出多种日期时间样式。

示例代码与解读

下面是一个在安企CMS首页显示最新发布5篇文章的简单代码示例：

<section class="latest-articles">
    <h2>最新发布</h2>
    <ul class="article-list">
        {% archiveList archives with moduleId="1" order="CreatedTime desc" limit="5" %}
            {% for item in archives %}
                <li class="article-item">
                    <a href="{{ item.Link }}" title="{{ item.Title }}">
                        {% if item.Thumb %}
                            <img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="article-thumb">
                        {% endif %}
                        <h3>{{ item.Title }}</h3>
                        <p class="article-meta">发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</p>
                        <p class="article-description">{{ item.Description|truncatechars:100 }}</p>
                    </a>
                </li>
            {% empty %}
                <li class="no-articles">目前还没有最新文章发布。</li>
            {% endfor %}
        {% endarchiveList %}
    </ul>
</section>

代码解读：

1. {% archiveList archives with moduleId="1" order="CreatedTime desc" limit="5" %}：
   • 这里定义了一个名为archives的变量，它将包含我们获取到的文章列表。
   • moduleId="1"指定了我们获取的是“文章模型”下的内容。
   • order="CreatedTime desc"确保文章按照发布时间从新到旧排列。
   • limit="5"限制了只显示最新的5篇文章。
2. {% for item in archives %}：循环遍历archives中的每一篇文章。在每次循环中，当前文章的数据都可以通过item变量访问。
3. {% if item.Thumb %}<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="article-thumb">{% endif %}：这部分代码会检查文章是否有缩略图（item.Thumb），如果有，就显示这张图片。
4. <h3>{{ item.Title }}</h3>：显示文章的标题。
5. <p class="article-meta">发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</p>：
   • item.CreatedTime获取文章的发布时间戳。
   • stampToDate(..., "2006-01-02")将时间戳格式化为“年-月-日”的字符串。你可以根据需要修改格式字符串，例如"2006年01月02日 15:04"会显示更详细的时间。
6. <p class="article-description">{{ item.Description|truncatechars:100 }}</p>：显示文章的摘要（item.Description）。这里使用了truncatechars:100过滤器，将摘要截取为最多100个字符，并自动添加省略号，防止内容过长影响布局。
7. {% empty %}<li class="no-articles">目前还没有最新文章发布。</li>{% endfor %}：这是一个非常实用的结构。如果archives列表为空（即没有文章符合条件），则会显示empty块中的内容，而不是显示一个空的列表。

**实践与优化建议

• 控制显示数量：首页文章列表不宜过长，一般5-10篇文章即可，过多的文章可能影响页面加载速度和用户注意力。
• 优化图片加载：如果你的文章缩略图较多，可以考虑为图片添加懒加载（lazy load）属性，提升首屏加载速度。安企CMS在内容详情中支持图片懒加载。
• 完善文章内容：确保每篇文章都有清晰的标题、有吸引力的缩略图和简明扼要的摘要。这些元素对于提升文章列表的点击率至关重要。
• SEO友好：文章的标题和链接都是搜索引擎优化的重要组成部分，确保item.Title和item.Link的正确使用有助于搜索引擎更好地理解你的内容。

通过上述步骤，你就可以轻松地在安企CMS的网站首页展示最新发布的文章列表了。安企CMS的模板标签功能强大而直观，让内容展示变得非常灵活。

常见问题 (FAQ)

1. 我能否在首页显示特定分类下的最新文章？

当然可以。你可以在archiveList标签中添加categoryId参数来指定某个或多个分类的ID。例如，要显示分类ID为2的最新文章，可以将标签修改为：{% archiveList archives with moduleId="1" categoryId="2" order="CreatedTime desc" limit="5" %}。如果你想显示多个分类的文章，ID之间用逗号隔开，如categoryId="2,3,4"。

2. 如果我的文章没有上传缩略图，会显示什么？

在安企CMS中，如果你在发布文章时没有手动上传缩略图，但文章内容中包含了图片，系统会自动尝试提取文章内容的第一张图片作为缩略图。如果文章内容中也没有图片，那么在模板中item.Thumb或item.Logo将为空，你可以通过{% if item.Thumb %}这样的判断来避免显示一个破碎的图片链接，或者设置一个默认的占位图来保证页面美观。

3. 如何调整文章发布时间的显示格式？

文章发布时间的显示格式由stampToDate标签的第二个参数（格式字符串）决定。这个格式字符串遵循Go语言的时间格式化规则。例如：

• "2006-01-02"：显示为 年-月-日 (如 2023-10-27)
• "2006年01月02日"：显示为 XXXX年XX月XX日 (如 2023年10月27日)
• "2006-01-02 15:04"：显示为 年-月-日 时:分 (如 2023-10-27 14:30) 你可以根据自己的需求修改这个格式字符串以达到理想的显示效果。