如何在AnQiCMS模板中获取并显示友情链接列表？

在网站运营中，友情链接是提升网站权重、增加外部流量和优化用户体验的重要一环。安企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 %}

在大多数单站点情况下，这个参数是不需要手动设置的，系统会默认获取当前站点的友情链接。

将友情链接融入模板的实际考虑

1. 位置选择： 友情链接最常见的位置是网站的页脚（footer）、侧边栏（sidebar）或独立的“友情链接”页面。选择一个对用户和搜索引擎都友好的位置。
2. 样式定制： 默认情况下，模板标签只输出**的HTML结构。您需要根据网站的整体设计，通过CSS来为友情链接列表添加样式，如字体、颜色、布局等，确保它们美观且易于阅读。
3. 数量控制： 虽然友情链接有益，但并非越多越好。过多的友情链接可能分散页面权重，甚至可能被搜索引擎视为作弊行为。建议保持适度数量，并优先选择高质量、相关性强的链接。

通过上述步骤和代码示例，您应该能够轻松地在AnQiCMS模板中获取并显示友情链接列表，为您的网站增添更多价值。

常见问题 (FAQ)

1. 为什么我已经在后台添加了友情链接，但网站前台却没有显示？

   • 请检查您是否在模板文件中正确使用了linkList标签，并且标签内的{% for ... %}循环也正确编写。
   • 确认您的友情链接在后台是处于“启用”状态的。
   • 检查您的模板文件中是否包含类似 {% if friendLinks %} 这样的判断语句，如果列表为空，这段代码可能导致整个友情链接区域不显示。
   • 如果页面有缓存，尝试清除AnQiCMS的系统缓存。

2. 如何让友情链接在新窗口（新标签页）中打开？

   • 在您的<a>标签中添加target="_blank"属性即可。例如：<a href="{{item.Link}}" target="_blank">{{item.Title}}</a>。本文提供的示例代码中已经包含了target="_blank"。

3. 我可以在友情链接旁边显示管理员在后台填写的备注信息吗？

   • 可以的。友情链接的每个项目都包含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>。