在使用AnQiCMS搭建和管理网站时，如何有效地在模板中调用并展示友情链接列表是一个常见且实用的需求。友情链接不仅能帮助提升网站的SEO表现，还能为用户提供更多有价值的外部资源。AnQiCMS强大的模板引擎结合其后台功能，让这一操作变得非常直接。

管理友情链接：从后台开始

在将友情链接显示到网站前端之前，我们首先需要在AnQiCMS的后台进行设置。AnQiCMS提供了一套直观的友情链接管理功能，让你可以轻松添加、编辑和管理你的链接列表。

登录AnQiCMS后台，在左侧导航栏找到“功能管理”，然后点击“友情链接管理”。在这里，你可以看到已有的友情链接列表，并可以进行添加新链接的操作。

当你添加一个新的友情链接时，通常需要填写以下信息：

  • 链接名称：这是友情链接在网站前端显示的名字，应简洁明了，能清晰表达链接指向的内容。
  • 链接地址：这是友情链接指向的完整URL，务必确保其准确无误。
  • 备注：可以填写一些内部说明，方便管理，通常不会在前台显示。
  • Nofollow属性：这是一个非常重要的选项。勾选“nofollow”表示告诉搜索引擎不要追踪这个链接，也不要将你网站的权重传递给它。这对于避免不相关的链接影响你网站的SEO，或者当链接指向的内容你并不完全信任时，非常有用。

完成这些设置后，保存链接，它就成功添加到你的友情链接库中了。

在AnQiCMS模板中调用友情链接

配置好后台的友情链接后，下一步就是在网站前端的模板中将它们展示出来。AnQiCMS的模板系统采用了类似Django模板引擎的语法，提供了专门的标签来方便地获取数据。

要显示友情链接列表，我们需要用到 linkList 标签。这个标签专门设计用于获取后台配置的友情链接数据。

它的基本使用方式是：

{% linkList friendLinks %}
    {# 在这里放置循环代码来显示友情链接 #}
{% endlinkList %}

在这里，friendLinks 是你自定义的一个变量名，用于在标签内部接收友情链接的数据列表。这个 linkList 标签会返回一个包含所有友情链接信息的数组（或称作切片）对象，每个元素代表一个友情链接。

我们可以通过 for 循环来遍历这个 friendLinks 变量，并依次显示每个链接的详细信息。同时，为了确保只有当有友情链接存在时才渲染HTML结构，我们可以使用 if 条件判断。

让我们看一个具体的例子，如何在模板中组织代码来显示友情链接：

{% linkList friendLinks %}
    {% if friendLinks %}
    <div class="footer-links">
        <h4>友情链接</h4>
        <ul>
            {% for item in friendLinks %}
            <li>
                <a href="{{item.Link}}" {% if item.Nofollow == 1 %} rel="nofollow"{% endif %} target="_blank">{{item.Title}}</a>
                {% if item.Remark %}<span class="link-remark">{{item.Remark}}</span>{% endif %}
            </li>
            {% endfor %}
        </ul>
    </div>
    {% endif %}
{% endlinkList %}

我们来解析一下这段代码：

  • {% linkList friendLinks %} 和 {% endlinkList %}：这是调用友情链接标签的开始和结束。它告诉AnQiCMS获取友情链接数据并将其赋值给 friendLinks 变量。
  • {% if friendLinks %}：这是一个非常实用的判断，它检查 friendLinks 列表是否为空。只有当后台确实添加了友情链接时，才会渲染其内部的HTML结构，避免在没有链接时显示空的标题或列表。
  • <h4>友情链接</h4> 和 <ul>...</ul>：这是我们为友情链接列表定义的HTML结构，你可以根据自己网站的样式需求进行调整。
  • {% for item in friendLinks %}：这个 for 循环会遍历 friendLinks 列表中的每一个友情链接。在每一次循环中，当前链接的数据会被赋值给 item 变量。
  • <li>...</li>：列表项，用于承载单个友情链接的信息。
  • {{item.Link}}：显示当前友情链接的URL地址。
  • {% if item.Nofollow == 1 %} rel="nofollow"{% endif %}：这是一个条件判断，如果后台设置了该链接为“nofollow”，这里就会自动添加 rel="nofollow" 属性。这是SEO优化的重要细节。
  • target="_blank"：通常会为友情链接添加此属性，使链接在新标签页中打开，提高用户体验，避免访客离开你的网站。
  • {{item.Title}}：显示当前友情链接的名称。
  • {% if item.Remark %}<span class="link-remark">{{item.Remark}}</span>{% endif %}：如果后台为该链接填写了备注，这里会将其显示出来。

通过这样的代码结构，你就可以灵活地在AnQiCMS模板中调用和展示友情链接列表了。通常，友情链接会放置在网站的页脚部分，或者是一个独立的“友情链接”页面上。

小贴士与**实践

  1. 模板文件位置：通常，友情链接的代码片段可以放在 partial/footer.html 这样的公共文件里，然后通过 {% include "partial/footer.html" %} 的方式在其他模板中引用，保持代码的模块化。
  2. 样式美化：上面的HTML代码只是一个基础结构，你可以通过自定义CSS样式来美化友情链接的显示，使其与你的网站整体风格保持一致。
  3. 多站点调用：如果你使用了AnQiCMS的多站点管理功能，并且希望调用特定站点的友情链接，可以在 linkList 标签中添加 siteId 参数，例如 {% linkList friendLinks with siteId="2" %}，来指定获取ID为2的站点的友情链接。不过，对于大多数单站点用户来说，无需指定此参数。

通过以上步骤和技巧，你将能熟练地在AnQiCMS网站模板中管理和展示友情链接，为你的网站增添一份实用价值。

常见问题 (FAQ)

1. 问：友情链接的 rel="nofollow" 属性有什么用？ 答：rel="nofollow" 属性是告诉搜索引擎不要将你网站的“权重”或“信任度”传递给这个链接所指向的页面。这通常用于你不想为外部链接背书，或者链接是广告、用户生成内容等场景，有助于防止不相关的链接影响你网站的SEO表现，避免潜在的惩罚风险。

2. 问：我在后台添加了友情链接，但前台页面没有显示出来，可能是什么原因？ 答：这可能是由几个原因造成的。首先，请检查你的模板文件中是否正确使用了 {% linkList friendLinks %} 标签，并且其内部的 for 循环结构是否完整。其次，确认你是否清除了AnQiCMS的系统缓存（通常在后台有“更新缓存”选项），因为模板更改和数据更新可能需要刷新缓存才能生效。最后，检查你添加的友情链接是否被设置为显示状态（如果后台有此选项）。

3. 问：我能否为网站的不同页面或不同的分类显示不同的友情链接列表？ 答：AnQiCMS的 linkList 标签目前主要用于获取全局的友情链接列表，它没有直接提供按分类ID或其他页面属性进行过滤的参数。如果需要实现这种需求，你可以考虑在后台“友情链接管理”中对链接进行分类，并在模板中通过 if 语句结合 item.Remark 字段或其他自定义逻辑来手动筛选和展示。或者，如果你对模板开发非常熟悉，也可以考虑通过内容模型或单页面功能，来创建多个“友情链接列表”，然后根据页面ID或分类ID调用不同的内容。