如何使用`archiveFilters`标签创建多条件的文档筛选界面？

安企CMS作为一款高效、可定制的企业级内容管理系统，致力于为网站运营者提供强大且灵活的内容管理工具。在日常运营中，我们常常需要为用户提供多样化的内容筛选功能，以帮助他们快速找到感兴趣的信息。这时，安企CMS提供的archiveFilters标签便能大显身手，它允许我们轻松构建一个多条件的文档筛选界面，极大提升用户的内容发现体验。

了解 archiveFilters 标签的强大之处

想象一下，如果您的网站内容丰富多样，例如一个房产信息平台，用户可能想根据“房屋类型”、“区域”、“价格范围”甚至“装修情况”来筛选房源。如果是一个产品展示网站，用户可能需要按“品牌”、“型号”、“颜色”等属性来查找产品。面对这些复杂的筛选需求，手动构建每个筛选条件和对应的链接无疑是繁琐且易错的。

archiveFilters标签正是为解决此类问题而生的。它不是简单地罗列筛选选项，而是能够动态地根据您在后台定义的内容模型参数，自动生成一系列可点击的筛选条件。这意味着，当您在后台调整了内容模型的自定义字段或其可选值时，前端的筛选界面也能自动同步更新，无需修改模板代码，大大提高了网站的可维护性和运营效率。

前置准备：定义可筛选的内容模型字段

archiveFilters标签的魔力源于其与安企CMS内容模型的深度整合。要让它发挥作用，我们首先需要在后台为文档内容定义好可筛选的“参数字段”。这些参数将作为前端筛选的依据。

具体来说，您需要登录安企CMS后台，进入“内容管理”下的“内容模型”模块。选择您需要进行筛选操作的内容模型（例如“文章模型”或“产品模型”），然后点击编辑。在内容模型编辑界面，您可以找到“内容模型自定义字段”区域。在这里，您可以添加或修改字段，这些字段的类型将决定它们是否适合作为筛选条件。

建议选择以下类型的字段作为筛选参数：

  • 单项选择：例如“房屋类型”（住宅、商铺、公寓）。
  • 多项选择：例如“产品颜色”（红、蓝、黑）。
  • 下拉选择：例如“价格区间”（50-100万、100-200万）。

当您设置好这些自定义字段及其默认值（即筛选选项）后，archiveFilters标签便能自动识别并生成对应的筛选界面。例如，如果您为产品模型添加了一个名为“颜色”的单项选择字段，并预设了“红色”、“蓝色”、“绿色”等选项，archiveFilters就能自动创建出这些颜色的筛选按钮。

archiveFilters 标签的核心用法与参数解析

在模板中使用archiveFilters标签非常直观，其基本结构是：

{% archiveFilters 变量名 with 参数 %}
    {# 循环输出筛选条件 #}
{% endarchiveFilters %}

通常，我们会将它定义为一个变量，例如filters，然后通过循环来渲染出筛选选项。

核心参数解读：

  1. moduleId：这个参数至关重要，它告诉archiveFilters您希望筛选的是哪个内容模型下的文档。例如，moduleId="1"可能代表文章模型，而moduleId="2"可能代表产品模型。您可以在后台的“内容模型”列表中找到每个模型的ID。

  2. allText：用于设置“全部”或“不限”选项的显示文本。例如，allText="全部"会在每个筛选组的开头添加一个名为“全部”的选项。如果您不希望显示这个选项，可以将其设置为allText=false。

  3. siteId：如果您启用了安企CMS的多站点管理功能，并且需要跨站点调用数据，可以使用siteId来指定目标站点。对于单站点部署，通常无需设置。

filters变量的结构：

当您在标签中定义了filters这个变量后，它实际上是一个数组对象。这个数组中的每个元素代表一个可筛选的自定义字段（例如“房屋类型”、“房屋大小”）。每个元素又包含以下属性：

  • Name：筛选参数的显示名称，如“房屋类型”。
  • FieldName：筛选参数对应的后台自定义字段名。
  • Items：这是一个内嵌的数组，包含了该筛选参数所有可用的选项。每个选项又是一个对象，具有：
    • Label：筛选选项的显示文本，如“住宅”、“商铺”。
    • Link：点击该选项后跳转的URL，其中包含了应用此筛选条件的参数。
    • IsCurrent：一个布尔值，表示当前该选项是否被选中。这对于为当前选中的筛选条件添加高亮样式非常有用。

实战演练：构建一个动态筛选界面

现在，让我们通过一个实际的代码示例，看看如何将archiveFilters标签集成到您的模板中，以构建一个具备多条件筛选功能的文档列表。

假设我们有一个产品列表页，需要根据产品的“类型”（在内容模型中字段名为product_type）和“材质”（字段名为material）进行筛选。

”`twig {# 假设这是您的产品列表页模板，例如 product/list.html 或 archive/list.html #}

<h3>筛选产品</h3>
{# 使用 archiveFilters 标签生成筛选条件，moduleId 假设为产品模型的ID #}
{% archiveFilters filters with moduleId="2" allText="不限" %}
    {% for item in filters %}
        <div class="filter-group">
            <span class="filter-label">{{ item