在网站内容运营中，我们常常需要突出某些特定内容，比如首页的头条新闻、产品页面的特色推荐，或者轮播图上的焦点内容。为了让这些内容在网站前台的特定区域灵活展示，安企CMS提供了一个非常实用的功能：内容推荐属性（Flag）。

这项功能能够帮助我们更精细地管理内容的展示逻辑，将一些重要或有特殊用途的内容从海量信息中筛选出来，呈现在用户最容易注意到的位置。

什么是内容推荐属性（Flag）？

内容推荐属性，顾名思义，是给内容打上的一种“推荐”标记。它超越了传统的分类体系，允许我们根据内容的展示优先级或特殊用途进行标记。比如，一篇重要新闻，除了属于“行业动态”分类外，我们可能还希望它同时出现在首页的“头条新闻”区和“图片轮播”区。通过设置推荐属性，就能轻松实现这样的需求。

安企CMS预设了八种推荐属性供我们选择：

  • 头条[h]：用于标记最重要的新闻或文章。
  • 推荐[c]：作为一般性的推荐内容，常见于文章列表的“编辑推荐”等区域。
  • 幻灯[f]：专用于在网站的轮播图或幻灯片区域展示的内容。
  • 特荐[a]：通常指具有特殊推荐价值的内容，区别于普通推荐。
  • 滚动[s]：适合在公告栏或新闻跑马灯中滚动的简短信息。
  • 加粗[h]：通常用于在标题或列表中以加粗形式突出显示。
  • 图片[p]：标记为带有重要图片的文章，可以在图片展示区调用。
  • 跳转[j]：意味着点击后会跳转到外部链接或其他指定页面的内容。

这里需要特别留意的是，头条[h]和加粗[h]都使用了相同的标识字母h。在实际操作中，为了避免混淆并确保调用准确性，建议在设置内容时根据具体需求进行判断，例如如果需要同时标记头条和加粗，您可能需要考虑业务逻辑上这两个属性是否会同时出现在同一列表中，或者在模板调用时进行更细致的区分。

如何在后台为内容设置推荐属性？

为内容打上推荐属性，操作起来非常直观。当您在安企CMS后台发布新文档或编辑现有文档时，会看到一个名为“推荐属性”的选项区域。

  1. 进入内容编辑界面：在后台导航中找到“内容管理”，选择“发布文档”或“文档管理”并点击“编辑”现有文档。
  2. 定位“推荐属性”：在文档编辑页面的左侧或右侧，您会看到“推荐属性”的区域。
  3. 选择推荐标记：这里会列出所有可用的推荐属性，每个属性旁边都有一个复选框。您可以根据需要，为当前文档选择一个或多个属性。比如，如果一篇文档既是首页头条，又适合作为轮播图展示，您可以同时勾选头条[h]和幻灯[f]。
  4. 保存文档：选择完成后，记得点击页面底部的“提交”或“保存”按钮，确保推荐属性的设置生效。

通过这样的设置，我们就成功地为内容打上了“标签”，下一步就是如何在网站前台将这些内容展示出来了。

如何在前端模板中调用带有推荐属性的内容？

将后台设置好的推荐内容呈现在网站前台，需要借助安企CMS强大的模板标签体系，特别是archiveList标签。archiveList标签是用来获取文档列表的万能标签，它支持多种筛选条件，其中就包括了我们的“推荐属性”。

在使用archiveList标签时，我们可以通过flag参数来指定要调用的推荐属性字母。

一个基本的调用示例可能像这样：

{# 假设我们想在首页某个区域显示“推荐[c]”属性的文章列表，显示5条 #}
<div class="recommended-section">
    <h3>编辑推荐</h3>
    <ul>
        {% archiveList recommendedArticles with flag="c" limit="5" %}
            {% for item in recommendedArticles %}
                <li>
                    <a href="{{ item.Link }}">{{ item.Title }}</a>
                    {# 这里可以根据需要添加更多内容，比如发布日期、缩略图等 #}
                    <span>发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
                </li>
            {% empty %}
                <p>暂无推荐内容。</p>
            {% endfor %}
        {% endarchiveList %}
    </ul>
</div>

在这个例子中：

  • archiveList recommendedArticles：定义了一个名为recommendedArticles的变量来存储获取到的文档列表。
  • with flag="c"：这是关键，它告诉系统只获取被标记为推荐[c]属性的文档。
  • limit="5"：限制只显示5条文档。
  • {% for item in recommendedArticles %}：循环遍历获取到的文档，item代表每一篇文档。

如果您希望展示一些不包含特定推荐属性的内容，比如显示最新的文章，但排除掉所有“头条[h]”文章，可以使用excludeFlag参数：

”`twig {# 显示最新的5篇文章，但排除掉所有带有“头条[h]”属性的文章