在网站运营中，友情链接是提升网站权重、增加外部流量和优化用户体验的重要一环。安企CMS（AnQiCMS）深知这一点，因此在系统设计中提供了便捷的友情链接管理功能，并支持在模板中灵活调用和展示。本文将详细介绍如何在您的AnQiCMS模板中获取并显示友情链接列表。
友情链接的管理：从后台开始
在开始模板调用之前，首先需要确保您的网站后台已经配置了友情链接。安企CMS的友情链接管理功能位于功能管理模块下。在这里，您可以添加新的友情链接，编辑现有链接的信息，包括链接的名称（Title）、目标地址（Link）、简短的备注（Remark）以及是否启用“nofollow”属性（Nofollow）。
“nofollow”属性对于SEO非常重要，它告诉搜索引擎不要追踪该链接，这在链接到外部网站但不希望传递自身权重时非常有用。AnQiCMS在后台为您提供了勾选此选项的便利。
这些在后台配置好的友情链接，便是我们将在前端模板中获取并展示的数据源。
模板中获取友情链接的核心标签：linkList
AnQiCMS提供了一个名为linkList的专用模板标签，用于在您的网站前端获取并显示后台配置的友情链接。这个标签设计得非常直观，让您可以轻松地将链接数据集成到任何模板位置。
基本语法如下：
{% linkList 变量名称 %}
{# 在这里放置循环代码来遍历和显示友情链接 #}
{% endlinkList %}
在这里，变量名称是一个您自定义的、用于存储友情链接列表的名称，例如 friendLinks。linkList标签会获取所有已启用的友情链接，并将它们作为列表对象赋予给您指定的变量。
详细讲解 linkList 标签的使用
由于linkList标签会将友情链接作为一个列表（或称数组）返回，因此，您需要使用AnQiCMS模板引擎提供的for循环标签来逐一遍历并显示每一个友情链接。
每个友情链接项目（item）都包含以下可用的信息：
item.Title：友情链接的显示名称。item.Link：友情链接的目标URL地址。item.Remark：友情链接的备注信息，通常用于简短的描述或提示。item.Nofollow：一个布尔值（或数字0/1），表示该链接是否设置了rel="nofollow"属性。当item.Nofollow为1时，表示已设置。
下面是一个完整的代码示例，演示如何在您的模板中获取并显示友情链接：
{# 使用linkList标签获取友情链接列表，并将其存储在名为friendLinks的变量中 #}
{% linkList friendLinks %}
{# 首先判断friendLinks变量是否存在且不为空，以避免在没有链接时显示空区域 #}
{% if friendLinks %}
<div class="footer-links">
<h3>友情链接</h3>
<ul class="friendship-links-list">
{# 遍历friendLinks中的每一个友情链接项目，每个项目命名为item #}
{% for item in friendLinks %}
<li>
{# 创建a标签，设置链接地址为item.Link，显示文本为item.Title #}
{# 使用target="_blank"确保链接在新窗口打开，提高用户体验 #}
{# 根据item.Nofollow的值判断是否添加rel="nofollow"属性，保障SEO策略 #}
<a href="{{item.Link}}" {% if item.Nofollow == 1 %} rel="nofollow"{% endif %} target="_blank">{{item.Title}}</a>
{# 如果存在备注信息，可以将其显示在链接旁边，通常用span标签包裹并添加样式 #}
{% if item.Remark %}
<span class="link-remark">{{item.Remark}}</span>
{% endif %}
</li>
{% endfor %}
</ul>
</div>
{% endif %}
{% endlinkList %}
将这段代码放置在您希望显示友情链接的模板文件（例如页脚文件 partial/footer.html 或侧边栏文件 partial/sidebar.html）中，保存后即可在前台看到效果。您可以通过修改HTML结构和添加CSS样式来美化友情链接的显示效果，使其与您的网站设计风格保持一致。
多站点场景下的siteId参数
如果您正在使用AnQiCMS的多站点管理功能，并且希望在某个站点的模板中调用其他站点的友情链接列表，可以通过siteId参数来实现。例如，如果您想调用ID为2的站点的友情链接：
{% linkList friendLinks with siteId="2" %}
{# 循环显示 ID 为 2 的站点的友情链接 #}
{% endlinkList %}
在大多数单站点情况下，这个参数是不需要手动设置的，系统会默认获取当前站点的友情链接。
将友情链接融入模板的实际考虑
- 位置选择： 友情链接最常见的位置是网站的页脚（footer）、侧边栏（sidebar）或独立的“友情链接”页面。选择一个对用户和搜索引擎都友好的位置。
- 样式定制： 默认情况下，模板标签只输出**的HTML结构。您需要根据网站的整体设计，通过CSS来为友情链接列表添加样式，如字体、颜色、布局等，确保它们美观且易于阅读。
- 数量控制： 虽然友情链接有益，但并非越多越好。过多的友情链接可能分散页面权重，甚至可能被搜索引擎视为作弊行为。建议保持适度数量，并优先选择高质量、相关性强的链接。
通过上述步骤和代码示例，您应该能够轻松地在AnQiCMS模板中获取并显示友情链接列表，为您的网站增添更多价值。
常见问题 (FAQ)
为什么我已经在后台添加了友情链接，但网站前台却没有显示？
- 请检查您是否在模板文件中正确使用了
linkList标签，并且标签内的{% for ... %}循环也正确编写。 - 确认您的友情链接在后台是处于“启用”状态的。
- 检查您的模板文件中是否包含类似
{% if friendLinks %}这样的判断语句，如果列表为空，这段代码可能导致整个友情链接区域不显示。 - 如果页面有缓存，尝试清除AnQiCMS的系统缓存。
- 请检查您是否在模板文件中正确使用了
如何让友情链接在新窗口（新标签页）中打开？
- 在您的
<a>标签中添加target="_blank"属性即可。例如：<a href="{{item.Link}}" target="_blank">{{item.Title}}</a>。本文提供的示例代码中已经包含了target="_blank"。
- 在您的
我可以在友情链接旁边显示管理员在后台填写的备注信息吗？
- 可以的。友情链接的每个项目都包含
item.Remark字段。您只需在<a>标签附近，使用{{item.Remark}}来显示备注信息。例如：<li><a href="{{item.Link}}" target="_blank">{{item.Title}}</a> {% if item.Remark %}<span class="link-remark">（{{item.Remark}}）</span>{% endif %}</li>。
- 可以的。友情链接的每个项目都包含