HUSKY - WooCommerce Product Filter Professional

WooCommerce 筛选器 URL 变了但商品没变:修复方法

您勾选了一个颜色或分类,加载动画出现,地址栏变成了类似 /shop/?swoof=1&pa_color=red 的样子,而商品网格显示的仍然是同样的商品。当 WooCommerce 筛选器的 URL 变了但商品没有变时,筛选器已经完成了它的工作:它构建好了搜索请求。只是输出商品的模板从未读取这个请求。本指南将展示如何在两分钟内确认这一点,以及如何让主题、页面构建器或自定义模板响应筛选器。

为什么筛选器 URL 变了,商品却没有变

HUSKY 并不绘制您商店的商品网格。它只是把自己的条件(分类法、价格、自定义字段、文本)添加到 WooCommerce 已经在运行的商品查询中,而且仅限于这些查询:

  • 商店页以及商品分类、标签和属性归档页的主查询(WooCommerce 的 woocommerce_product_query 步骤);
  • 插件自带的 [woof_products] 短代码;
  • WooCommerce 的商品短代码,例如 [products],通过 woocommerce_shortcode_products_query 实现。

自行构建 WP_Query 的商品列表不在这条路径之内。页面构建器的商品网格、文章卡片和重复器、“查询循环”元素、带有自身查询的主题归档布局,以及 PHP 模板中手写的循环,都是以各自的方式向数据库请求商品,因此无论筛选器怎么设置,它们都会继续显示完整的商品目录。筛选器本身并没有坏;只是这个列表不听它的。

有两个相关的症状根源相同。在普通页面上,如果筛选器脚本找不到 WooCommerce 商品列表,就会把访客带到商店页来显示结果。而在一个实际上是用构建器制作的 WordPress 页面的“分类页”上,筛选器不知道当前分类,于是会提供所有分类项,并搜索整个商品目录。

两分钟确认原因

  1. 查看筛选后的 URL。如果其中包含 swoof=1 以及您的选择(启用 SEO URL 时为 /swoof/ 及其后的内容,而价格是唯一选择时则只有 min_price 和 max_price),说明筛选器已经工作。如果 URL 完全没有变化,说明筛选器根本没有提交:请先在浏览器控制台中查找 JavaScript 错误。
  2. 在标准商店页上尝试同样的请求。复制从 ?swoof=1 开始的全部内容,并将其附加到您的 WooCommerce 商店页 URL 后面。如果那里的商品已被筛选,而您的页面上没有,问题就直指您页面的商品列表。
  3. 用一个简单的短代码测试。在草稿页面上放置 [woof],并在其下方放置 [woof_products per_page=12],或者 WooCommerce 的 [products limit="12"]。如果这些能正确筛选,请针对您的真实页面使用下面的某个修复方法。
  4. 检查这是什么类型的页面。查看编辑界面:带有商品网格的 WordPress 页面(Page)不是商品归档页,即使它的 URL 看起来像 /category/shoes/。

修复 1:用 [woof_products] 显示商品

最可靠的修复是让插件来输出商品。把构建器的商品元素替换为包含 [woof_products] 的短代码小工具或区块:

[woof_products per_page=12 columns=4 is_ajax=1]

该短代码在任何页面上都能响应筛选器,通过 is_ajax=1 支持 AJAX 模式,并使用您主题标准的 WooCommerce 商品卡片(即 content-product.php 模板部件)渲染每个商品,所以外观与商店一致。若要使用其他模板部件,请通过 woof_template_part 过滤器更改。

如果页面只应列出一个分类,请给两个短代码设置相同的条件,否则筛选器会提供整个商品目录的分类项:

[woof taxonomies=product_cat:25]
[woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1]

将 25 替换为分类 ID(编辑分类时显示在 URL 中)。WooCommerce 自带的 [products] 短代码同样会被筛选,但只能通过重新加载页面。如果需要在 AJAX 模式下使用它,请写成 [products_woof limit="12" columns="4"]:插件会对它进行包装,这样无需重新加载页面就能替换结果。

修复 2:让构建器网格或自定义 WP_Query 响应筛选器

如果您想保留构建器自己的卡片设计,就让它的查询使用筛选器的结果。下面的代码片段挂接到 pre_get_posts,向 HUSKY 询问哪些商品符合当前筛选条件,并把网格的查询限制在这些商品内。它是 让页面构建器和自定义模板可被筛选中那段代码的加固版本:它不会干扰 wp-admin 中的商品列表,保持网格分页正常工作,尊重元素本身固定选定的商品,并且在没有任何匹配时显示“没有商品”,而不是整个商品目录。

