如何在文章列表页中根据特定条件（如推荐属性）筛选并展示内容？

在我们的网站内容运营中，文章列表页往往承担着重要的展示职责。我们不希望仅仅按照发布时间机械地排列内容，而是希望能根据一些特定的条件，比如内容的重要性、热门程度或者是否被推荐，来灵活地筛选和展示文章。安企CMS（AnQiCMS）在设计之初就充分考虑了这些需求，为我们提供了简单而强大的内容筛选机制。

今天，我们就来聊聊如何在安企CMS的文章列表页中，根据特定条件（比如“推荐属性”）来筛选并展示内容。

第一步：在后台为文章设置“推荐属性”

要让前台列表能够根据推荐属性来筛选文章，首先我们需要在后台给文章打上这些“标签”。

当你进入安企CMS的后台管理界面，在“内容管理”菜单下选择“发布文档”或“编辑文档”时，你会看到一个名为“推荐属性”的选项区域。这里提供了多种预设的属性，例如“头条[h]”、“推荐[c]”、“幻灯[f]”等等。

这些属性就像是文章的“身份标识”。你可以根据文章的重要性或展示意图，为它勾选一个或多个属性。比如，一篇特别重要的文章，你可能同时勾选“头条[h]”和“推荐[c]”。当然，如果一篇文章不需要任何特殊标识，保持不勾选也是可以的。

值得注意的是，每个属性都对应一个字母标识（例如“推荐”对应c， “头条”对应h），这个字母在前台模板中将是用来筛选的关键。

第二步：在模板中灵活调用并筛选内容

设置好后台属性后，接下来就是在网站前台模板中实现筛选展示了。安企CMS采用了类似Django模板引擎的语法，使用起来非常直观。我们主要会用到archiveList这个强大的模板标签。

archiveList标签是用来获取文章列表的核心工具。它支持多种参数，让我们能够根据不同的条件来检索内容。要根据推荐属性筛选，我们只需要用到它的flag参数。

假设我们希望在一个特定的区域，比如网站首页的“编辑推荐”栏目，展示所有被标记为“推荐[c]”的文章，我们可以这样编写模板代码：

