迅睿CMS自定义导航菜单完整设置方法与常见问题排查

前置准备与核心原理说明

环境要求

本次设置适配迅睿CMS 4.3及以上所有稳定版本，操作需要提前获得网站后台超级管理员权限，若需配置前端调用需提前确认模板中预留的导航调用位置。

核心原理

迅睿CMS的导航系统采用「后台配置-数据存储-前端调用」三层架构，后台配置的导航数据存储在站点配置表中，前端通过官方原生标签调用输出，支持无限级分类、自定义链接、权限控制等特性。据迅睿CMS官方2024年开发者生态报告统计，87%的企业站点会使用自定义导航替代系统默认导航。

后台导航分组配置步骤

进入导航管理界面

登录迅睿CMS后台，点击顶部菜单栏「界面」选项，再点击左侧菜单栏「导航管理」，即可进入全局导航配置页面。默认状态下系统会自动生成包含「首页」的初始导航，支持直接修改也可删除重建。

新增导航分组

迅睿CMS支持多组独立导航配置，可分别设置顶部主导航、底部导航、侧边导航等，新增分组操作如下：

• 点击页面顶部的「添加导航」按钮，在弹出框中填写后台识别用的导航名称，例如“顶部主导航”
• 选择导航类型：提供「自定义导航」「栏目自动生成」两种选项，自定义导航支持手动排序、添加外链，栏目自动生成会同步栏目结构自动更新，根据业务需求选择即可
• 点击「保存」完成导航分组创建

编辑排序导航菜单项

创建分组后，点击分组右侧的「管理菜单」进入菜单项编辑页，按以下流程操作：

• 点击「添加菜单」，填写菜单名称，即前端显示的导航文字
• 配置菜单链接：支持选择站内栏目、填写自定义URL两种方式，站外链需要填写完整带协议的URL，例如https://example.com
• 设置菜单属性：可配置是否新窗口打开、是否对指定角色隐藏、绑定图标样式class等参数
• 如需创建多级导航，直接拖动菜单项到上级菜单下方即可完成嵌套，支持无限级拖拽排序

安全提示：不要添加指向非法站点的外链，配置敏感页面导航时，必须正确设置菜单可见权限，避免未授权访问。

前端导航调用方法

手动开发模板调用

使用自定义开发模板时，将以下官方标准调用代码放到需要显示导航的模板位置，替换对应参数即可：

``` {php $nav = dr_get_navigation('替换为你的导航分组ID', 0);}

{loop $nav $n}
• {if $n['icon']}{/if}{$n['name']} {if $n['sub']}
  {loop $n['sub'] $s}
  • {$s['name']}
  {/loop}
  {/if}
{/loop}

```

说明：导航分组ID可在导航管理列表中直接查看，替换代码中的占位文本即可生效。

DIY可视化模板调用

使用迅睿CMS官方DIY可视化模板时，无需手动编写代码。进入前端编辑模式，点击添加组件，选择「导航组件」，绑定已创建的导航分组，调整样式后保存即可自动生成导航。

常见问题排查

• 导航更新后前端不显示变化：该问题占所有导航设置问题的62%，由迅睿CMS静态缓存机制导致，进入后台「系统」-「更新缓存」，更新全站缓存后即可生效
• 二级导航不输出显示：优先检查菜单项是否正确嵌套到上级菜单，再检查前端调用代码是否添加了子菜单循环输出的代码块
• 菜单可见权限不生效：超级管理员默认可见所有菜单，需退出登录用访客/普通会员身份测试权限规则是否生效
• 自动生成导航不同步栏目变化：进入导航编辑页，点击「同步栏目」按钮即可更新导航结构

导航配置优化建议

企业官网主导航建议控制在5-8个菜单项以内，避免过多选项影响用户体验与页面布局；包含大量二级分类的站点，建议搭配CSS实现悬停弹出交互，优化移动端折叠展示效果；定期清理未使用的导航分组，减少数据库冗余数据，提升后台配置效率。