/**
 * HUSKY: apply the active filter to product lists that run their own query
 * (page builder grids, post cards, query loops, custom templates).
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'pre_get_posts', function ( $query ) {
    static $busy = false;

    if ( $busy || ! function_exists( 'woof' ) || $query->is_main_query() ) {
        return;
    }
    // Keep the product lists in wp-admin untouched.
    if ( is_admin() && ! wp_doing_ajax() ) {
        return;
    }
    // Product queries only.
    if ( ! in_array( 'product', (array) $query->get( 'post_type' ), true ) ) {
        return;
    }
    // WooCommerce archives and [woof_products] are filtered already.
    if ( 'product_query' === $query->get( 'wc_query' ) ) {
        return;
    }
    // Only while a filter is active: ?swoof=1, an SEO URL,
    // or ?min_price=...&max_price=... when only the price is set.
    $request = woof()->get_request_data();
    if ( ! isset( $request[ woof()->get_swoof_search_slug() ] ) && ! isset( $request['min_price'] ) ) {
        return;
    }
    // Optional: limit to one page.
    // if ( ! is_page( 123 ) ) { return; }

    $was_doing = isset( $_REQUEST['woof_products_doing'] );
    $args      = woof()->woof_products( array( 'get_args_only' => 1 ) );

    // All matching IDs, whatever page of the grid is open.
    $args['fields']         = 'ids';
    $args['posts_per_page'] = -1;
    $args['paged']          = 1;
    $args['no_found_rows']  = true;
    $args['orderby']        = 'ID';
    unset( $args['meta_key'] );

    $busy = true;
    $ids  = ( new WP_Query( $args ) )->posts;
    $busy = false;

    if ( ! $was_doing ) {
        unset( $_REQUEST['woof_products_doing'] );
    }

    // Respect a fixed product selection of the element itself.
    $own = array_filter( array_map( 'intval', (array) $query->get( 'post__in' ) ) );
    if ( $own ) {
        $ids = array_values( array_intersect( $ids, $own ) );
    }

    // No match: show "no products" instead of the whole catalog.
    $query->set( 'post__in', $ids ? $ids : array( 0 ) );
} );

工作原理:woof()->woof_products( array( 'get_args_only' => 1 ) ) 会返回 [woof_products] 针对当前请求将使用的查询参数,但并不执行查询。该代码片段把这些参数转换为匹配的商品 ID 列表,并以 post__in 的形式交给网格。网格保留自己的布局、排序和每页数量。同一个钩子也适用于您在模板中自己编写的 WP_Query,只要它查询的是 product 文章类型。

已筛选页面上的每个商品查询现在都会遵循筛选器,包括页脚中的“热销商品”或“相关商品”这类轮播。如果这不是您想要的,请取消注释 is_page() 那一行,并填入带有该网格的页面 ID;这样还能为页面上其他所有商品列表省去一次额外的数据库查询。

AJAX 模式需要两个商店循环钩子

当尝试将商店 AJAX 化(Try to ajaxify the shop)设置为是(Yes)时(WooCommerce → 设置 → Products Filter → 选项),插件会把商品列表包裹在它自己的容器中。它在 woocommerce_before_shop_loop 钩子上打开容器,在 woocommerce_after_shop_loop 上关闭容器。每次筛选更改后,它都会向服务器请求新的 HTML,并替换该容器的内容。标准的 WooCommerce 归档模板会调用这两个钩子;许多构建器布局和自定义模板则不会。结果是以下三种症状之一:

  • 两个钩子都没有被调用:没有可替换的容器,所以每次筛选更改都会重新加载整个页面。
  • 只调用了第一个钩子:打开的容器永远不会被关闭,并吞掉布局的其余部分,例如第二栏或侧边栏,后者会突然出现在商品栏内。
  • 筛选后卡片的外观发生变化:AJAX 结果由 [woof_products] 在服务器上使用标准的 WooCommerce 商品卡片渲染,而不是使用构建器的卡片设计。构建器原本隐藏的默认数量字段或加入购物车按钮会重新出现。

如果您能控制模板代码,请在循环两侧调用这两个钩子:

<?php
// Product list part of your theme template.
do_action( 'woocommerce_before_shop_loop' );

woocommerce_product_loop_start();
while ( have_posts() ) {
    the_post();
    wc_get_template_part( 'content', 'product' );
}
woocommerce_product_loop_end();

do_action( 'woocommerce_after_shop_loop' );

两个钩子之间的所有内容在每次 AJAX 请求时都会被替换,因此想要包在每个商品外面的包装标记应放在 content-product.php 中,而不是归档模板里。您自己循环中的自定义条件(例如“最近 60 天的商品”)不属于 AJAX 结果,因为服务器是用 [woof_products] 渲染它的;请通过 woof_products_query 钩子添加这类条件,或者使用重定向模式。

如果您无法更改模板(使用构建器时通常如此),请将尝试将商店 AJAX 化(Try to ajaxify the shop)设置为否(No)。在重定向模式下,每次筛选更改都会加载已筛选的 URL,而修复 2 中的代码片段会让构建器网格显示正确的商品。开启自动提交后,每个选择都会立即生效,只是以页面加载代替了 AJAX 替换。

筛选器跳转到商店页或忽略分类

结果在商店页上打开。在不是商品归档页的页面上,筛选器脚本会查找 WooCommerce 商品列表:.woocommerce 容器内带有 products 类的元素,或插件自己的输出。如果一个都找不到,它就会把搜索发送到商店页,于是您页面上的筛选器看起来就消失了。修复 1 可以解决这个问题;着陆页和首页的短代码设置见自定义页面上的产品筛选器。如果借助修复 2,您的构建器网格已经能响应筛选器,但使用的标记不同,请告诉脚本留在当前页面:

/**
 * HUSKY: keep filter results on this page instead of the shop page.
 * Child theme functions.php or a code snippets plugin.
 */
