在日常的网站运营中，如何让用户在浏览完一篇文章后，能自然而然地发现更多感兴趣的内容，是提升用户体验、延长网站停留时间、甚至优化SEO效果的关键。安企CMS深知这一点，并提供了强大的模板标签功能，其中relatedArchive标签正是用于智能展示相关文章列表的利器。
relatedArchive标签：让您的相关文章列表更智能
relatedArchive标签的魅力在于它能够根据当前文章的上下文，自动或按我们指定的规则，推荐出一系列与正在浏览内容高度相关的文章。这不仅能有效引导用户进行深度阅读，构建站内高质量的内部链接，还能显著降低网站的跳出率，让访客在您的网站上停留更长时间。
需要明确的是，relatedArchive并非一个独立的标签名称，它实际上是archiveList（文档列表）标签的一种特殊用法，通过为其添加type="related"参数来激活相关文章的智能推荐功能。这个标签最常在文章或产品详情页中使用，因为关联性的逻辑需要一个“当前文档”作为参照。
安企CMS如何判断文章的“关联性”？
安企CMS在处理“相关文章”时，提供了灵活的逻辑来判断文章间的关联程度，您可以根据实际需求选择最合适的策略：
首先，当您不额外指定关联方式时，relatedArchive会采用默认关联逻辑。它会根据当前文档的ID，在同一个分类下智能地查找与之“临近”的文章。这里的“临近”通常指的是在发布时间或ID顺序上比较接近的文档，这种方式能确保推荐的文章与当前分类主题保持一致。
其次，如果您希望关联性更侧重于内容主题，可以利用文章的关键词进行匹配。通过设置like="keywords"参数，relatedArchive会优先根据当前文档的第一个关键词来获取相关的文档。这意味着，如果您在后台为文章精心设置了准确的关键词，系统就能更精准地推荐出主题相似的内容。
最后，对于那些需要高度精准控制关联内容的场景，安企CMS提供了手动设置的选项。您可以在后台的文档编辑界面，为每篇文章手动指定“相关文档”。此时，只需在标签中设置like="relation"，系统便会完全按照您的手动配置来展示相关文章列表，这对于需要强调特定内容或进行专题推广的场景尤其有用。
如何在模板中使用relatedArchive标签？
在您的文章详情页模板中，使用relatedArchive标签非常直观。以下是一个典型的代码示例，展示了如何获取并循环显示最多10篇相关文章的标题、链接和缩略图：
{# related 相关文档列表展示 #}
<div class="related-articles-section">
<h3>相关推荐</h3>
<ul>
{% archiveList archives with type="related" limit="10" %}
{% for item in archives %}
<li>
<a href="{{item.Link}}">
{% if item.Thumb %}
<img alt="{{item.Title}}" src="{{item.Thumb}}">
{% endif %}
<h5>{{item.Title}}</h5>
<p>{{item.Description|truncatechars:80}}</p> {# 截取描述前80个字符 #}
</a>
</li>
{% empty %}
<li>
抱歉，当前没有找到相关文章。
</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
在这个例子中：
{% archiveList archives with type="related" limit="10" %}：这行代码告诉安企CMS，我们想要获取一个文档列表，并且这个列表的类型是“相关文档”（type="related"），最多显示10篇（limit="10"）。{% for item in archives %}：由于relatedArchive返回的是一个文章列表，我们需要使用for循环来逐一遍历每篇文章。item是循环中的当前文章对象。{{item.Link}}、{{item.Title}}、{{item.Thumb}}、{{item.Description}}：这些是当前文章对象的常用属性，您可以根据需要调用，比如文章链接、标题、缩略图和描述。truncatechars:80过滤器则可以确保描述内容不会过长。{% empty %}：这是一个非常实用的for循环辅助标签，当archives列表为空，即没有找到任何相关文章时，它会显示empty块中的内容，避免页面出现空白。
掌握关键参数
为了更好地控制相关文章的显示，理解以下参数至关重要：
type="related"：这是激活相关文章功能的核心参数。limit="数字"：用于控制相关文章显示的最大数量，例如limit="5"将只显示5篇。like="keywords"：当您希望根据文章关键词进行关联时使用。like="relation"：当您希望使用后台手动设置的相关文章时使用。
值得注意的是，当type的值为related时，order（排序）参数将不被支持。系统会根据其内部的关联逻辑进行排序，以确保推荐的相关性。
通过灵活运用relatedArchive标签及其提供的多种关联逻辑，您将能为网站访客提供更加智能、个性化的内容推荐，极大地提升用户粘性和网站整体价值。
常见问题 (FAQ)
1. 为什么我设置了relatedArchive标签，但相关文章列表显示为空？
出现这种情况可能有几个原因：
- 非文档详情页：
relatedArchive标签必须在文档（文章/产品）详情页才能正常工作，因为它需要一个“当前文档”作为参照。如果在其他页面使用，列表可能为空。 - 无临近或匹配文档： 如果您使用的是默认关联（未指定
like参数），可能当前分类下没有足够“临近”的文档。如果您使用了like="keywords"，可能当前文档的关键词在其他文章中没有匹配项。 - 未手动关联： 如果您设置了
like="relation"，但忘记在后台文档编辑界面手动关联相关文章，列表自然会是空的。
2. relatedArchive标签与普通的archiveList标签有什么不同？
relatedArchive标签是archiveList标签的一个特定应用场景，主要区别在于：
- 目的不同：
relatedArchive专门用于“推荐与当前文档相关的文章”，其核心在于智能或手动地建立关联。而archiveList是一个更通用的标签，可以用于获取任何类型的文章列表（如最新文章、热门文章、指定分类文章等），需要您手动指定各种筛选和排序条件。 - 工作机制：
relatedArchive在工作时，会自动以当前文档为中心，寻找关联文档（同分类临近、关键词匹配或手动指定）。archiveList则完全依据您传入的categoryId、order、flag等参数来过滤和排序。 - 参数限制：
relatedArchive（即archiveList与type="related"结合使用时）不支持order参数，因为它有自己的关联排序逻辑。
3. 我可以同时使用关键词关联和手动关联吗？如果都设置了，哪个会生效？
在relatedArchive标签中，like参数只能指定一个值，即like="keywords"或like="relation"。如果您同时尝试设置或系统检测到冲突，通常会有一个优先级或只生效其中一个（具体行为请参考安企CMS的最新文档说明或实际测试）。为了避免混淆，建议您根据实际需求，明确选择一种关联逻辑来配置，以确保相关文章列表的展示符合预期。