在安企CMS中，为文档列表页实现多条件筛选功能，特别是基于自定义参数的筛选，是提升用户体验、帮助用户快速找到所需内容的关键。安企CMS凭借其灵活的内容模型和强大的模板标签系统，让这一功能实现起来既高效又直观。

整个过程可以分为几个核心步骤：首先，在后台定义好你的内容模型和自定义筛选字段；其次，在模板中构建筛选条件的展示界面；最后，利用列表标签将筛选结果呈现在文档列表中。

一、准备工作：定义内容模型与自定义字段

要实现基于自定义参数的筛选，我们首先需要确保内容本身就包含了这些可供筛选的参数。安企CMS提供了灵活的内容模型管理功能，允许用户根据业务需求自定义字段。

  1. 进入内容模型管理：登录安企CMS后台，导航至“内容管理” -> “内容模型”。这里，你可以选择修改现有的内容模型（如“文章模型”或“产品模型”），或者创建一个全新的模型。

  2. 添加自定义字段：在内容模型的编辑页面，找到“内容模型自定义字段”区域。点击添加字段，你需要配置以下几个关键项：

    • 参数名：这是字段的显示名称，例如“房屋类型”、“所在区域”或“价格区间”。
    • 调用字段：这是模板中用来调用该字段的唯一标识，通常建议使用英文字母，如 houseType、region、priceRange。这个字段名将直接用于URL查询参数。
    • 字段类型：这一点至关重要。为了方便筛选，我们通常会选择“单项选择”、“多项选择”或“下拉选择”这几种类型。这些类型能够提供预设的选项，从而生成规范化的筛选条件。
    • 默认值：如果选择了“单项选择”、“多项选择”或“下拉选择”类型，就需要在这里填写选项值。每个选项占一行，系统会自动将其解析为独立的筛选项目。例如，在“房屋类型”字段中，你可以填写“住宅”、“商铺”、“别墅”等。
    • 是否必填：根据你的业务需求设置。

通过以上步骤，你就为内容模型添加了具备筛选潜力的自定义参数。例如，为房产模型添加“户型”（单选，选项：一居室、两居室、三居室）和“装修”（单选，选项：精装修、毛坯、简装修）等字段。

二、核心功能：构建筛选条件展示界面

自定义参数定义完成后，接下来需要在前端页面上展示这些筛选条件，供用户选择。这主要通过安企CMS提供的 archiveFilters 标签来完成。

  1. 选择合适的模板文件：通常，文档列表页对应的模板文件是 {模型table}/list.html 或 {模型table}/list-{文档分类ID}.html。在该文件中，你需要插入筛选条件的模板代码。

  2. 使用 archiveFilters 标签：archiveFilters 标签专门用于生成基于模型自定义参数的筛选条件列表。它会遍历你为指定模型定义的、适合筛选的自定义字段，并为每个字段的选项生成相应的筛选链接。

    它支持以下参数：

    • moduleId：指定要筛选的内容模型ID。例如，moduleId="1" 表示文章模型，moduleId="2" 表示产品模型。如果当前页面本身就是某个模型的列表页，这个参数可以省略，系统会自动识别。
    • allText：用于设置每个筛选条件项的“全部”选项的显示文本，例如“不限”、“所有”等。如果不想显示，可以设置为 false。

    archiveFilters 标签会返回一个包含所有筛选字段及其选项的数组对象。每个字段对象包含 Name (参数名)、FieldName (调用字段) 以及 Items (该字段的所有选项)。Items 数组中的每个选项又包含 Label (选项显示文本)、Link (筛选链接) 和 IsCurrent (是否当前选中) 等信息。

  3. 构建筛选界面示例：以下是一个典型的筛选界面代码结构：

    <div class="filter-area">
    {% 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-item {% if val.IsCurrent %}active{% endif %}">
                <a href="{{ val.Link }}">{{ val.Label }}</a>
            </li>
            {% endfor %}
        </ul>
        {% endfor %}
    {% endarchiveFilters %}
</div>

    这段代码会遍历所有可筛选的自定义字段，为每个字段（如“户型”、“装修”）生成一个 <ul> 列表，并在其中展示该字段的所有选项。每个选项都会生成一个链接，点击后会带上相应的查询参数跳转到当前列表页，同时 IsCurrent 属性会帮助我们为当前选中的筛选条件添加 active 类，实现高亮显示。

三、联动展示：让筛选结果在文档列表中生效

当用户点击筛选链接后，URL中会带上形如 ?houseType=三居室&decoration=精装修 的查询参数。这时，文档列表需要能够识别并响应这些参数，只显示符合条件的文档。

  1. 使用 archiveList 标签：在文档列表页，我们使用 archiveList 标签来获取和显示文档数据。关键在于设置 type="page" 参数，这样 archiveList 标签就能够自动解析URL中的查询参数，并将其作为筛选条件应用到文档查询中。

    archiveList 标签支持多种参数，其中最重要的是：

    • type="page"：告诉标签这是一个需要分页的列表，并且会自动处理URL中的筛选参数和页码。
    • moduleId：指定要显示的文档所属模型。
    • limit：控制每页显示的文档数量。
    • 其他参数如 categoryId、order、q（搜索关键词）等也可以按需配合使用。

  2. 构建文档列表示例：

    <div class="document-list">
    {% archiveList archives with type="page" moduleId="1" limit="10" %}
        {% for item in archives %}
        <div class="document-item">
            <a href="{{ item.Link }}">
                <h3>{{ item.Title }}</h3>
                <p>{{ item.Description }}</p>
                <div class="meta">
                    <span>分类: {% categoryDetail with name="Title" id=item.CategoryId %}</span>
                    <span>发布日期: {{ stampToDate(item.CreatedTime, "2006-01-02") }}</span>
                    <span>浏览量: {{ item.Views }}</span>
                </div>
            </a>
        </div>
        {% empty %}
        <p>没有找到符合条件的文档。</p>
        {% endfor %}
    {% endarchiveList %}
</div>


{# 分页导航 (需配合 type="page" 使用) #}
<div class="pagination-area">
    {% pagination pages with show="5" %}
        {# 分页逻辑代码，此处省略，可参考文档 tag-pagination.md #}
        <!-- 示例: 首页、上一页、页码、下一页、末页链接 -->
    {% endpagination %}
</div>

    通过设置 type="page"，archiveList 会自动将 archiveFilters 生成的、并点击后传入URL的查询参数识别为筛选条件。它会根据这些参数过滤文档，并仅显示符合条件的文档。同时，它也会将当前页码信息传递给 pagination 标签，实现筛选条件下的正确分页。

四、整合与优化：一个完整的筛选页面示例

将上述的筛选条件展示和文档列表展示代码整合到同一个模板文件（例如 product/list.html）中，即可形成一个功能完善的多条件筛选文档列表页。

例如，一个房产网站的列表页，用户可以选择“户型”、“区域”、“价格范围”等条件进行筛选：

”`twig {# 筛选条件展示区 #}