{# 假设这里是你的“编辑推荐”模块 #}
<div class="editor-recommend-section">
    <h3>编辑推荐</h3>
    <ul>
        {# 使用 archiveList 标签来获取文章列表 #}
        {% archiveList recommendedArticles with moduleId="1" flag="c" order="id desc" limit="5" type="list" %}
            {% for item in recommendedArticles %}
            <li>
                <a href="{{ item.Link }}" title="{{ item.Title }}">
                    {# 如果文章有缩略图，我们当然希望它能显示出来 #}
                    {% if item.Thumb %}
                        <img src="{{ item.Thumb }}" alt="{{ item.Title }}">
                    {% endif %}
                    <h4>{{ item.Title }}</h4>
                    <p>{{ item.Description|truncatechars:80 }}</p>
                    <span class="publish-date">{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
                </a>
            </li>
            {% empty %}
            <li>
                抱歉，目前没有推荐文章。
            </li>
            {% endfor %}
        {% endarchiveList %}
    </ul>
</div>

让我们简单解读一下这段代码：

  • archiveList recommendedArticles with ...: 这是调用文章列表标签，并将获取到的数据存储在recommendedArticles这个变量中。
  • moduleId="1": 这个参数指定了我们要获取的是“文章模型”的内容。如果你的推荐属性是为产品设置的，那么这里可能就是moduleId="2"（或其他自定义模型的ID）。
  • flag="c": 这就是根据“推荐[c]”属性进行筛选的关键！它告诉系统只返回那些被标记为“推荐”的文章。
  • order="id desc": 我们可以选择文章的排序方式，这里是按ID降序，也就是最新发布的推荐文章会排在前面。你也可以改成order="views desc"来展示浏览量最高的推荐文章。
  • limit="5": 我们限制只显示最新的5篇推荐文章。
  • type="list": 表示我们只是获取一个简单的列表，不需要分页功能。如果需要分页，可以设置成type="page"，并结合pagination标签使用。
  • {% for item in recommendedArticles %}: 这是一个循环，遍历recommendedArticles中的每一篇文章数据。
  • {{ item.Link }}, {{ item.Title }}, {{ item.Thumb }}, {{ item.Description }}, {{ item.CreatedTime }}: 这些都是文章的内置字段，通过item.前缀可以直接访问。item.Description|truncatechars:80使用了过滤器来截取描述的长度。stampToDate是安企CMS提供的日期格式化函数，让时间显示更友好。
  • {% empty %}: 这是一个很实用的功能，当recommendedArticles为空时（即没有符合条件的文章），就会显示empty块中的内容。

更多筛选组合

除了仅仅筛选“推荐”文章，你还可以灵活组合其他参数：

  • 排除特定属性： 如果你想展示除了“头条”以外的所有文章，可以使用excludeFlag="h"。
  • 筛选特定分类下的推荐文章： 结合categoryId参数，例如categoryId="10" flag="c"，表示只显示分类ID为10的推荐文章。
  • 展示推荐属性本身： 如果你想在列表项中显示文章的推荐属性（例如“[推荐]”字样），可以在archiveList中添加showFlag=true参数，然后在循环中使用{{item.Flag}}来获取并显示它。

结合实际场景的应用

这种基于推荐属性的筛选能力在实际运营中非常有用：

  1. 网站首页： 可以设置“今日头条”、“编辑精选”、“幻灯片推荐”等多个模块，分别通过不同的flag来展示对应的内容。
  2. 侧边栏/底部推荐： “热门文章”、“最新推荐”等区域，利用flag和order（如按浏览量排序）参数，可以轻松实现动态的内容展示。
  3. 专题页面： 在制作专题时，你可以为专题内的特定文章打上专属的推荐属性，然后在专题页面中精准地调用这些精选内容。

通过安企CMS提供的archiveList标签和推荐属性功能，我们能够轻松地构建出内容丰富、层次分明的文章列表页，让网站的内容运营变得更加高效和灵活。

常见问题 (FAQ)

1. 我能否在同一个archiveList标签中同时筛选多个推荐属性的文章，比如既要“头条[h]”又要“推荐[c]”？ 安企CMS的archiveList标签在flag参数上目前设计为每次调用只支持筛选一个推荐属性。如果你需要展示同时具备“头条”和“推荐”属性的文章，或者需要展示包含“头条”或“推荐”属性的文章，你需要分开调用archiveList标签，或者在后台为这些文章设置一个全新的组合属性（如果业务逻辑允许），但更常见和推荐的做法是使用单个flag参数来获取一个特定类型的推荐内容列表。

2. 如何在文章标题旁边直接显示它的推荐属性，比如“[推荐] 安企CMS入门指南”？ 这是可以实现的。在archiveList标签中，添加一个showFlag=true的参数。这样，在循环文章数据时，每个item对象就会包含一个Flag字段，其值就是文章的推荐属性字母（例如c）。你可以在模板中这样显示：

{% archiveList articles with moduleId="1" limit="5" showFlag=true %}
    {% for item in articles %}
    <li>
        {% if item.Flag %}[{{ item.Flag }}]{% endif %}
        <a href="{{ item.Link }}">{{ item.Title }}</a>
    </li>
    {% endfor %}
{% endarchiveList %}

你甚至可以根据item.Flag的值进行条件判断，显示更友好的文字，比如将c显示为“推荐”，将h显示为“头条”。

3. 除了文章列表，这个筛选功能也适用于产品列表或其他自定义内容模型吗？ 完全可以。安企CMS的archiveList标签是通用的内容列表标签，它通过moduleId参数来指定要操作的内容模型。无论是文章、产品，还是你通过“内容模型”功能自定义的任何内容类型，只要你在后台为这些内容设置了“推荐属性”，就可以在前台通过moduleId配合flag参数进行筛选和展示。例如，要筛选“产品模型”（