如何根据文章的关键词或自定义关联来显示相关文章列表？
在网站内容运营中，为用户提供相关文章列表，不仅能有效延长访客在网站上的停留时间，降低跳出率，更能通过引导用户发现更多感兴趣的内容，优化站内流量路径，对SEO表现也有着积极的促进作用。安企CMS（AnQiCMS）深知这一需求，为此提供了灵活且强大的功能，让我们能够根据文章的关键词或自定义关联，轻松展示相关文章列表。
理解安企CMS的文章关联逻辑
安企CMS在设计之初就考虑到了内容之间的关联性。它提供了两种主要方式来帮助我们构建和展示文章之间的关系：一是通过关键词进行自动匹配，二是通过后台手动设置建立精确的自定义关联。这两种方式各有侧重，可以根据实际运营需求灵活选择。
方法一：利用关键词实现文章的自动关联
当我们发布文章时，通常会为文章设置关键词。这些关键词不仅有助于搜索引擎理解文章主题，更是安企CMS实现文章自动关联的重要依据。安企CMS能够智能地根据当前文章的关键词，在系统中检索并推荐其他关键词相似的文章。
如何设置文章关键词：
在安企CMS的后台，当我们进入“内容管理”模块下的“发布文档”页面时，会看到一个“文档关键词”的输入框。我们可以在这里手动输入与文章内容高度相关的关键词，多个关键词之间使用英文逗号 , 进行分隔。此外，安企CMS还提供了关键词库管理功能，方便我们从预设的关键词库中选择，或者自动拓词，进一步提升关键词的设置效率和相关性。
在模板中调用基于关键词的相关文章：
要在网站页面上展示基于关键词自动关联的文章列表，我们需要在文章详情页的模板中，使用安企CMS提供的 archiveList 标签。这个标签拥有丰富的参数，可以帮助我们精准控制内容的获取和显示。
例如，要在文章详情页的底部展示5篇与当前文章关键词相关的文章，我们可以这样编写模板代码：
{# 假设这里是文章详情页的模板代码 #}
<h3>相关推荐</h3>
<div>
{% archiveList relatedByKeywords with type="related" like="keywords" limit="5" %}
{% for item in relatedByKeywords %}
<li>
<a href="{{item.Link}}">{{item.Title}}</a>
{# 如果需要显示简介或缩略图，可以进一步添加 #}
{# <p>{{item.Description|truncatechars:50}}</p> #}
{# {% if item.Thumb %}<img src="{{item.Thumb}}" alt="{{item.Title}}" />{% endif %} #}
</li>
{% empty %}
<li>暂无相关推荐文章。</li>
{% endfor %}
{% endarchiveList %}
</div>
在这段代码中：
type="related"指明我们希望获取相关文章。like="keywords"明确告诉系统，根据文章的关键词来匹配相关内容。安企CMS会根据当前文章的第一个关键词来查找最相关的其他文章。limit="5"则限制了显示的文章数量为5篇。
通过这种方式，系统会根据文章的关键词智能地推荐内容，省去了手动关联的繁琐，特别适合内容量大、更新频繁的网站。
方法二：自定义关联文章，实现精准推荐
有时，我们可能希望更精确地控制哪些文章彼此关联，而不是完全依赖关键词的自动匹配。例如，某系列文章的上下篇、或在营销活动中手动关联的特定产品介绍与新闻稿等。安企CMS也支持这种高度自定义的关联方式。
如何设置自定义关联：
在安企CMS的后台“内容管理”下编辑具体文档时，除了关键词、描述等常用字段，还会有一个选项允许我们设置“相关文档”。在这里，我们可以手动选择并关联一篇或多篇与当前文章有特定逻辑关系的文章。这种手动设置的关联具有最高的优先级，能够确保我们按照运营策略精准推荐内容。
在模板中调用自定义关联文章：
与基于关键词的关联类似，调用自定义关联文章也需要使用 archiveList 标签，只是在 like 参数上有所不同。
例如，要在文章详情页展示我们手动设置的3篇相关文章，模板代码可以这样编写：
{# 假设这里是文章详情页的模板代码 #}
<h3>您可能也喜欢</h3>
<div>
{% archiveList customRelations with type="related" like="relation" limit="3" %}
{% for item in customRelations %}
<li>
<a href="{{item.Link}}">{{item.Title}}</a>
{# 同样，可以根据需要添加更多字段 #}
</li>
{% empty %}
<li>暂无特别推荐。</li>
{% endfor %}
{% endarchiveList %}
</div>
这里关键在于 like="relation"，它指示安企CMS只获取在后台文档编辑界面手动设置的关联文章。这为那些需要高度精细化运营的场景提供了极大的便利。
灵活的展示与优化
无论选择哪种关联方式，archiveList 标签返回的每个 item 都包含了文章的丰富信息，如 Title（标题）、Link（链接）、Description（简介）、Thumb（缩略图）、CreatedTime（发布时间）等。我们可以根据模板设计的需要，自由地组合这些字段来构建多样化的相关文章列表样式。
例如，如果想让列表显示更丰富，可以这样修改：
{# 这是一个更丰富的相关文章列表示例 #}
<h3>精选内容</h3>
<ul class="related-articles-list">
{% archiveList featuredRelations with type="related" like="keywords" limit="4" %}
{% for item in featuredRelations %}
<li class="article-item">
{% if item.Thumb %}
<div class="article-thumb">
<a href="{{item.Link}}"><img src="{{item.Thumb}}" alt="{{item.Title}}"></a>
</div>
{% endif %}
<div class="article-info">
<h4><a href="{{item.Link}}">{{item.Title}}</a></h4>
<p class="article-description">{{item.Description|truncatechars:80}}</p>
<span class="article-date">{{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
</div>
</li>
{% empty %}
<li class="no-results">暂时没有找到其他相关文章。</li>
{% endfor %}
{% endarchiveList %}
</ul>
请注意，item.Description|truncatechars:80 这样的写法使用了安企CMS内置的过滤器，能够将文章简介截取到指定字符长度，并自动添加省略号，保证页面布局的整洁。stampToDate 标签则方便地将时间戳格式化为我们需要的日期形式。
总结
安企CMS通过其精心设计的模板标签和灵活的配置选项，让我们能够根据文章的关键词或自定义设置，便捷地实现相关文章列表的展示。无论是追求自动化、大批量内容的关键词关联，还是需要精细化控制、强逻辑性的手动关联，安企CMS都能提供有效的解决方案，帮助我们更好地组织内容，提升网站的用户体验和运营效率。
常见问题解答 (FAQ)
1. 如果同时设置了关键词关联和自定义关联，哪种方式会优先显示？
在安企CMS中，当您使用 type="related" 标签并指定 like="relation" 时，系统会优先展示您在后台手动设置的自定义关联文章。而当您指定 like="keywords" 时，则会根据文章的关键词进行自动匹配。这两个 like 参数是互斥的，您不能在同一个 archiveList 标签中同时使用它们来获取同一批次的相关文章，但可以分别调用两个 archiveList 标签，分别展示两类关联文章列表。
2. 如果文章没有设置关键词或自定义关联，相关文章列表会显示什么？
如果文章既没有设置关键词，也没有手动关联任何文章，并且您使用的 archiveList 标签没有指定 like="keywords" 或 like="relation"，或者这两者匹配失败，那么 archiveList 标签内部的 {% empty %} 代码块就会被执行。通常，我们会在 {% empty %} 中放置一段提示语，例如“暂无相关推荐”或“没有找到其他相关文章”，以避免页面出现空白。
3. “根据文档第一个关键词来获取相关的文档”具体是如何工作的？
当您使用 like="keywords" 参数时，安企CMS会智能地提取当前文章“文档关键词”字段中输入的第一个关键词。然后，系统会根据这个关键词，在整个内容库中查找