在内容运营中，将重要或推荐的内容以醒目的方式展示给访客，是提升用户体验和内容触达效率的关键。安企CMS（AnQiCMS）提供了强大的“推荐属性”功能，让你可以轻松地标记和管理不同类型的特色内容，例如将其设置为头条文章、幻灯片展示或是其他特定推荐。
本文将详细介绍如何在安企CMS的网站前台，将文档的这些推荐属性有效呈现出来。
一、理解安企CMS的文档推荐属性
首先，我们需要明确安企CMS中的“推荐属性”是什么，以及它们在后台是如何设置的。
在安企CMS的后台管理界面，当你添加或编辑文档时，会发现有一个名为“推荐属性”的选项。这里列出了多种预设的属性，如头条、幻灯、推荐等，每个属性都对应一个特定的字母标识，方便系统进行识别和调用。你可以根据内容的性质，为文档勾选一个或多个推荐属性。
这些常用的推荐属性及其字母标识包括：
- 头条
[h]：通常用于网站首页最重要、最受关注的新闻或文章。 - 推荐
[c]：泛指编辑精选、值得关注的内容。 - 幻灯
[f]：适用于需要在轮播图或幻灯片中展示的内容，通常会配有精美的图片。 - 特荐
[a]：特别推荐的内容，比普通推荐更强调其重要性。 - 滚动
[s]：适合在侧边栏、通知区域等以滚动形式展示的简短内容。 - 加粗
[h]：可能与头条共用[h]标识，表示该内容的标题或摘要需要以加粗形式显示。 - 图片
[p]：强调内容以图片为主，或需要显示缩略图。 - 跳转
[j]：点击后直接跳转到外部链接或指定页面，而非内容详情页。
一个重要的规则是：在网站前台调用时，每个列表（例如一个文章列表模块、一个幻灯片模块）通常只能使用一个推荐属性来进行内容筛选。 这意味着如果你想展示“头条”内容，就需要专门为“头条”设置一个调用区域，而不能在同一个调用区域内同时筛选出“头条”和“幻灯”的内容。
二、如何在模板中调用带有推荐属性的文档
安企CMS的模板系统通过标签（Tag）来实现内容的调用。要显示带有特定推荐属性的文档，我们主要会使用 archiveList 标签。这个标签功能强大，可以根据多种条件筛选文档，其中就包括了 flag 参数，专门用于指定推荐属性。
1. 使用 flag 参数筛选特定属性的文档
archiveList 标签的 flag 参数允许你传入推荐属性对应的字母标识，从而只筛选出具有该属性的文档。
示例：调用带有“头条”属性的文档列表
假设你希望在网站首页展示最新的5篇头条文章，你可以这样编写模板代码：
<div class="headline-section">
<h2>最新头条</h2>
<ul>
{% archiveList archives with flag="h" limit="5" %}
{% for item in archives %}
<li><a href="{{ item.Link }}">{{ item.Title }}</a></li>
{% empty %}
<li>暂无头条文章。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
在这段代码中：
flag="h"：表示我们只希望获取被标记为“头条”的文档。limit="5"：限制了显示文档的数量为5篇。item.Link和item.Title：分别用于获取文档的链接和标题。
示例：调用带有“幻灯”属性的文档作为轮播图
对于幻灯片，通常需要显示图片和标题。这时，我们会利用文档的 Logo 或 Thumb 字段。
<div class="slideshow-container">
{% archiveList slideshows with flag="f" limit="3" %}
{% for item in slideshows %}
<div class="slide-item">
<a href="{{ item.Link }}"><img src="{{ item.Logo }}" alt="{{ item.Title }}"></a>
<h3><a href="{{ item.Link }}">{{ item.Title }}</a></h3>
</div>
{% empty %}
<p>暂无幻灯片内容。</p>
{% endfor %}
{% endarchiveList %}
</div>
这里我们使用了 flag="f" 来筛选幻灯片文档，并利用 item.Logo（通常是文档的大图或主图）来展示图片。如果 Logo 不可用或你希望使用缩略图，也可以使用 item.Thumb。
2. 显示文档的推荐属性文字标识 (showFlag)
有时候，你可能希望在文档标题旁边显示一个小的标签，比如“【头条】”或者“【推荐】”，以明确告知访客该内容的属性。这时，可以在 archiveList 标签中添加 showFlag=true 参数。
<div class="recommended-list">
<h2>编辑推荐</h2>
<ul>
{% archiveList recommendedDocs with flag="c" limit="10" showFlag=true %}
{% for item in recommendedDocs %}
<li>
{% if item.Flag %}<span class="content-flag">【{{ item.Flag }}】</span>{% endif %}
<a href="{{ item.Link }}">{{ item.Title }}</a>
</li>
{% empty %}
<li>暂无推荐内容。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
在上述代码中，showFlag=true 使得 item.Flag 变量能够获取到文档的推荐属性文本（如“头条”、“推荐”等）。你可以根据自己的CSS样式，将其美化成醒目的标签或徽章。
三、结合实际场景的应用案例
通过 flag 参数的灵活运用，可以为网站创建各种内容展示区域：
首页“焦点图”或“大图轮播”： 通常筛选
flag="f"（幻灯）属性的文档，展示其图片和标题，形成网站最吸引眼球的区域。首页“头条新闻”模块： 筛选
flag="h"（头条）属性的文档，以列表形式展示最新的几篇重磅文章。侧边栏“编辑推荐”或“热门推荐”： 筛选
flag="c"（推荐）或flag="a"（特荐）属性的文档，用简洁的标题列表吸引用户点击。文章详情页的“相关阅读”： 虽然
archiveList标签本身支持type="related"来获取相关文档，但你也可以结合flag参数，例如在相关文档中优先展示那些被标记为“推荐”的内容。
四、优化与注意事项
- 属性设置的准确性：确保在后台为文档设置的推荐属性是准确且有意义的，避免随意标记导致前台内容混乱。
- 图片尺寸一致性：特别是对于幻灯片或焦点图，建议上传尺寸统一的图片，或者在安企CMS的“内容设置”中配置“缩略图处理方式”和“缩略图尺寸”，确保前台显示美观。
- CSS样式美化：模板标签只负责内容的调用和输出，具体如何排版、字体大小、颜色等视觉呈现，需要通过CSS样式来控制。
- 避免滥用：过多的推荐属性可能分散用户的注意力。合理规划网站布局，将不同属性的内容放置在最