作为一位资深的网站运营专家，我深知在当今全球化的数字世界里，拥有一个支持多语言的网站对于企业拓展市场、提升品牌影响力有多么重要。AnQiCMS（安企CMS）作为一款高效、灵活的内容管理系统，在这方面提供了出色的支持。它不仅能帮助我们构建多个独立的站点，还能让这些站点轻松地切换不同的语言，满足全球用户的需求。
今天，我们就来深入探讨AnQiCMS如何优雅地获取所有已配置的多语言站点列表，这对于实现网站的国际化布局和提供无缝的用户体验至关重要。
AnQiCMS的“多语言站点”概念
在AnQiCMS中，多语言的实现通常是基于其强大的多站点管理功能。这意味着您可以为每种语言配置一个独立的站点（或在逻辑上区分的子站），每个站点拥有自己的内容、模板和语言设置。这种架构的优势在于，它提供了极大的灵活性，让内容管理和本地化策略可以做到非常精细。
系统层面的“默认语言包支持”确保了后台操作界面的多语言化，而前台页面的多语言展示则依赖于您配置的各个语言站点以及模板中的相应调用。要实现一个功能完善的多语言网站，获取这些站点的列表是构建语言切换器、SEO优化（如hreflang标签）等功能的第一步。
核心功能：languages 标签揭秘
在AnQiCMS强大的模板标签体系中，有一个专门为多语言站点管理量身定制的标签，它就是——languages。这个标签能够帮助我们轻松地获取所有已配置的多语言站点列表，并将这些信息呈现在前端页面上。
当我们使用languages标签时，它会返回一个包含所有已配置的多语言站点信息的数组对象。每个站点信息都包含了丰富的细节，例如站点的语言名称（LanguageName）、语言代码（Language）、生动的语言表情符号（LanguageEmoji）和图标（LanguageIcon），当然，还有最重要的站点链接（Link）和站点本身的名称（Name）等。这些数据足以支持我们构建各种复杂的语言切换和SEO策略。
如何使用？
languages标签的用法非常直观，它无需任何额外参数，您只需在AnQiCMS模板文件中这样开启一个标签块：
{% languages websites %}
{# 循环输出每个站点信息 #}
{% for item in websites %}
{# 在这里使用 item 变量访问站点数据 #}
{{ item.LanguageName }} - {{ item.Link }}
{% endfor %}
{% endlanguages %}
在这里，websites是您为获取到的站点列表数据定义的变量名，您可以根据自己的习惯命名。item则是在for循环中代表每一个单独站点信息的变量。
实战应用：两种典型场景
掌握了languages标签后，我们就可以将其应用于实际的网站运营中，以下是两种最常见的应用场景。
1. 构建语言切换器（Language Switcher）
一个直观的语言切换器能够显著提升用户体验，让访问者根据自己的偏好选择网站语言。利用languages标签，我们可以轻松实现这一点。
假设我们希望在网站页眉处显示一个语言切换下拉菜单，用户点击后能跳转到对应语言的站点。
{%- languages websites %}
{%- if websites %}
<div class="language-switcher">
<span>切换语言：</span>
{%- for item in websites %}
<a href="{{item.Link}}" title="切换到 {{item.LanguageName}}">
{%- if item.LanguageIcon %}
<img src="{{item.LanguageIcon}}" alt="{{item.LanguageName}} 图标" class="language-icon" />
{%- else %}
{{item.LanguageEmoji}}
{% endif %}
{{item.LanguageName}}
</a>
{%- endfor %}
</div>
{%- endif %}
{%- endlanguages %}
在这段代码中：
- 我们首先通过
{% languages websites %}获取所有多语言站点列表，并将其存储在websites变量中。 {% if websites %}确保只有当存在多语言站点时才渲染切换器，避免页面出现空块。{% for item in websites %}遍历每个站点信息。item.Link提供了当前语言站点的URL，方便用户点击跳转。item.LanguageIcon或item.LanguageEmoji可以展示具象化的语言标识，提升视觉效果。item.LanguageName则显示了该语言的名称，清晰明了。
通过这段代码，您可以在网站的页眉、页脚或侧边栏等位置，优雅地展示一个语言选择器，让用户能够一目了然地切换到他们想要的语言版本。
2. 实现Hreflang标签（SEO优化）
对于多语言网站的搜索引擎优化（SEO），hreflang标签是不可或缺的。它告诉搜索引擎您的页面有哪些语言版本，从而确保向用户展示正确语言和地区的内容。这对于避免重复内容惩罚和提升国际SEO表现至关重要。languages标签可以非常方便地帮助我们动态生成这些标签。
您需要将以下代码放置在您网站模板的<head>区域内，例如在partial/header.html（如果您遵循AnQiCMS的模板结构的话）：
{%- languages websites %}
{%- for item in websites %}
<link rel="alternate" href="{{item.Link}}" hreflang="{{item.Language}}">
{%- endfor %}
{%- endlanguages %}
在这段代码中：
- 我们同样通过
{% languages websites %}获取站点列表。 item.Link用于指定对应语言页面的URL。item.Language则提供了ISO 639-1格式的语言代码（例如en代表英语，zh-CN代表简体中文），这是hreflang标签的关键属性。
这样，您的每个语言版本的页面都会自动包含指向其所有对应语言版本的hreflang链接，大大提升了网站的国际SEO能力。
深入理解：标签的特点与注意事项
- 无需参数，全局获取：
languages标签的简洁之处在于它不接受任何参数。这意味着它会获取AnQiCMS系统内所有已配置的多语言站点列表。如果您需要对列表进行筛选，例如只显示特定几种语言，您可以在for循环内部使用if条件进行判断。 - 返回数组对象： 理解
websites变量是一个数组至关重要，因此在使用时必须配合for循环来遍历其中的每一个站点对象。 - 丰富的数据字段： 每个站点对象都提供了包括链接、名称、语言代码和图标等在内的详细信息，这为前端开发提供了极大的便利性。
通过languages标签，AnQiCMS让多语言站点的管理和前端展示变得前所未有的简单和高效。作为网站运营者，充分利用这一功能，将能更好地服务全球用户，并优化您的国际化内容策略。
常见问题 (FAQ)
Q1: languages标签是否支持筛选，比如只获取英文和法文站点的列表？
A1: languages标签本身不提供筛选参数，它会获取所有已配置的多语言站点列表。如果您需要筛选，可以在获取到完整的websites数组后，在{% for %}循环内部使用{% if %}条件来判断item.Language或item.LanguageName，从而只展示您需要的语言站点。例如：{% if item.Language == 'en' or item.Language == 'fr' %}。
Q2: 获取到的站点列表数据包含哪些信息？
A2: 每个站点在for循环中通过item变量暴露了多项数据，包括但不限于：站点的语言名称（LanguageName）、语言代码（Language）、语言表情符号（LanguageEmoji）、语言图标（`Language