HUSKY - WooCommerce Product Filter Professional

WooCommerce 筛选器从分类页跳到商店页:修复方法

您在商品分类页上进行筛选,结果看起来却像 WooCommerce 商店页:标题变成了商店(Shop),分类描述和面包屑消失了,主题的分类页头部不见了,浏览器标签页显示的是商店页的 SEO 标题。这就好像 WooCommerce 筛选器从分类页重定向到了商店页,但请看一下地址栏:多数情况下它显示的仍然是分类 URL。页面并没有跳转;只是 WordPress 不再把它当作分类页了。下文将说明 HUSKY 为什么默认这样做,如何用两项设置保持分类页完整,以及面包屑、描述、主题模板和真正的重定向该如何处理。

为什么筛选后的分类页会变成商店页

应用筛选器后,URL 会带上搜索参数(默认是 swoof=1)以及所选的值,例如 /product-category/shoes/?swoof=1&pa_color=red&really_curr_tax=15-product_cat。默认情况下,插件随后会把 WordPress 的主查询转换为商品归档页:它把查询的文章类型设置为商品,将其标记为文章类型归档,并关闭其分类法标志。这保证了无论筛选表单位于何处,筛选器搜索的都是商品。副作用是,对于这次请求,无论谁来查询,该页面都不再是分类归档页:

您看到的内容由什么决定筛选后的结果
页面标题WooCommerce 只在分类法归档页上输出分类项名称商店页的标题
商品上方的文字分类法归档页显示分类描述,商品归档页显示商店页内容显示商店页内容,而不是分类描述
面包屑WooCommerce 先检查“这是商品分类吗?”,再检查“这是商店吗?”首页 / 商店
SEO 标题和元描述Yoast SEO、Rank Math 等插件读取当前归档页商店页的标题和描述
主题区块、页头图片、Elementor 或 Divi 归档模板、Widget Logic 条件is_product_category() 和 is_tax() 之类的条件仅限分类页的元素消失;可能会改用商店页的模板

商品本身仍然是正确的:分类仍然来自 URL,而 really_curr_tax 参数会告诉筛选器访客是从哪个分类开始的。只是商品周围的内容来错了地方。标签、品牌和自定义分类法归档页上也是如此。在 AJAX 模式下,您可能要到重新加载页面或打开他人分享的已筛选链接时才会注意到,因为 AJAX 更新替换的是商品,而不是标题。

解决办法:禁用 swoof 影响

  1. 前往WooCommerce → 设置 → Products Filter → 高级 → 选项。
  2. 将禁用 swoof 影响(Disable swoof influence)设置为是(Yes)并保存。
  3. 清除页面缓存,并在隐私窗口中测试:在某个分类上进行筛选,然后重新加载页面。

设置为是(Yes)时,插件不会改动页面类型。筛选后的分类页仍然是分类归档页,因此 WooCommerce、主题、页面构建器和 SEO 插件都会显示该分类自己的标题、描述、模板和元数据。筛选仍然有效,因为所选的值是应用于商品查询本身的,而不是通过页面类型。为此您不需要 SEO URL 请求扩展。

该设置是全局的。开启之后,请测试商店页、分类、标签或品牌归档页、商品搜索结果以及所有使用 [woof_products] 的页面上的筛选。用 [woof_products] 构建的页面不受影响,因为插件永远不会把 WordPress 页面变成商品归档页。如果设置为是(Yes)后,某个主题在已筛选的归档页上不再显示商品或布局错乱,说明该主题在搜索期间依赖商店页模板:请把该选项改回否(No),并使用下面更有针对性的修复方法。

如果筛选器忘记了分类:分类页的额外检查

在分类归档页上,筛选器会记住访客所在的分类。它用这个信息在分类区块中只列出子分类,只统计该分类的商品,并在筛选链接中添加 really_curr_tax。当插件未能检测到它时,您会在第一次筛选后看到这样的情形:分类区块跳回到整个商店的顶级分类,计数不再与该分类相符,而在该区块中的选择会把人带离这个分类。这就是“它跳到了商店页”的另一半原因。

将分类页的额外检查(Additional check of the category page)(高级 → 选项,就在禁用 swoof 影响(Disable swoof influence)下方)设置为是(Yes)。这样插件会在构建筛选器的那一刻从 WordPress 读取当前分类,而不是依赖之前保存的值。区块主题会自动进行这项检查;经典主题以及以自己的方式组装归档页的构建器(例如 Avada)可能需要将它与禁用 swoof 影响(Disable swoof influence)一起开启。各类页面上分类区块会显示什么,请参阅为什么分类筛选器只显示子分类。

面包屑仍然被隐藏:插件自带的 CSS

