如何在安企CMS的文档详情页显示相关推荐文档，并自定义推荐逻辑？

当访客在您的网站上阅读完一篇感兴趣的文档或浏览完一款产品介绍后，如果能及时获得更多相关的推荐内容，无疑会极大地提升他们的访问体验，延长停留时间，并促使他们深入探索网站的更多角落。安企CMS深知这一点，提供了灵活多样的功能，帮助您在文档详情页巧妙地展示相关推荐，并可以根据您的运营策略自定义推荐逻辑。

接下来，我们将详细探讨如何在安企CMS中实现这一功能。

理解安企CMS中的“相关推荐”

在安企CMS中，文档详情页面的相关推荐主要依赖于archiveList这个强大的标签。通过合理配置它的参数，您可以轻松实现多种推荐策略。最直接的方式是使用type="related"参数，让系统智能地查找与当前文档最接近的内容。

1. 基础相关文档推荐

首先，您需要定位到您当前使用的模板中，通常文档详情页的模板文件路径类似于/template/{模型table}/detail.html。例如，如果是文章模型，可能是/template/article/detail.html。

在这个模板文件中，您可以在文档内容下方或侧边栏等位置，插入如下代码片段，用于显示系统默认的相关文档推荐：

<div class="related-documents">
    <h3>相关推荐</h3>
    <ul>
        {% archiveList relatedDocs with type="related" limit="5" %}
            {% for item in relatedDocs %}
            <li>
                <a href="{{ item.Link }}">{{ item.Title }}</a>
            </li>
            {% endfor %}
        {% empty %}
            <li>暂无相关推荐。</li>
        {% endarchiveList %}
    </ul>
</div>

这段代码会获取与当前文档（系统会自动识别当前文档ID）相关的5篇文档。type="related"参数让安企CMS的后台逻辑自动判断哪些内容是“相关”的，通常会基于同分类、同关键词等因素进行智能匹配。

自定义推荐逻辑：让推荐更“懂”您的用户

安企CMS的archiveList标签不仅限于默认的相关推荐，它还提供了like参数以及其他丰富的筛选条件，让您可以更精细地控制推荐内容。

2. 基于关键词的智能推荐

如果您希望推荐内容更侧重于文档的关键词匹配度，可以利用like="keywords"参数。这意味着系统会根据当前文档的关键词，去匹配其他文档的关键词，找出内容主题更一致的推荐。

后台设置： 在安企CMS后台编辑文档时，务必在“文档关键词”字段中填写准确且有代表性的关键词，多个关键词之间使用英文逗号,分隔。关键词的质量直接影响推荐的准确性。

模板代码：

<div class="related-by-keywords">
    <h3>更多您可能感兴趣的</h3>
    <ul>
        {% archiveList keywordsRelated with type="related" like="keywords" limit="5" %}
            {% for item in keywordsRelated %}
            <li>
                <a href="{{ item.Link }}">{{ item.Title }}</a>
            </li>
            {% endfor %}
        {% empty %}
            <li>暂无更多相关内容。</li>
        {% endarchiveList %}
    </ul>
</div>

3. 基于后台手动关联的精准推荐

有时，您可能希望手动指定某些文档之间的关联性，例如产品系列的推荐、特定专题文章的推荐等。安企CMS提供了在后台手动设置“相关文档”的功能，您可以通过like="relation"参数来调用这些手动关联的内容。

后台设置： 在安企CMS后台编辑文档时，您通常会在“其他参数”或类似的折叠框中找到“相关文档”的选项。在这里，您可以手动搜索并选择与当前文档相关的其他文档。这种方式提供了最高的推荐精度，完全由运营者掌控。

模板代码：

<div class="manually-linked-recommendations">
    <h3>为您精选</h3>
    <ul>
        {% archiveList manualRelated with type="related" like="relation" limit="5" %}
            {% for item in manualRelated %}
            <li>
                <a href="{{ item.Link }}">{{ item.Title }}</a>
            </li>
            {% endfor %}
        {% empty %}
            <li>运营者暂未手动配置相关推荐。</li>
        {% endarchiveList %}
    </ul>
</div>

4. 基于分类、推荐属性或其他条件的灵活推荐

除了type="related"带来的智能或手动关联，您还可以使用type="list"结合其他参数，创建出基于分类、推荐属性（如“头条”、“推荐”）、甚至浏览量等指标的推荐列表。这是一种更通用的列表调用方式，但同样可以作为相关推荐的补充。

后台设置：

• 文档分类： 在发布或编辑文档时，确保文档所属分类准确无误。
• 推荐属性： 在文档编辑页面，可以为文档勾选“推荐属性”，如“推荐[c]”、“幻灯[f]”等。
• 浏览量： 这是一个自动生成的指标，无需额外设置。

模板代码示例（推荐当前分类下浏览量最高的5篇，但排除当前文档）：

首先，我们需要获取当前文档的分类ID和文档ID，以便进行筛选和排除。

”`twig {% archiveDetail currentArchive with name=“Id” %} {# 获取当前文档的ID #} {% archiveDetail currentCategory with name=“CategoryId” %} {# 获取当前文档的分类ID #