如何在AnQiCMS中展示友情链接列表？

在AnQiCMS中管理和展示友情链接，对于提升网站的搜索引擎优化（SEO）表现、增加外部链接数量以及促进网站之间的流量互导都非常重要。AnQiCMS作为一个功能完善的内容管理系统，提供了直观的后台操作和灵活的模板标签，让您能够轻松地在网站上展示友情链接列表。

一、在AnQiCMS后台管理友情链接

首先，您需要在AnQiCMS的后台添加和管理友情链接。系统提供了专门的模块来处理这一需求，操作过程非常简单：

1. 登录后台： 使用您的管理员账号登录AnQiCMS后台管理系统。
2. 导航至友情链接管理： 在左侧的菜单栏中，找到并点击“功能管理”菜单项。在这里，您会看到一个名为“友情链接”的子菜单。点击进入该页面。
3. 添加或编辑友情链接：
   • 在友情链接管理页面，您可以查看所有已添加的友情链接。
   • 点击“添加友情链接”按钮，您将看到一个表单，需要填写友情链接的相关信息，例如：
     • 链接名称 (Title)： 这是友情链接将显示的文字，通常是对方网站的名称。
     • 链接地址 (Link)： 对方网站的完整URL地址，务必以http://或https://开头。
     • 备注 (Remark)： 可以填写一些内部备注信息，不会在前台显示。
     • Nofollow： 这是一个重要的SEO属性。如果您不希望将自己网站的权重传递给对方网站，建议勾选此选项。它会在链接中添加rel="nofollow"属性。
   • 填写完成后，点击保存即可。您也可以随时编辑或删除已有的友情链接。

二、在网站模板中展示友情链接列表

完成了后台的友情链接配置，接下来就是在网站前台展示它们了。AnQiCMS采用类似Django模板引擎的语法，通过特定的模板标签就能轻松实现。

1. 认识linkList标签： AnQiCMS为友情链接提供了专门的linkList模板标签。这个标签的作用就是从后台数据库中提取所有已配置的友情链接数据。它的基本使用方法是： {% linkList friendLinks %}...{% endlinkList %}

   这里的friendLinks是一个变量名，您可以随意命名，系统会将查询到的友情链接数据以一个数组的形式赋值给这个变量。

   linkList标签支持一个可选参数siteId。如果您使用的是AnQiCMS的多站点管理功能，并且希望调用特定站点下的友情链接，可以通过siteId="X"来指定（其中X是站点ID）。对于单站点用户，通常无需设置此参数。

2. 遍历友情链接数据： 一旦您通过linkList标签获取到友情链接数据，就可以使用for循环来遍历friendLinks数组，逐一展示每个友情链接的详细信息。在循环内部，item变量代表当前遍历到的每一个友情链接对象，它包含以下常用字段：

   • item.Title: 友情链接的名称。
   • item.Link: 友情链接的URL地址。
   • item.Remark: 友情链接的备注信息（通常不用于前台显示）。
   • item.Nofollow: 一个布尔值（1表示是，0表示否），指示该链接是否带有nofollow属性。

3. 编写模板代码： 以下是一个完整的模板代码示例，展示了如何在您的网站上优雅地列出友情链接：

   {% linkList friendLinks %}
   {% if friendLinks %} {# 检查是否有友情链接，避免空列表显示标题 #}
   <div class="friend-links-section">
       <h3>友情链接</h3>
       <ul class="friend-links-list">
           {% for item in friendLinks %}
           <li>
               <a href="{{item.Link}}" 
                  {% if item.Nofollow == 1 %} rel="nofollow"{% endif %} {# 根据后台设置添加nofollow属性 #}
                  target="_blank" {# 建议新窗口打开，提升用户体验 #}
                  title="{{item.Title}}"> {# 鼠标悬停显示链接名称 #}
                  {{item.Title}}
               </a>
           </li>
           {% endfor %}
       </ul>
   </div>
   {% endif %}
   {% endlinkList %}
   

   代码说明：

   • {% linkList friendLinks %}：获取所有友情链接并赋值给friendLinks变量。
   • {% if friendLinks %}：这是一个非常实用的判断，只有当存在友情链接时，才显示“友情链接”标题和列表，避免在没有链接时出现空白标题。
   • <h3>友情链接</h3> 和 <ul class="friend-links-list">：这些是HTML结构和CSS类名，您可以根据自己的网站设计进行调整。
   • {% for item in friendLinks %}：循环遍历每个友情链接。
   • href="{{item.Link}}"：设置链接地址。
   • {% if item.Nofollow == 1 %} rel="nofollow"{% endif %}：根据后台的设置，动态地为链接添加nofollow属性。
   • target="_blank"：让友情链接在新标签页中打开，提高用户浏览体验。
   • title="{{item.Title}}"：当用户鼠标悬停在链接上时，显示链接名称，增加可访问性。
   • {{item.Title}}：显示友情链接的文字。

三、将模板代码放置到合适的位置

您通常会将这段友情链接的模板代码放置在网站的页脚、侧边栏或专门的友情链接页面。

• 页脚 (Footer)： 如果您的模板有一个公共的页脚文件（例如partial/footer.html或bash.html），您可以将这段代码放入其中。这样，所有页面都会自动显示友情链接。
• 侧边栏 (Sidebar)： 同样，如果您的网站有侧边栏模板文件（例如partial/sidebar.html），也可以将其放置在那里。
• 独立页面： 您可以创建一个独立的页面，专门用于展示所有友情链接。在AnQiCMS后台的“页面资源”->“页面管理”中创建一个新页面，并将上述模板代码嵌入该页面的内容或其自定义模板中。

使用AnQiCMS提供的include标签，您可以将这些代码片段灵活地引入到网站的不同位置。例如，在您的主模板文件中，您可以使用{% include "partial/footer.html" %}来引入包含友情链接的页脚。

通过以上步骤，您就可以在AnQiCMS中轻松地管理和展示友情链接列表了，这不仅能帮助您的网站更好地进行外部推广，也能为您的访问者提供更丰富的导航信息。

常见问题解答 (FAQ)

问：我添加了友情链接，但是前台页面没有显示出来，这是为什么？

答： 遇到这种情况，您可以从几个方面进行排查。首先，请确保您在AnQiCMS后台“功能管理”->“友情链接”中确实添加了链接。其次，检查您的网站模板文件是否正确使用了{% linkList friendLinks %}和{% for item in friendLinks %}这样的代码来调用。最后，请尝试清除网站缓存（后台左侧菜单最下方有“更新缓存”按钮），因为系统可能会缓存旧的页面内容，导致新添加的链接未能及时显示。

问：rel="nofollow"属性有什么作用，我应该为友情链接添加它吗？

答： rel="nofollow"属性是告诉搜索引擎不要将您网站的权重传递给被链接的网站。在SEO实践中，当您链接到一个外部网站，但又不希望被搜索引擎认为您在“担保”或“推荐”该网站时，通常会使用nofollow。对于友情链接，尤其是那些您无法完全控制内容质量