Title: CatCode Smart Filter for WooCommerce
Author: CatCode
Published: <strong>2026 年 9 月 15 日</strong>
Last modified: 2026 年 9 月 16 日

---

搜索插件

![](https://ps.w.org/catcode-smart-filter/assets/banner-772x250.png?rev=3698448)

![](https://ps.w.org/catcode-smart-filter/assets/icon-256x256.png?rev=3698448)

# CatCode Smart Filter for WooCommerce

 作者：[CatCode](https://profiles.wordpress.org/catcodestudio/)

[下载](https://downloads.wordpress.org/plugin/catcode-smart-filter.1.0.0.zip)

 * [详情](https://cn.wordpress.org/plugins/catcode-smart-filter/#description)
 * [评价](https://cn.wordpress.org/plugins/catcode-smart-filter/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/catcode-smart-filter/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/catcode-smart-filter/#developers)

 [支持](https://wordpress.org/support/plugin/catcode-smart-filter/)

## 描述

Most WooCommerce filters ask the database the same expensive question on every click—
join the attribute tables, join the meta tables, count. On a catalogue of a few 
thousand products that question takes seconds, and the shopper leaves before the
answer arrives.

This plugin keeps its own flat index of “which product carries which value”, rebuilt
in the background and kept current by every product save. Filtering reads that one
table, so the query cost stops growing with the number of attributes.

#### What it does

 * Facets from product attributes, from any product taxonomy (categories, tags, 
   brands) and from a custom field.
 * Checkboxes, radio buttons, a select, a range slider or a toggle — per facet.
 * Price slider in the shop’s display currency, an “in stock / out of stock” facet
   and a rating facet.
 * Honest counts next to every value: a count tells you what you will get, and the
   value you already picked keeps showing its siblings instead of collapsing to 
   itself.
 * Values with no products are hidden — or shown greyed out, if you prefer the shopper
   to see the whole range.
 * Numeric values sort as numbers: `1.5 / 2 / 10 / 12.5`, not the alphabetical `
   1.5 / 10 / 12.5 / 2` every term-sorted filter shows.
 * Applying a filter does not reload the page: the listing and the filter block 
   are swapped in place and the URL goes into the browser history, so Back works
   and the link can be copied and shared.
 * Mobile drawer with a “Show N products” button, so the count is visible before
   the tap.
 * Chips for what is currently applied, with a one-click reset.
 * Readable URLs: `?ccf=pa_color:червоний;p:100-2500` — one state has exactly one
   URL, so nothing turns into a duplicate.
 * Crawl control out of the box: a filtered view is `noindex,follow` with a canonical
   back to the clean archive, and the shop keeps its crawl budget.
 * Placement as a widget or through the `[catcode_filter]` shortcode.
 * Works with the theme’s own product grid — the swapped selector is a setting, `
   ul.products` by default.
 * Merging duplicate values: `12 В`, `12в` and `12 V` become one checkbox while 
   the products keep their own terms.
 * As many facets as your catalogue needs — nothing here is capped or time-limited.
 * HPOS (custom order tables) compatible.

#### Requirements

 * WooCommerce 6.0 or newer
 * WordPress 6.2 or newer
 * PHP 7.4+

## 屏幕截图

[⌊The filter block on a shop page⌉⌊The filter block on a shop page⌉[

The filter block on a shop page

[⌊The mobile view: the filter panel opens from the "Filters" button⌉⌊The mobile 
view: the filter panel opens from the "Filters" button⌉[

The mobile view: the filter panel opens from the “Filters” button

[⌊Facets in the admin: source, widget, logic and order⌉⌊Facets in the admin: source,
widget, logic and order⌉[

Facets in the admin: source, widget, logic and order

[⌊The index tab⌉⌊The index tab⌉[

The index tab

## 安装

 1. Upload the plugin folder to `/wp-content/plugins/catcode-smart-filter/`
 2. Activate it in the “Plugins” menu
 3. Go to WooCommerce  Smart Filter  Facets and import the attributes you want to filter
    by
 4. Open the “Index” tab and press “Rebuild the index” once
 5. Place the block: the “CatCode: Smart Filter” widget, or the `[catcode_filter]` 
    shortcode

## 常见问题

### The filter block does not appear

It renders only where a product listing does — the shop, a product category or tag
archive, and product search results. Check that a facet is imported and active, 
and that the index has been built at least once (WooCommerce  Smart Filter  Index).

### Clicking a value reloads the whole page

The AJAX swap needs to know which element holds the product grid. Most themes use`
ul.products`, which is the default; if yours does not, put its selector into “Product
grid selector” in the settings.

### The counts do not match the listing

Press “Rebuild the index”. A count and a listing can only disagree when the index
is behind the catalogue — after a bulk import that wrote to the database directly,
for example.

### Does it work with a page cache?

Yes. Filtered views carry a query string, so they are served fresh; the clean archive
stays cacheable. The counts have their own cache with a lifetime you set.

### Will Google index thousands of filter URLs?

No. A filtered view is `noindex,follow` with a canonical pointing at the clean archive.
Every filtered combination stays out of the index.

## 评价

此插件暂无评价。

## 贡献者及开发者

「CatCode Smart Filter for WooCommerce」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ CatCode ](https://profiles.wordpress.org/catcodestudio/)

「CatCode Smart Filter for WooCommerce」插件已被翻译至 1 种本地化语言。 感谢[所有译者](https://translate.wordpress.org/projects/wp-plugins/catcode-smart-filter/contributors)
为本插件所做的贡献。

[帮助将「CatCode Smart Filter for WooCommerce」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/catcode-smart-filter)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/catcode-smart-filter/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/catcode-smart-filter/)，或通过[RSS](https://plugins.trac.wordpress.org/log/catcode-smart-filter/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/catcode-smart-filter/)。

## 更新日志

#### 1.0.0

 * First release.

## 额外信息

 *  版本 **1.0.0**
 *  最后更新：**5 天前**
 *  活跃安装数量 **不到10**
 *  WordPress 版本 ** 6.2 或更高版本 **
 *  已测试的最高版本为 **7.1.1**
 *  PHP 版本 ** 7.4 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/catcode-smart-filter/) 和 [Ukrainian](https://uk.wordpress.org/plugins/catcode-smart-filter/).
 *  [翻译成简体中文](https://translate.wordpress.org/projects/wp-plugins/catcode-smart-filter)
 * 标签
 * [attribute filter](https://cn.wordpress.org/plugins/tags/attribute-filter/)[faceted search](https://cn.wordpress.org/plugins/tags/faceted-search/)
   [price filter](https://cn.wordpress.org/plugins/tags/price-filter/)[product filter](https://cn.wordpress.org/plugins/tags/product-filter/)
   [woocommerce](https://cn.wordpress.org/plugins/tags/woocommerce/)
 *  [高级视图](https://cn.wordpress.org/plugins/catcode-smart-filter/advanced/)

## 评级

尚未提交反馈。

[您的评价](https://wordpress.org/support/plugin/catcode-smart-filter/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/catcode-smart-filter/reviews/)

## 贡献者

 *   [ CatCode ](https://profiles.wordpress.org/catcodestudio/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/catcode-smart-filter/)