add_action( 'wp_footer', function () {
    if ( is_page( 123 ) ) { // ID of the page with the product grid
        echo '<script>var woof_not_redirect = 1;</script>';
    }
} );

筛选器提供了其他分类的项目。插件从 WordPress 获取当前分类(商品分类法归档页的 queried object)。被做成分类外观的 WordPress 页面没有这个对象,所以筛选器会针对整个商品目录工作。请使用真正的分类归档页,并用构建器的归档模板或主题构建器模板来设计其样式,或者像修复 1 中那样,把 taxonomies=product_cat:ID 传给两个短代码。未提供 WooCommerce 支持的自定义主题,在真正的归档页上也可能出现同样的效果;在 after_setup_theme 回调中声明 add_theme_support( 'woocommerce' ) 可以修复检测,不过之后可能需要调整主题的商品模板。如果该页面是真正的归档页,但分类仍未被检测到,请在高级 → 选项下将分类页的额外检查(Additional check of the category page)设置为是(Yes)。区块主题会自动进行这项检查。若要隐藏当前分类中没有商品的项目,请参阅如何仅显示当前分类的筛选选项。

路由冲突:SEO URL 与固定链接

启用 SEO URL 请求扩展后,筛选条件会成为路径的一部分,例如 /shop/swoof/color-red/,而不是查询字符串。有些构建器自行解析 URL 和模板(Bricks 就是已知的例子),不能识别这种路径,结果就是筛选界面能用,而商品始终不变,或者页面回退到未筛选的模板。要测试,请打开高级 → SEO URL 请求,将启用/禁用(Enable/Disable)设置为否(No),清除所有缓存后再次筛选。如果普通的 ?swoof=1&... 链接可以工作,原因就是路由;请在该站点上保持关闭 SEO URL。

SEO URL 还需要美化的固定链接。如果设置 → 固定链接中使用的是朴素(Plain),请选择任何其他结构,保存后再次测试。

常见的构建器情形

由什么显示商品该怎么做
构建器商品网格、文章卡片、重复器或查询循环元素(Avada Post Cards、Oxygen Repeater、Bricks 查询循环、带自定义查询的 Query Loop 区块)修复 2,重定向模式。或者将该元素替换为 [woof_products]。
替换商店或分类模板的主题构建器布局(Avada 布局、YOOtheme、Flatsome、Beaver Themer、Breakdance)当布局使用 WooCommerce 循环时,可在重定向模式下工作。仅当布局调用了两个商店循环钩子时才能用 AJAX 模式;否则请将尝试将商店 AJAX 化(Try to ajaxify the shop)设置为否(No)。
Elementor 的商品小工具和循环网格参见让 Elementor 商品网格可被筛选。
PHP 模板中手写的 WP_Query修复 2 可以覆盖;若用 AJAX 模式,请添加这两个钩子。
替换了商品查询或模板的其他插件测试时停用它。如果筛选器随后能正常工作,说明该插件需要使用标准的 WooCommerce 查询。

如果仍然不起作用

  • 在隐私窗口中以未登录状态测试。忽略查询字符串的页面缓存会为每个筛选器 URL 提供相同的未筛选 HTML;请将包含 swoof 的 URL 从页面缓存中排除。
  • 添加代码片段后,直接打开一个筛选器 URL。如果网格仍未被筛选,说明该元素很可能没有查询 product 文章类型,或者它稍后通过自己的 AJAX 请求加载商品,而该请求没有带上筛选参数(某些“加载更多”按钮就是这样)。
  • 如果第一页筛选正确,但第 2 页显示 404 或未筛选的商品,说明网格的分页链接丢失了筛选参数。请检查第 2 页的链接是否仍然包含 swoof=1 和您的选择;更多原因见筛选器分页不起作用。

如果第一节中的短代码测试可以工作,而您的模板仍然不行,请在 HUSKY 支持论坛上发起一个主题,附上页面链接、所用主题或构建器,以及显示商品的元素。