在网站运营中，提供与当前内容相关的推荐文章列表，是提升用户体验、延长用户停留时间和优化网站内部链接的重要策略。安企CMS（AnQiCMS）深知这一点，并提供了灵活且强大的功能来帮助您轻松实现这一目标。
核心功能解析：相关文档标签 archiveList
要在安企CMS中显示与当前文章内容相关的推荐文章列表，您主要会用到一个非常关键的模板标签——archiveList。这个标签不仅可以用来获取常规的文章列表或分页列表，它还内置了专门用于处理“相关文章”推荐的逻辑。
当您在文章详情页使用 archiveList 标签，并将其 type 参数设置为 "related" 时，系统就会智能地根据当前文章的内容来推荐相关文章。这大大简化了模板开发的复杂性，让您无需编写复杂的查询逻辑。
基本的调用方式可以像这样：
{% archiveList relatedArchives with type="related" limit="5" %}
{# ... 这里将显示相关文章列表 ... #}
{% endarchiveList %}
在这里，relatedArchives 是您为推荐文章列表定义的变量名，type="related" 告诉系统要获取相关文章，而 limit="5" 则控制了推荐文章的数量。
深入理解“相关”的定义：多种推荐逻辑
安企CMS在判断“相关性”时，并非只有一种固定模式，它提供了多种逻辑来帮助您更精准地定义文章之间的关联。
首先，默认的关联逻辑是基于当前文章的所属分类。系统会尝试在相同的分类下，寻找发布时间相近或者内容上有所关联的其他文章进行推荐。这意味着，合理地规划您的文章分类结构，是提高默认推荐精准度的基础。
其次，您还可以通过 like 参数来进一步细化推荐逻辑：
基于关键词推荐 (
like="keywords")：如果您希望推荐的文章更精准地围绕某个主题，可以利用文章的关键词。当设置like="keywords"时，系统会根据当前文章所设置的关键词，去匹配其他文章的关键词，从而推荐主题更贴近的文章。这要求您在发布文章时，认真填写文章的关键词（在后台“内容管理”中编辑文章时，可以手动输入或从关键词库选择）。同时，利用“文档标签”功能，为文章打上合适的标签，也能间接增强关键词的匹配效果。手动关联推荐 (
like="relation")：对于一些您需要特别指定关联性的文章，例如系列教程中的下一篇，或者某个产品介绍的延伸阅读，安企CMS提供了手动设置关联文章的功能。当您在archiveList标签中设置like="relation"时，系统将只会显示那些在当前文章编辑界面中被您手动关联的文章。这为您提供了极高的灵活性，确保某些特定文章始终出现在推荐列表中。
代码实战：在模板中添加推荐文章列表
接下来，我们来看一个完整的示例，演示如何在文章详情页的模板中，添加一个包含缩略图、标题和简介的推荐文章列表。这个例子结合了 like="keywords" 的推荐逻辑，以提供更具内容相关性的推荐。
假设您的文章详情页模板文件（例如 archive/detail.html）中需要添加推荐文章区域：
{# 假设这是文章详情页模板的一部分 #}
<article class="article-detail">
{# ... 这里是当前文章的标题、内容等详情 ... #}
</article>
{# 推荐阅读区域 #}
<div class="related-articles">
<h3>推荐阅读</h3>
{% archiveList relatedArchives with type="related" like="keywords" limit="5" %}
{# 检查是否有推荐文章返回 #}
{% if relatedArchives %}
<ul>
{% for item in relatedArchives %}
<li>
<a href="{{ item.Link }}" title="{{ item.Title }}">
{# 如果文章有缩略图，则显示 #}
{% if item.Thumb %}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="related-thumb">
{% else %}
{# 或者显示一个默认的占位图 #}
<img src="/static/images/default-thumb.jpg" alt="默认缩略图" class="related-thumb">
{% endif %}
<span class="related-title">{{ item.Title }}</span>
{# 截取文章描述，保持列表整洁 #}
<p class="related-description">{{ item.Description|truncatechars:80 }}</p>
</a>
</li>
{% endfor %}
</ul>
{% else %}
{# 没有找到相关推荐文章时的提示 #}
<p>暂无相关推荐文章，敬请期待更多精彩内容！</p>
{% endif %}
{% endarchiveList %}
</div>
{# 您可能还需要一些CSS样式来美化这个推荐列表，例如： #}
<style>
.related-articles {
margin-top: 40px;
padding: 20px;
border-top: 1px solid #eee;
background-color: #f9f9f9;
}
.related-articles h3 {
font-size: 20px;
color: #333;
margin-bottom: 20px;
text-align: center;
}
.related-articles ul {
list-style: none;
padding: 0;
display: flex;
flex-wrap: wrap;
gap: 20px; /* 文章间距 */
}
.related-articles li {
flex: 1 1 calc(33.333% - 20px); /* 三列布局，减去间距 */
min-width: 280px; /* 最小宽度 */
background-color: #fff;
border: 1px solid #ddd;
border-radius: 8px;
overflow: hidden;
box-shadow: 0 2px 5px rgba(0,0,0,0.05);
}
.related-articles li a {
text-decoration: none;
color: #333;
display: block;
padding: 15px;
height: 100%;
box-sizing: border-box;
}
.related-articles .related-thumb {
width: 100%;
height: 150px;
object-fit: cover;
border-radius: 4px;
margin-bottom: 10px;
}
.related-articles .related-title {
font-size: 16px;
font-weight: bold;
display: block;
margin-bottom: 5px;
line-height: 1.4;
height: 45px; /* 标题固定高度 */
overflow: hidden;
text-overflow: ellipsis;
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
}
.related-articles .related-description {
font-size: 13px;
color: #666;
line-height: 1.5;
height: 60px; /* 描述固定高度 */
overflow: hidden;
text-overflow: ellipsis;
display: -webkit-box;
-webkit-line-clamp: 3;
-webkit-box-orient: vertical;
}
.related-articles p {
text-align: center;
color: #666;
}
</style>
在这段代码中：
- 我们用
archiveList标签获取了推荐文章，指定了type="related"和like="keywords"，并限制显示5篇文章。 - 通过
{% if relatedArchives %}判断是否有文章返回，避免空列表显示不美观。 - 循环遍历
relatedArchives中的每一项 (item)，并显示其标题 (item.Title)、链接 (item.Link) 和缩略图 (item.Thumb)。 - 使用了
item.Description|truncatechars:80过滤器来截取文章简介，确保推荐列表的排版整洁。 - 如果文章没有缩略图，我们提供了一个默认占位图的路径，以保证显示效果。
- 附带的 CSS 样式代码可以帮助您快速构建一个响应式且美观的推荐文章布局。