创建新的导航类别后，如何在模板中准确调用该类别下的导航链接？

AnQiCMS 作为一款高效的内容管理系统，其核心优势之一在于其强大的内容组织与模板定制能力。作为一名精通 AnQiCMS 运营的网站人员，我深知灵活的导航系统对于用户体验和网站结构优化的重要性。当您在后台创建了新的导航类别，并希望将其精准呈现在网站前端模板中时，AnQiCMS 提供了直观且强大的模板标签来满足这一需求。

理解安企CMS的导航管理机制

在 AnQiCMS 的管理后台，导航系统是高度可配置的。您可以访问“后台设置”下的“导航设置”来管理网站的导航结构。这里不仅有系统默认的主导航，还允许您通过“导航类别管理”创建自定义的导航区域。例如，除了常规的顶部导航，您可能还需要一个专为页脚设计、侧边栏展示或特定营销活动使用的导航。

创建新的导航类别是一个非常简单的过程：在“导航类别管理”页面，点击“新增导航类别”，然后给您的新导航类别（比如“页脚导航”）命名并保存。保存后，系统会为这个新的类别分配一个唯一的标识符，即 typeId。随后，您就可以像管理其他导航一样，为这个新类别添加具体的导航链接了。这些链接可以是指向站内文章分类的“分类页面链接”，指向特定内容的“内置链接”，或是指向外部网站的“外部链接”，充分满足您的内容展示需求。

核心：调用自定义导航的关键标签navList

在 AnQiCMS 的模板体系中，navList 标签是用于获取并渲染导航列表的核心工具。这个标签设计得非常灵活，能够根据您的需求精确地调取任何一个已定义的导航类别。navList 标签的强大之处在于它的 typeId 参数，这是将后台创建的特定导航类别与前端模板关联起来的桥梁。当您在后台创建了一个新的导航类别后，系统会为它分配一个 typeId。在模板中，您只需要指定这个 typeId，navList 标签就能准确地获取到该类别下的所有导航链接。

navList 标签的使用方法通常为 {% navList 变量名称 with typeId="您的导航类别ID" %}，并以 {% endnavList %} 结束。在标签内部，您可以使用 for 循环来遍历获取到的导航项目。每个导航项目（在循环中通常命名为 item）都包含了一系列有用的属性，如 Title（导航标题）、Link（导航链接）、IsCurrent（是否当前页面链接），以及用于处理多级导航的 NavList 等。

在模板中精确调用新导航类别的步骤

要将您在 AnQiCMS 后台创建的新导航类别显示在网站前端，您需要遵循以下步骤：

首先，在您的 AnQiCMS 后台，进入“后台设置” -> “导航设置”。在“导航类别管理”部分，找到您刚才创建的新导航类别（例如“页脚导航”），并记录下它所对应的 typeId。这个 ID 是系统自动生成的，是调用该导航的唯一标识。假设这个 typeId 是 2（默认导航通常是 1，新创建的会是其他数字）。接下来，确保您已经为这个新的导航类别添加了至少一个导航链接。

然后，打开您希望显示这个导航的模板文件。AnQiCMS 的模板文件通常位于 /template 目录下您的主题文件夹中。例如，如果您想在网站的页脚显示这个导航，您可能需要编辑 partial/footer.html 或 index.html 等文件。在您希望显示导航的位置，插入 navList 标签，并通过 typeId 参数指定您记录下的导航类别 ID。

一个典型的调用示例会是这样：

<nav class="footer-nav">
    <ul>
        {% navList footerNavs with typeId="2" %} {# 假设您的“页脚导航”的 typeId 是 2 #}
        {%- for item in footerNavs %}
        <li class="footer-nav-item {% if item.IsCurrent %}active{% endif %}">
            <a href="{{ item.Link }}" title="{{ item.Title }}">{{item.Title}}</a>
            {%- if item.NavList %} {# 如果存在子导航 #}
            <ul class="sub-footer-nav">
                {%- for subItem in item.NavList %}
                <li class="sub-footer-nav-item {% if subItem.IsCurrent %}active{% endif %}">
                    <a href="{{ subItem.Link }}" title="{{ subItem.Title }}">{{subItem.Title}}</a>
                </li>
                {% endfor %}
            </ul>
            {% endif %}
        </li>
        {% endfor %}
        {% endnavList %}
    </ul>
</nav>

在这个示例中，footerNavs 是您为导航列表定义的变量名，typeId="2" 则确保了调取的是您新创建的“页脚导航”类别下的链接。通过 for 循环遍历 footerNavs 中的每个 item，您就可以访问 item.Title 和 item.Link 来生成导航链接了。同时，通过 item.IsCurrent 属性，您可以为当前访问页面对应的导航项添加特殊的 CSS 类（例如 active），从而提升用户对当前位置的感知。如果您的导航类别支持二级导航，item.NavList 属性也会包含子导航列表，您可以嵌套 for 循环来渲染它们。

完成模板修改后，保存文件。如果您的 AnQiCMS 启用了模板缓存，您可能需要到后台的“更新缓存”功能中清理一下缓存，以确保修改能够即时生效。刷新您的网站页面，您会发现新的导航类别已经按照您的设计呈现在前端了。

**实践与注意事项

在实际操作中，为了更好地管理和维护网站，建议为不同的导航类别使用清晰明确的命名，并在模板中准确对应 typeId。同时，利用 item.SubTitle 或 item.Description 等属性，您可以为导航链接添加更多辅助信息，以丰富用户体验。在多站点环境下，navList 标签还支持 siteId 参数，允许您调取特定站点下的导航数据，这对于管理拥有多个子站或多语言站点的企业而言尤为重要。

通过这种方式，AnQiCMS 极大地简化了自定义导航的创建与调用流程，让网站运营者能够更专注于内容的呈现和用户体验的优化，而非繁琐的代码编写。

常见问题 (FAQ)

如何确定我新创建的导航类别的 typeId？ AnQiCMS 后台在您创建新的导航类别时，虽然通常不会直接显示 typeId。您可以先创建一个新的导航类别并为其添加一些链接。然后，您可以通过检查数据库中与导航相关的表（例如 nav_type 或类似的表结构，具体表名可能因版本而异），或者在某些情况下，通过查看后台页面源代码，来找到这个新的导航类别所对应的 ID。最直接的方法是在“导航设置”页面，点击编辑您的新导航类别，通常 URL 中会包含该导航类别的 ID。

我的导航链接在模板中没有显示，应该如何排查？ 首先，请检查 typeId 是否正确。确保您在 navList 标签中使用的 typeId 与后台实际创建的导航类别 ID 完全一致。其次，确认您所调用的导航类别下确实已经添加了导航链接。如果链接为空，前端自然不会显示任何内容。此外，检查模板文件路径是否正确，以及是否有语法错误导致模板解析失败。最后，别忘了清理 AnQiCMS 的系统缓存，以确保最新的模板和数据被加载。

navList 标签是否支持创建多于两级的导航菜单？ 根据 AnQiCMS 的设计，navList 标签目前官方支持最多两级的导航链接。这意味着您可以有一个主导航，以及主导航下的一层子导航。如果您需要更深层次的导航结构，您可能需要考虑自定义模板逻辑，或者将子导航设计成独立的导航类别，并结合 JavaScript 在前端实现更复杂的交互效果。