FacetWP v4.5 中文汉化版 | WordPress 多条件搜索与商品筛选插件

压缩包包含 FacetWP 主插件及简体中文语言文件，独立扩展插件不在本包内。

FacetWP 是一款 WordPress 多条件筛选插件，可以为文章列表、产品目录、资源库和 WooCommerce 商店添加筛选功能。访客可按分类、标签、价格或自定义字段逐步缩小范围，筛选结果通过 AJAX 更新，无需每次重新加载整个页面。对于内容较多、仅靠分类菜单不容易找到目标的网站，这类筛选会方便不少。

筛选器需要配合支持 FacetWP 的内容列表使用。可以使用已有归档页、内置列表构建器或自行编写的查询。Elementor 等页面构建器的列表模块可能需要对应扩展；Google 地图及位置服务需自行配置 API 密钥。后台中文文件请按压缩包内的安装说明放到 WordPress 全局语言目录。

FacetWP 功能介绍：

1、多种筛选方式
提供复选框、下拉选择、单选按钮、层级分类、滑块、日期范围和关键词搜索等控件。可以按内容特点搭配使用，例如产品目录按类别和价格筛选，文章列表按主题和发布日期筛选。

2、多条件组合筛选
同一页面的筛选器会相互配合，选中一个条件后，其他选项会随结果变化。既可以让访客逐步缩小查找范围，也能显示每个选项对应的结果数量。

3、利用网站现有数据
支持文章分类、标签、自定义分类法、文章日期以及自定义字段等数据来源。不必为了增加筛选，重新录入一套相同的资料。

4、WooCommerce 商品筛选
可用于商店商品列表，支持商品属性和可变商品。服装、家居等属性较多的产品，可以让顾客按颜色、尺寸、价格等条件查找；相关属性需要先在商品中设置好。

5、自定义字段支持
内置 Advanced Custom Fields 集成，可将字段数据用于筛选。制作房源、课程、案例或其他资料目录时，能够按站点已有的字段组织筛选条件。

6、列表布局与短代码
内置列表构建器，也可结合现有归档模板和自定义查询使用。筛选器、列表、分页等内容通过短代码放置，方便按页面布局安排位置。

7、分页、排序与已选条件
支持页码、加载更多、每页数量和排序控件，还可以显示访客当前选中的条件。需要重新查找时，可通过重置按钮清除指定筛选项。

8、AJAX 更新与数据索引
筛选时局部更新结果，并通过索引表读取筛选数据。首次设置或调整数据源后需要重新建立索引，之后可按站点需要配置自动索引。

9、开发者扩展接口
提供查询、输出和索引等钩子，便于调整筛选逻辑、结果内容及展示方式。需要接入特定页面构建器或额外筛选类型时，可再选配对应扩展。

FacetWP 相关截图：

压缩包资源说明：

资源压缩包/
├── facetwp ← 主插件目录，放入 /wp-content/plugins/
├── 中文语言包 ← 前后台中文 PO/MO 文件，复制到 /wp-content/languages/plugins/
└── 安装说明.txt ← 安装前提、语言文件位置及首次建立索引的步骤

4.5（2026-03-23）

• 新增筛选器、列表及排序选项时动态检查名称重复，并自动添加数字后缀，避免保存重名项目后出现丢失或显示异常。
• 从总览页删除筛选器或列表时增加确认提示，确认后自动保存，减少误删及忘记保存的问题。
• 修改筛选器或列表后，显示需要点击“保存更改”的提示。
• 停用提供筛选器的扩展后，保留其筛选器和设置，在列表底部标记为不可用并说明缺少扩展；仍可删除、导出及导入，导出设置带有 _missing 标记。
• 将“严格查询识别”更名为“高级查询识别”，并补充设置提示，说明没有明确原因时应保持启用。
• facetwp_template_use_archive 钩子支持作者归档页，使列表构建器可以按当前作者预先过滤结果。
• 使用 WordPress 的 wp_print_inline_script_tag() 输出内联脚本，以便通过相关钩子添加 nonce，配合严格内容安全策略。
• 当后台已在建立索引时，阻止 WP-CLI 同时启动另一个索引任务，并显示相应错误。
• 取消索引时立即清理索引跟踪选项和临时表，修复随后通过计划任务、WP-CLI 或自定义代码重新建立索引失败的问题。
• 仅在完整索引进行期间创建索引跟踪计划事件，避免没有任务时仍每五分钟运行及产生多余日志。
• 通过 facetwp_indexer_is_enabled 钩子禁用自动索引时，在自动索引设置旁显示该设置被钩子覆盖的提示。
• 修复重新索引成功后因时序问题仍提示索引表为空的情况，尤其是索引数据量较大的网站。
• 修复 WordPress 6.9 模板增强输出缓冲与 FacetWP 输出缓冲冲突，导致 JSON 错误及刷新筛选失效的问题。
• 为已选条件筛选器增加两个钩子，用于控制显示哪些筛选类型和具体筛选器；另增加四个钩子自定义 HTML 输出，使每个选项可作为独立的可换行列表项展示。
• 修复地图筛选器的重叠标记展开集成在展开、收起或悬停标记时产生的 JavaScript 错误。
• 修复在网址中把筛选器名称作为数组参数使用时产生的致命错误。
• 修复旧安装从未保存查询识别设置时，该设置未在调试模式中显示的问题。
• 为位置搜索结果下拉框设置 z-index: 999，避免被其他定位元素遮挡。
• 修复层级筛选器输出的筛选值未经过清理函数处理的问题。
• 为隐藏状态的“加载更多”按钮增加 display: none !important，避免主题按钮样式覆盖隐藏规则，导致没有更多结果时仍显示按钮。
• 修复 fSelect 搜索框输入关键词、移出焦点后一次删除关键词时，下拉结果未重置的问题。
• 修复启用自动隐藏且通过 facetwp_preload_url_vars 设置预选条件时，重置按钮或链接不显示的问题。
• 修复下拉筛选器和排序筛选器未正确更新 selected 属性的问题。
• 修复通过代码添加的筛选器及列表设置页中，WordPress 侧栏子菜单被半透明遮罩覆盖的问题。
• 在调试模式中增加 is_archive 信息，用于识别当前页面是否为归档模板。
• 修复重置筛选器未重置“每页数量”分页控件的问题；需要保留该值时仍可将它加入重置排除列表。
• 修复网址中的搜索或自动完成关键词含有逗号时，已选条件只显示第一项的问题。
• 修复从网址载入带引号的精确搜索短语时，已选条件将引号显示为 HTML 实体的问题。
• 修复已选条件中的下拉选项未正确更新 data-value 属性的问题。
• 修复列表 meta_query 使用多个条件和 OR 关系时，按自定义字段排序会忽略原查询条件的问题；排序查询现改为追加并使用 AND 关系。
• 将自动查询识别使用的文章类型排除列表整理为可复用辅助函数，增加 facetwp_post_types_blacklist 钩子，并加入数个 ACF 文章类型。
• 增加 facetwp_excluded_custom_fields_like 钩子，允许按部分名称排除数据源字段，可处理部分插件持续新增缓存字段导致后台请求错误的情况。
• 增加无障碍脚本加载检查，避免通过 facetwp_assets 错误加载 accessibility.js 时产生脚本错误。
• 改进更新器在官方 API 无法访问时的检查和回退，减少 PHP 警告及错误数据，并修复更新请求失败时 facetwp_activation 选项未更新的问题。