如何在导航菜单中集成分类列表，并在分类下显示产品文档？
在安企CMS中，将产品分类集成到导航菜单并展示其下的产品文档，是提升网站用户体验和内容组织效率的关键一步。这不仅能让访客快速找到所需信息，也有助于搜索引擎更好地理解网站结构。
要实现这一目标，我们需要在安企CMS的后台进行一些基础设置，并根据这些设置在模板文件中进行相应的代码集成。
第一步：后台准备——构建内容与导航结构
在进行模板层面的集成之前，确保后台的内容结构已经清晰地建立起来。
建立产品内容模型和分类 安企CMS支持灵活的内容模型。如果你的网站主要是展示产品，那么你应该已经设置了“产品模型”（这通常是系统内置的，或者你可以自定义）。在“内容管理”模块中，进入“内容模型”确认“产品模型”是否存在。 接着，在“文档分类”中为你的产品创建详细的分类体系。例如，你可以创建“电子产品”、“家居用品”等一级分类，并在它们之下创建“手机”、“电脑”或“厨房电器”、“卧室家具”等二级分类。确保这些分类是基于“产品模型”的。
发布并关联产品文档 在相应的分类下发布你的产品文档。在添加产品文档时，务必将其关联到正确的分类，并填写产品的标题、描述、图片以及任何自定义参数，这些信息将在前端展示。
配置网站导航 现在，我们需要在后台“导航设置”中配置导航菜单，以便在网站前端显示这些产品分类。
- 通常会有一个主导航，你可以创建一个名为“产品中心”或“所有产品”的一级导航。
- 接下来，为这个主导航添加子导航。选择“链接类型”为“分类页面链接”，然后从下拉列表中选择你之前创建的具体产品分类（例如“电子产品”、“家居用品”）。这样，导航菜单中的每个分类项就与后台的产品分类建立了联系。
第二步：模板集成——将分类与文档整合到导航中
完成后台设置后，我们需要修改网站的模板文件，让这些数据在前端正确显示。通常，网站的导航菜单代码会位于 template 目录下的 bash.html、header.html 或专门的 partial/nav.html 等文件中。
安企CMS的模板标签功能强大且易于使用，可以帮助我们轻松地实现导航菜单与分类文档的集成。这里的核心思路是：使用 navList 标签获取导航菜单数据，然后遍历每个导航项。如果导航项是产品分类（通常是二级导航），我们就可以利用这个分类的ID，通过 archiveList 标签获取并展示该分类下的产品文档。
以下是一个常用的代码示例，可以直接应用到你的导航菜单模板文件中：
<ul>
{% navList navList with typeId=1 %} {# typeId=1通常代表默认主导航 #}
{%- for item in navList %}
<li>
<a href="{{ item.Link }}">{{item.Title}}</a>
{# 判断当前导航项是否有子导航（通常是产品分类） #}
{%- if item.NavList %}
<ul class="nav-menu-child"> {# 这是二级导航菜单的容器 #}
{%- for inner in item.NavList %}
<li>
<a href="{{ inner.Link }}">{{inner.Title}}</a>
{# 确保当前子导航项确实是一个分类页面，并且有对应的分类ID #}
{% if inner.PageId > 0 %}
{# 使用archiveList标签获取当前分类下的产品文档 #}
{% archiveList products with type="list" categoryId=inner.PageId limit="8" %} {# 限制显示8个产品 #}
{% if products %} {# 如果有产品文档，则显示 #}
<ul class="nav-menu-child-child"> {# 这是产品文档列表的容器 #}
{% for product in products %}
<li><a href="{{product.Link}}">{{product.Title}}</a></li>
{% endfor %}
</ul>
{% endif %}
{% endarchiveList %}
{% endif %}
</li>
{% endfor %}
</ul>
{% endif %}
</li>
{% endfor %}
{% endnavList %}
</ul>
第三步：代码解析与注意事项
我们来详细解读一下上面这段模板代码：
{% navList navList with typeId=1 %}： 这是获取主导航列表的标签。typeId=1通常指的是后台“导航设置”中默认的主导航类别。如果你创建了其他导航类别，请根据实际情况调整typeId。变量navList将存储所有主导航项的数据。{%- for item in navList %}： 遍历主导航中的每一个项。item代表了一个主导航项。{%- if item.NavList %}：item.NavList是判断当前主导航项是否包含子导航列表（即二级菜单）。在我们的场景中，这些子导航就是产品分类。{%- for inner in item.NavList %}： 遍历二级导航（产品分类）中的每一个项。inner代表了一个子导航项，也就是一个产品分类。{% if inner.PageId > 0 %}： 这一行非常关键。inner.PageId存储了该子导航项（产品分类）所关联的分类ID。我们通过判断PageId是否大于0，来确保它确实是一个有效的分类链接。{% archiveList products with type="list" categoryId=inner.PageId limit="8" %}： 这是获取产品文档的核心标签。products是一个自定义变量名，用于存储获取到的产品文档列表。type="list"表示我们获取的是一个静态列表，而不是分页列表。categoryId=inner.PageId：这里是关键！ 我们将当前循环到的产品分类的ID (inner.PageId) 传递给archiveList，这样它就能精确地获取该分类下的产品文档。limit="8"：限制每个分类下最多显示8个产品文档，你可以根据设计需求调整这个数字。
{% if products %}和{% for product in products %}： 在获取到产品文档列表后，先判断products变量是否有内容（即该分类下是否有产品），如果有，则继续遍历并显示每个产品的链接和标题。
通过这样的结构，你的导航菜单不仅能展示产品分类，还能在每个分类下直接列出相关产品文档，极大地增强了网站的实用性和用户体验。记得在完成代码修改后，清理一下系统缓存，以便前端页面能及时更新。
常见问题 (FAQ)
为什么我在导航菜单中看不到产品文档？ 首先，请检查后台“导航设置”中，你的子导航（产品分类）是否正确地关联到了实际的产品分类。其次，确认你关联的产品分类下是否有已发布的产品文档。最后，检查模板代码中的
categoryId参数是否正确引用了子导航项的PageId，以及archiveList标签的moduleId是否与你的产品模型ID匹配（默认为产品模型）。别忘了清除缓存，让更改生效。我只想在导航菜单中显示某个分类下固定几个产品文档，而不是所有，应该怎么做？ 你可以在
archiveList标签中使用limit参数来限制显示的数量，例如limit="5"表示只显示5个产品文档。如果你想调整显示的顺序，可以使用order参数，比如order="views desc"按浏览量降序排列，或order="id desc"按最新发布降序排列。我的导航菜单中有多层嵌套的分类，如何确保只显示最底层分类的产品文档？ 上述代码示例默认会遍历所有层级的子导航。如果你只想在特定层级的分类下显示产品文档，你可能需要在模板代码中增加一些逻辑判断，例如判断
inner对象的某个属性（如果后台分类有层级标记的话），或者只在最深层的for循环中使用archiveList标签，而不是在所有子循环中都使用