在网站运营中，向读者推荐相关文章是提升用户体验、延长用户停留时间以及优化SEO的重要策略。当读者阅读完一篇文章后，如果能立即看到与当前内容高度相关的推荐，无疑会大大增加他们继续探索网站的兴趣。安企CMS深知这一需求，提供了强大而灵活的功能，帮助用户轻松实现这一目标。
AnqiCMS中的“相关文档”功能
安企CMS的核心优势之一在于其强大的内容管理和模板标签系统。要显示与当前文章相关的推荐文章列表，我们主要会用到archiveList这个模板标签。archiveList标签不仅可以用于显示常规的文章列表、分类文章列表，还特别支持显示“相关文档”，这正是我们所需的核心功能。
核心标签：archiveList 的应用
archiveList标签用于从数据库中检索文章数据并以列表形式展现。它拥有丰富的参数，可以帮助我们精确地控制文章的筛选、排序和展示。
基本用法：显示与当前文章相关的推荐列表
安企CMS的archiveList标签在结合type="related"参数后，能够智能地识别当前页面正在展示的文章，并自动从同一分类中查找与当前文章相似或临近的其他文章作为推荐。
以下是实现这一功能的模板代码示例：
<div class="related-articles-section">
<h3>相关推荐文章</h3>
<ul>
{% archiveList archives with type="related" limit="5" %}
{% for item in archives %}
<li>
<a href="{{ item.Link }}" title="{{ item.Title }}">
{% if item.Thumb %}
<img src="{{ item.Thumb }}" alt="{{ item.Title }}" class="related-thumb">
{% endif %}
<span class="related-title">{{ item.Title }}</span>
<span class="related-date">{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
</a>
</li>
{% empty %}
<li>暂无相关推荐文章。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
代码解析：
{% archiveList archives with type="related" limit="5" %}：这是核心标签。archives：您为推荐文章列表定义的变量名，您可以在{% for %}循环中使用它。type="related"：这个参数告诉安企CMS，我们想要获取的是与当前文章“相关”的文章。安企CMS会根据当前文章的分类、ID等信息自动进行匹配。limit="5"：限制推荐文章的数量为5篇。您可以根据页面布局和需求调整这个数字。
{% for item in archives %}：循环遍历获取到的推荐文章列表。item.Link：推荐文章的链接地址。item.Title：推荐文章的标题。item.Thumb：推荐文章的缩略图（如果有）。在后台文档编辑时上传的缩略图会在这里显示。stampToDate(item.CreatedTime, "2006-01-02")：使用stampToDate过滤器将文章的创建时间戳格式化为“年-月-日”的日期格式。
{% empty %}：这是一个非常实用的标签。如果archiveList没有找到任何匹配的推荐文章，{% empty %}和{% endfor %}之间的内容就会被显示，避免页面出现空白或错误提示，提高了用户体验。
更精准的推荐策略：基于关键词或手动关联
除了基于分类的自动推荐，archiveList标签还允许您通过like参数，进一步细化“相关”的定义。like参数需要与type="related"一同使用。
基于关键词的推荐 (
like="keywords") 如果您希望根据文章的关键词进行更精细的匹配，可以在archiveList标签中增加like="keywords"参数。安企CMS会根据当前文章设置的关键词，在同一模型下寻找其他包含这些关键词的文章。<div class="related-articles-by-keywords"> <h3>根据关键词推荐</h3> <ul> {% archiveList keywordArchives with type="related" like="keywords" limit="3" %} {% for item in keywordArchives %} <li><a href="{{ item.Link }}">{{ item.Title }}</a></li> {% empty %} <li>暂无根据关键词推荐的文章。</li> {% endfor %} {% endarchiveList %} </ul> </div>基于手动关联的推荐 (
like="relation") 在安企CMS的后台文档编辑界面，您可以手动关联其他文章作为推荐。这种方式最为精准，因为它完全由运营者控制。要调用这些手动关联的文章，可以使用like="relation"参数。<div class="related-articles-manual"> <h3>编辑精选推荐</h3> <ul> {% archiveList manualArchives with type="related" like="relation" limit="4" %} {% for item in manualArchives %} <li><a href="{{ item.Link }}">{{ item.Title }}</a></li> {% empty %} <li>暂无编辑精选推荐文章。</li> {% endfor %} {% endarchiveList %} </ul> </div>
灵活展示推荐文章信息
在上述示例中，我们主要展示了文章的标题、链接、缩略图和发布时间。实际上，item变量提供了更多文章的字段信息，您可以根据设计需求进行选择和组合：
item.Description：文章的简介或摘要。如果内容较长，可以结合truncatechars等过滤器进行截取，例如{{ item.Description|truncatechars:80 }}。item.Views：文章的浏览量，可以显示文章的热度。item.CategoryId：文章所属分类的ID，结合categoryDetail标签可以获取分类的名称和链接。item.Logo：文章封面首图（通常是较大的图片）。item.Images：文章的封面组图，这是一个数组，您可以通过循环展示多张图片。
示例：结合摘要和浏览量
<div class="related-articles-full">
<h3>更多相关推荐</h3>
<ul>
{% archiveList moreArchives with type="related" limit="6" %}
{% for item in moreArchives %}
<li>
<a href="{{ item.Link }}">
<h4 class="related-title">{{ item.Title }}</h4>
{% if item.Description %}
<p class="related-description">{{ item.Description|truncatechars:120 }}</p>
{% endif %}
<div class="related-meta">
<span>发布于：{{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
<span>阅读量：{{ item.Views }}</span>
</div>
</a>
</li>
{% empty %}
<li>暂无更多相关推荐。</li>
{% endfor %}
{% endarchiveList %}
</ul>
</div>
总结
利用安企CMS强大的archiveList标签和灵活的参数设置，您可以轻松地在当前文章页面展示多样化的推荐文章列表。无论是基于文章分类的智能推荐，还是依据关键词的精准匹配，甚至是运营者手动关联的精品内容，安企CMS都能提供简洁高效的实现方式。这些功能不仅有助于提升网站的内容深度和用户参与度，也能在搜索引擎优化方面发挥积极作用。
常见问题 (FAQ)
1. 为什么我的推荐文章列表没有显示任何内容？
- 检查文章属性： 请确保当前文章已设置所属分类。
type="related"模式主要依赖于文章的分类信息来查找相关内容。 - 内容数量： 确保您网站中有足够多的内容，尤其是同一分类下的文章数量。如果文章过少，可能无法找到合适的推荐。
- 关键词/关联设置： 如果您使用了
like="keywords"或like="relation"参数，请