筛选器处于活动状态时,插件会给 <body> 标签添加 woof_search_is_going 类,其样式表会隐藏 WooCommerce 面包屑(nav.woocommerce-breadcrumb)以及紧随其后的 h1.page-title。在默认设置下,该面包屑在分类页上会显示为首页 / 商店(Home / Shop),所以隐藏它是两害相权取其轻。当禁用 swoof 影响(Disable swoof influence)为是(Yes)时,面包屑是正确的,您可以重新显示它:

/*
 * HUSKY: keep the WooCommerce breadcrumb (and a title right after it)
 * visible on filtered pages.
 * Products Filter → Advanced → Code → Custom CSS code, or Appearance → Customize → Additional CSS.
 */
body.woof_search_is_going nav.woocommerce-breadcrumb,
body.woof_search_is_going nav.woocommerce-breadcrumb + h1.page-title {
    display: block;
}

如果您的主题用 flexbox 排布面包屑,请使用 display: flex; 代替 block。由 Yoast SEO、Rank Math 或主题自带函数输出的面包屑不会被插件隐藏;它们只是跟随页面类型,所以设置为是(Yes)后会显示该分类。

如果必须保留默认设置

当您的主题需要禁用 swoof 影响(Disable swoof influence)为否(No)时,请逐项恢复缺失的部分:

  • 分类描述。常见问题已筛选页面上不显示分类描述中有一段现成的代码片段,它从 really_curr_tax 读取分类,并把其描述输出在商品上方。
  • 面包屑。上面的 CSS 可以显示它们,但它们会显示为首页 / 商店(Home / Shop)。
  • 小工具、主题钩子和自定义代码中的条件。筛选期间 is_product_category() 会返回 false。请使用一个同时从筛选链接中读取分类的辅助函数:
/**
 * True on a product category archive, also while HUSKY filters it
 * with "Disable swoof influence" = No.
 * Usage: my_is_product_cat() or my_is_product_cat( 'shoes' ), e.g. in Widget Logic.
 * Child theme functions.php or a code snippets plugin.
 */
function my_is_product_cat( $slug = '' ) {
    if ( is_product_category( $slug ) ) {
        return true;
    }
    if ( empty( $_GET['really_curr_tax'] ) ) {
        return false;
    }
    // Format: "15-product_cat" (term ID, dash, taxonomy)
    $parts = explode( '-', sanitize_text_field( wp_unslash( $_GET['really_curr_tax'] ) ), 2 );
    if ( count( $parts ) !== 2 || 'product_cat' !== $parts[1] ) {
        return false;
    }
    $term = get_term( (int) $parts[0], 'product_cat' );
    if ( ! $term instanceof WP_Term ) {
        return false;
    }
    return '' === $slug || $term->slug === $slug;
}

如果只想检查筛选器是否处于活动状态,插件提供了一个全局函数 is_woof_search_going()。页头图片以及其他仅存在于真正归档页上的主题元素,只有在设置为是(Yes)时才会恢复。

当 URL 真的变成商店页时

如果筛选后地址栏显示的是商店页 URL,那就是真正的重定向,原因也不同。在不是商品归档页的页面上,例如被设计成分类着陆页的 WordPress 页面,筛选器会查找一个可以刷新的商品列表。找不到时,它会把访客送到商店页。有三种解决办法:

  • 使用真正的分类归档页(/product-category/...),用主题或构建器的归档模板来设计它,然后应用上述设置。
  • 保留该页面,并用限定为该分类的 [woof_products] 来显示其商品,详见自定义页面上的产品筛选器。
  • 如果页面上的某个构建器网格已经能响应筛选器,但使用的是自己的标记,请用 woof_not_redirect 告诉脚本留在当前页面;代码片段见筛选器 URL 变了但商品没变。

还有一种情况根本不是重定向。在商店页上通过筛选器选择一个分类,是缩小商店的范围;它不会打开该分类的归档页。URL 仍然是商店页 URL,而分类页头图片之类仅限归档页的元素不会出现。如果希望访客直接进入分类本身,请在菜单或导航区块中为他们提供分类链接,而把筛选器留作缩小范围之用。

检查清单

  • 筛选后,地址栏仍然显示 /product-category/...:这是页面类型的问题,不是重定向。
  • 禁用 swoof 影响(Disable swoof influence) = 是(Yes),已清除页面缓存,并在隐私窗口中及重新加载后测试过。
  • 分类区块或计数跳到了整个商店:分类页的额外检查(Additional check of the category page) = 是(Yes)。
  • 面包屑:已添加上面的 CSS。
  • 商店页、标签或品牌归档页、搜索结果以及 [woof_products] 页面仍然能正确筛选。

如果完成这些步骤后,分类页仍然丢失标题或模板,请在 HUSKY 支持论坛上发起一个主题,附上分类链接、已筛选的链接以及您所用主题或页面构建器的名称,我们会进行查看。