在安企CMS（AnQiCMS）中，利用文档参数来构建灵活的筛选条件并展示筛选结果，是提升网站用户体验和内容管理效率的关键一环。这不仅能帮助用户更快地找到所需信息，也能让网站内容结构更加清晰。本文将详细介绍如何在安企CMS中实现这一功能，从前期的参数定义到最终的筛选展示，助您轻松驾驭内容管理。

让内容更智能：安企CMS中如何巧妙运用文档参数实现筛选功能

随着网站内容的不断丰富，如何帮助访问者快速精准地找到他们感兴趣的信息，成为了网站运营者面临的常见挑战。安企CMS凭借其灵活的内容模型和强大的模板标签功能，为我们提供了优雅的解决方案——通过自定义文档参数来构建筛选器。想象一下，一个房产网站可以根据“户型”、“面积”、“区域”等条件筛选房源，一个电商平台可以依据“颜色”、“尺寸”、“品牌”等属性筛选商品，这些都离不开对文档参数的精妙运用。

下面，就让我们一步步揭开安企CMS中实现这一功能的神秘面纱。

一、准备工作：定义文档参数

要实现筛选功能，首先需要为您的内容定义可供筛选的参数。安企CMS的核心优势之一在于其灵活的内容模型，这正是我们实现筛选功能的基础。

  1. 进入内容模型管理： 登录安企CMS后台，导航至“内容管理”菜单，找到“内容模型”选项。在这里，您可以管理和编辑您网站上各种类型的内容（如文章、产品等）所使用的模型。
  2. 编辑或新建内容模型： 选择您希望添加筛选功能的现有内容模型进行编辑，或者创建一个全新的内容模型。
  3. 添加自定义字段： 在内容模型的编辑界面，您会看到“内容模型自定义字段”区域。点击“添加字段”，为您的内容定义筛选参数。在这里，关键在于选择合适的“字段类型”，尤其是“单项选择”、“多项选择”和“下拉选择”这几种类型，它们非常适合作为筛选条件。
    • 参数名： 这是前端展示给用户的字段名称，如“户型”、“颜色”。
    • 调用字段： 这是在模板代码中引用该参数的唯一标识，请使用英文字母，例如“houseType”、“color”。
    • 字段类型： 选择“单项选择”、“多项选择”或“下拉选择”。
    • 默认值： 在这里输入筛选的选项值，每行一个。例如，如果“户型”字段有“一居室”、“两居室”等选项，就将它们分别写入默认值区域。这些值将直接作为用户可以点击的筛选条件。

完成字段定义后，记得保存内容模型。接下来，在发布或编辑文档时，您就可以为这些自定义字段填写相应的值了。这些值将作为文档的属性，成为未来筛选的目标。

二、构建筛选界面：使用 archiveFilters 标签

有了定义好的文档参数，接下来就是如何在前端页面上呈现这些参数，以便用户选择筛选条件。安企CMS提供了专门的archiveFilters标签来帮助我们自动化构建这一复杂的筛选界面。

  1. 确定标签放置位置： archiveFilters标签通常放置在文档列表页或文档模型的首页模板中，即用户浏览内容时需要进行筛选的页面。
  2. 使用 archiveFilters 标签： 这个标签能够自动读取您在后台定义的内容模型自定义字段，并生成相应的筛选链接。它主要需要一个moduleId参数来指定您要筛选哪个内容模型的文档。
    • moduleId：指定您要筛选的文档所属的内容模型ID。例如，moduleId="1"可能代表文章模型，moduleId="2"可能代表产品模型。您可以在内容模型管理页面找到对应的ID。
    • allText：用于设置“全部”或“不限”等默认选项的显示文本，如果您不希望显示这个默认选项，可以将其设置为false。

以下是一个简单的代码示例，演示如何使用archiveFilters标签来生成筛选器：

{# 假设我们正在为一个ID为1的内容模型（如文章）创建筛选器 #}
<div class="filter-section">
    <div class="filter-title">参数筛选：</div>
    {% archiveFilters filters with moduleId="1" allText="全部" %}
        {% for item in filters %}
        <ul class="filter-group">
            <li class="filter-name">{{item.Name}}: </li> {# 显示参数名称，如“户型” #}
            {% for val in item.Items %}
            <li class="filter-option {% if val.IsCurrent %}active{% endif %}">
                <a href="{{val.Link}}">{{val.Label}}</a> {# 生成带有筛选参数的URL链接 #}
            </li>
            {% endfor %}
        </ul>
    {% endfor %}
    {% endarchiveFilters %}
</div>

在这个例子中，filters是一个包含所有可筛选参数的数组。item.Name会显示您在后台设置的参数名（如“户型”），item.Items则是一个包含了该参数所有选项的数组。对于每个选项，val.Label是显示给用户的文本（如“一居室”），而val.Link则是安企CMS自动生成的、包含了该筛选条件的完整URL。val.IsCurrent则用于判断当前选项是否被选中，方便您添加样式。

三、展示筛选结果：archiveList 的妙用

用户点击筛选条件后，页面需要根据这些条件动态地展示相应的文档列表。安企CMS的archiveList标签在这里发挥了核心作用，因为它能智能地捕获URL中的筛选参数，并据此查询数据库，返回符合条件的文档。

  1. archiveList 自动响应筛选条件： archiveList标签本身不需要额外设置来“接收”筛选参数。当archiveFilters生成的链接被点击后，URL中会包含类似于?houseType=one_bedroom&color=red这样的查询参数。archiveList标签在获取数据时，会自动识别并应用这些URL中的参数作为筛选条件。
  2. 结合分页功能： 为了更好地管理筛选后的结果，我们通常会结合分页标签pagination一起使用。archiveList标签的type="page"参数表示启用分页功能。

以下是一个将筛选器与文档列表和分页功能结合起来的完整代码示例：

”`twig {# 筛选