在网站运营中，友情链接是提升网站权重、增加外部引流和促进合作关系的重要手段。一个管理便捷、展示灵活的友情链接功能对于任何内容管理系统都至关重要。AnQiCMS作为一个高效的内容管理系统，提供了直观的方式来管理和在模板中获取友情链接列表。

本文将详细介绍如何在AnQiCMS模板中获取并循环输出网站的友情链接列表，帮助您轻松实现网站间的互联互通。

AnQiCMS中的友情链接功能概览

在AnQiCMS中，友情链接的管理非常直观和高效。您可以在后台的“功能管理”菜单下找到“友情链接”选项，在这里可以方便地添加、编辑或删除各个友情链接。每个友情链接都可以设置名称、链接地址、备注，甚至还能灵活地选择是否添加nofollow属性，这对SEO优化尤其有帮助。

这些在后台配置好的友情链接数据，最终都需要在网站的前端模板中展示出来，供访问者点击。AnQiCMS为此提供了一个专门的模板标签，让您能够轻松地将这些数据呈现在页面上。

模板中的核心：linkList标签

要在模板中调用这些精心设置的友情链接，我们需要用到AnQiCMS内置的linkList标签。这个标签的作用是获取网站中所有的友情链接数据，并将其作为一个可供循环遍历的列表提供给模板。

linkList标签的基本用法如下：

{% linkList friendLinks %}
    {# 在这里处理友情链接列表 #}
{% endlinkList %}

其中，friendLinks是我们给获取到的友情链接列表起的一个变量名，您可以根据自己的习惯来命名。这个变量名将在标签内部用于引用友情链接数据。

通常情况下，您无需为linkList标签设置任何参数，系统会自动获取当前站点的友情链接。但如果您在AnQiCMS中启用了多站点管理功能，并需要获取其他站点的友情链接，可以通过siteId参数来指定，例如：{% linkList friendLinks with siteId="1" %}，其中"1"代表目标站点的ID。

一步步操作：获取并循环输出友情链接

获取并循环输出友情链接主要分为两个步骤：首先是使用linkList标签获取数据，然后是使用for循环遍历数据并构建HTML结构。

步骤一：使用linkList标签获取数据

如上所述，首先在您希望显示友情链接的模板位置（通常是页脚或其他侧边栏区域），使用linkList标签包裹您的代码块。

{% linkList friendLinks %}
    {# 循环输出友情链接的代码将放在这里 #}
{% endlinkList %}

如果您的网站当前没有任何友情链接，friendLinks变量将是一个空列表。在循环输出时，您可以选择处理这种情况，例如显示一条“暂无友情链接”的消息。

步骤二：遍历友情链接数据并构建HTML结构

获取到friendLinks列表后，我们就可以使用AnQiCMS模板引擎的for循环标签来逐一遍历并输出每一个友情链接的详细信息了。

在循环内部，每个友情链接数据都会被赋值给一个临时变量（例如item）。通过item，您可以访问到友情链接的各项属性，例如：

  • item.Title：友情链接的显示名称。
  • item.Link：友情链接的完整URL地址。
  • item.Remark：后台设置的备注信息（如果需要显示）。
  • item.Nofollow：一个布尔值，表示该链接是否在后台设置为nofollow（1表示是，0表示否）。

结合这些属性，我们可以构建出标准的HTML友情链接列表：

{% linkList friendLinks %}
    {% if friendLinks %} {# 判断是否有友情链接，避免空列表也输出容器 #}
    <div class="footer-links">
        <h3>友情链接</h3>
        <ul>
        {% for item in friendLinks %}
            <li>
                <a href="{{item.Link}}"
                   {% if item.Nofollow == 1 %}rel="nofollow"{% endif %}
                   target="_blank"
                   title="{{item.Remark}}">
                    {{item.Title}}
                </a>
            </li>
        {% endfor %}
        </ul>
    </div>
    {% else %}
    <p>暂无友情链接。</p>
    {% endif %}
{% endlinkList %}

在上面的代码示例中，我们做了一些优化：

  • 使用了一个if friendLinks判断来确保只有在存在友情链接时才输出整个容器，否则显示“暂无友情链接”的提示。
  • 为链接添加了target="_blank"属性，确保点击后在新窗口打开，不影响用户当前浏览。
  • 利用item.Nofollow == 1的判断，动态地为链接添加rel="nofollow"属性，这对于SEO管理外部链接非常重要。
  • 将item.Remark作为title属性添加到<a>标签中，当用户鼠标悬停时可以显示更多信息。

完整代码示例

将上述步骤整合起来，一个完整且实用的友情链接列表模板代码示例如下：

{# 在您希望显示友情链接的模板文件中粘贴以下代码，例如 footer.html #}

{% linkList friendLinks %}
    {% if friendLinks %}
    <div class="friendship-links-section">
        <h3 class="section-title">合作伙伴与友情链接</h3>
        <ul class="links-list">
        {% for item in friendLinks %}
            <li class="link-item">
                <a href="{{ item.Link }}"
                   {% if item.Nofollow == 1 %}rel="nofollow"{% endif %}
                   target="_blank"
                   title="点击访问 {{ item.Title }}{% if item.Remark %} - {{ item.Remark }}{% endif %}">
                    {{ item.Title }}
                </a>
            </li>
        {% endfor %}
        </ul>
    </div>
    {% else %}
    <div class="friendship-links-section">
        <p class="no-links-message">我们正在积极拓展合作，友情链接即将上线，敬请期待！</p>
    </div>
    {% endif %}
{% endlinkList %}

{# 您可以根据需要为 .friendship-links-section, .section-title, .links-list, .link-item, .no-links-message
等CSS类添加样式，以美化展示效果。 #}

这段代码不仅能够有效地获取并展示您的友情链接，还考虑了无链接时的友好提示，以及对SEO友好的nofollow属性处理。

优化友情链接展示的小贴士

  1. 样式美化：虽然代码已经提供了HTML结构，但美观的展示离不开CSS的加持。为div、ul、li和a标签添加合适的样式，使其与您的网站整体设计风格保持一致，提升用户体验。
  2. 合理放置：友情链接通常放置在网站的页脚区域，或者专门的“友情链接”页面。根据您的网站类型和用户习惯，选择最合适的展示位置。
  3. 注意nofollow属性：后台管理中的nofollow选项非常实用。对于那些您不想传递权重或者是不完全信任的外部链接，设置nofollow可以避免对您网站SEO产生负面影响。
  4. 定期维护：定期检查友情链接的有效性，删除失效链接，更新过时信息，并保持链接质量，这对网站的长期健康发展至关重要。

通过AnQiCMS的简洁模板标签和灵活的后台管理，您可以轻松地将友情链接功能集成到您的网站中，促进与其他网站的互联互通，为您的内容营销和SEO策略提供有力支持。

常见问题 (FAQ)

Q1: 我在AnQiCMS后台添加了友情链接，但前台页面没有显示，这是怎么回事？ A1: 如果后台已经成功添加并保存了友情链接，但前台未显示，请检查您的模板文件中是否已经正确使用了{% linkList friendLinks %}...{% endlinkList %}标签，并且确保friendLinks变量在循环中被正确遍历。此外，请清除AnQiCMS的系统缓存，有时缓存会导致更新不及时。

Q2: rel="nofollow"属性有什么作用，我应该什么时候使用它？ A2: rel="nofollow"是一个HTML属性，用于告诉搜索引擎不要将