如何获取并显示与当前文章相关的推荐文章列表？

在网站运营中，当我们辛辛苦苦创作了一篇文章，自然希望它能被更多读者看到，并引导他们探索更多精彩内容。在文章详情页底部或侧边栏，巧妙地展示与当前文章相关的推荐内容，不仅能显著提升用户的阅读深度和停留时间，还能为搜索引擎优化（SEO）带来诸多益处。安企CMS（AnQiCMS）深知这一需求，提供了极其便捷且功能强大的标签，帮助我们轻松实现这一目标。

巧妙利用 archiveList 标签获取相关文章

在安企CMS中，要获取并显示与当前文章相关的推荐文章列表，我们主要会用到 archiveList 标签。这个标签是我们在模板中调用各类文章列表的核心工具，而它的一个特殊属性 type="related"，正是为实现文章关联推荐而设计的。

当我们在文章详情页的模板（通常是 detail.html）中使用 archiveList 标签并设置 type="related" 属性时，安企CMS便会智能地工作。它会根据当前文章的所在分类，以及文章内容、发布时间等因素，自动从同分类下的文章中筛选出与当前文章内容或发布时间点上最为接近或相似的文章，作为推荐列表展示。这种默认的智能推荐方式，为我们省去了大量手动筛选的麻烦。

例如，您可以在文章详情页的底部添加一个“相关推荐”模块，代码会是这样：

{# 在文章详情页的模板中，例如 detail.html #}
<div class="related-articles-section">
    <h3>相关推荐</h3>
    <ul>
    {% archiveList archives with type="related" limit="5" %}
        {% for item in archives %}
        <li>
            <a href="{{item.Link}}">{{item.Title}}</a>
            {# 还可以显示其他信息，例如发布时间、简介等 #}
            <p>{{item.Description|truncatechars:80}}</p>
            <span>发布于: {{stampToDate(item.CreatedTime, "2006-01-02")}}</span>
        </li>
        {% endfor %}
    {% endarchiveList %}
    </ul>
</div>

在这段代码中，limit="5" 表示我们希望推荐列表中显示5篇文章。您可以根据页面布局和需求调整这个数字。item.Link 会自动生成文章的访问链接，item.Title 则是文章标题。为了让列表更丰富，我们还额外显示了文章的简要描述（item.Description）和发布日期（item.CreatedTime，通过 stampToDate 格式化）。

深入定制：提升推荐精度

除了默认的智能推荐，安企CMS还提供了更精细的控制方式，以满足特定的运营需求。

1. 基于关键词关联的精准推荐

为了让推荐内容更精准地贴合读者的兴趣，安企CMS允许我们通过文章的关键词进行关联推荐。当您在后台编辑文章时，填写的关键词就派上了用场。archiveList 标签的 like="keywords" 属性会指示系统，优先寻找那些与当前文章共享相同关键词的文章。值得注意的是，系统会默认以当前文章的第一个关键词作为匹配依据来寻找相关内容。

如果您希望推荐列表更多地侧重于关键词匹配，可以这样修改代码：

{# 基于关键词的推荐 #}
<div class="related-by-keywords">
    <h3>更多您可能感兴趣的</h3>
    <ul>
    {% archiveList archives with type="related" like="keywords" limit="5" %}
        {% for item in archives %}
        <li>
            <a href="{{item.Link}}">{{item.Title}}</a>
            <small>{{item.Keywords}}</small>
        </li>
        {% endfor %}
    {% endarchiveList %}
    </ul>
</div>

通过 like="keywords"，系统会尝试找出与当前文章关键词相关的其他文章，从而提供更聚焦的推荐。

2. 手动关联指定文章的精选推荐

对于一些特殊情况，比如您想强力推荐几篇特定文章，或者手动创建一个专题系列的关联，安企CMS同样提供了灵活的解决方案。在文章后台编辑界面，有一个“相关文档”的设置项，您可以在这里手动关联其他文章。一旦设置完毕，您就可以在模板中通过 like="relation" 属性来调用这些手动指定的关联文章。

这种方式让运营者拥有了绝对的控制权，可以根据内容策略或商业需求，精准地展示推荐内容：

{# 手动指定相关文章 #}
<div class="editor-picks">
    <h3>编辑精选</h3>
    <ul>
    {% archiveList archives with type="related" like="relation" limit="5" %}
        {% for item in archives %}
        <li>
            <a href="{{item.Link}}">{{item.Title}}</a>
            {# 您可以在这里添加更多描述，突出精选理由 #}
        </li>
        {% endfor %}
    {% endarchiveList %}
    </ul>
</div>

这里，like="relation" 会确保只有您在后台手动关联的文章才会被显示出来。如果某篇文章没有手动关联，那么这个列表可能就不会显示内容。

结合图片，让推荐列表更具吸引力

一个好的推荐列表，除了文字标题，配上吸睛的缩略图会大大提升点击率。您可以在推荐列表中轻松地整合文章缩略图：

”`twig {# 结合图片和更多信息的推荐列表 #} <div class=“top-