Elementor Loop Grid WooCommerce 筛选失效怎么办
在使用 Elementor 构建的商店中勾选筛选器后,Loop Grid 仍然显示所有产品,或者在选中多个值时只应用第一个,又或者筛选之后分类模板变成了普通的 WooCommerce 列表。当 Elementor Loop Grid WooCommerce 筛选不工作时,原因取决于两点:由哪个 Elementor 元素输出产品,以及 HUSKY 的 AJAX 模式是否开启。请先确定是哪个元素,每种元素都有各自的修复方法。
您的产品由哪个 Elementor 元素显示
HUSKY 并不绘制产品网格。它把自己的条件添加到 WooCommerce 的产品查询中:商店以及分类、标签和属性归档页的主查询、通过 WooCommerce 的 [products] 短代码构建的查询,以及它自己的 [woof_products] 短代码。自行构建查询的 Elementor 元素则收不到筛选器的条件。
| 元素 | 是否跟随筛选器 | 处理方法 |
|---|---|---|
| Theme Builder 产品归档中的 Archive Products 小工具,或使用 当前查询 (Current Query) 的 Products 小工具 | 是,它使用商店的主查询 | 重定向模式可保留原有设计;关于 AJAX 模式和分类模板,请参阅归档页部分 |
| 使用自身查询来源(最新、促销、精选产品)的 Products 小工具 | 通常是:该小工具基于 WooCommerce 的产品短代码构建 | 无需特别处理;筛选时页面会重新加载 |
| 使用产品循环模板的 Loop Grid | 否,它运行自己的查询 | 让查询跟随筛选器,或更换该元素 |
| 附加组件包的产品网格(WooLentor、Premium Addons、Unlimited Elements、JetWooBuilder 等) | 通常否 | 与 Loop Grid 相同 |
包含 [woof_products] 的 Shortcode 小工具 | 是,AJAX 模式下也一样 | 可用于任何位置;使用主题的 WooCommerce 产品卡片 |
三个快速检查可以告诉您属于哪种情况:
- 筛选后的网址包含
swoof=1和您所选的值。这说明筛选器已经完成了它的工作,是该元素忽略了请求。 - 对照元素。在您的网格旁边放一个包含
[woof_products per_page=4]的 Shortcode 小工具,进行筛选并对比。如果短代码被筛选而您的网格没有,说明该网格运行的是自己的查询。 - AJAX 区域。打开页面源代码(Ctrl+U)并搜索
woof_results_by_ajax。如果没有它,AJAX 模式就没有可替换的内容,即使开启了 AJAX,每次更改筛选器也都会重新加载页面。
Loop Grid 与附加组件小工具:让它们的查询跟随筛选器
Loop Grid 自己向数据库请求产品,所以会一直列出整个商品目录。您有三种解决办法,从“保留循环设计”到“代码最少”依次如下。
保留 Loop Grid:用 pre_get_posts 限制它的查询
一小段代码会询问 HUSKY 哪些产品符合当前筛选条件,并把页面上其他所有产品查询限制在这些产品之内。请使用“筛选器网址变了但产品没变”的修复方法 2中的加强版本;把它复制到子主题的 functions.php 或代码片段插件中。与 Elementor 兼容性常见问题中的旧代码相比,它不会影响 wp-admin 中的产品列表,会让网格的第 2 页及之后的页面保持筛选状态,并且在没有产品匹配时显示“未找到任何内容”,而不是整个商品目录。不要同时运行两段代码,请替换掉旧的那段。
然后调整设置:
- 筛选时必须重新加载页面:代码在加载筛选后的网址时对网格进行筛选。Loop Grid 没有 AJAX 区域,所以这一点会自动实现;如果页面上还有 AJAX 区域(见上面的检查 3),请将尝试对商店启用 AJAX (Try to ajaxify the shop) 设为否 (No)(WooCommerce → 设置 (Settings) → Products Filter → 选项 (Options)),否则只会更新那个区域。
- 在普通页面(不是 Theme Builder 归档)上,除非筛选器在页面上找到 WooCommerce 产品列表或
[woof_products],否则会把结果发送到商店页面,而 Loop Grid 两者都不是。请告诉它留在当前页面:/** * HUSKY: keep filter results on the page with the Loop Grid. * Child theme functions.php or a code snippets plugin. */ add_action( 'wp_footer', function () { if ( is_page( 123 ) ) { // ID of the page with the Loop Grid echo '<script>var woof_not_redirect = 1;</script>'; } } ); - 这段代码会影响筛选页面上的每一个产品查询,包括“相关产品”或“畅销产品”轮播。若只想作用于一个页面,请取消注释其中的
is_page()行并填入该页面的 ID。 - 只在某个元素确实运行自己的查询的地方添加这段代码。在由 Archive Products 小工具显示产品的地方不需要它;如果之前在那里添加过,请将其移除。
- 筛选后检查网格第 2 页的链接:它必须仍然包含
swoof=1和所选的值。如果“加载更多”或无限滚动模式获取下一页时不带这些参数,从第 2 页开始就会显示未筛选的产品;请尝试数字分页,并再次检查其链接。
改用 Products 小工具
Elementor Pro 的 Products 小工具通常无需任何代码就会跟随筛选器:在归档页使用当前查询 (Current Query),在其他位置使用自身的查询来源。如果在该小工具自带的控件中设置的卡片设计已经够用,那么它是 Loop Grid 最简单的替代品。
使用 [woof_products] 短代码
在 Shortcode 小工具中放入插件自带的 [woof_products] 短代码,即可在任何页面上筛选并支持 AJAX:
[woof_products per_page=12 columns=4 is_ajax=1]
它使用主题的 WooCommerce 卡片(content-product.php)显示每个产品,而不是 Elementor 循环模板。在只应显示一个分类的页面上,请让筛选器和产品列表使用相同的条件:[woof taxonomies=product_cat:25] 和 [woof_products taxonomies=product_cat:25 per_page=12 is_ajax=1],并把 25 替换为您的分类 ID。
选中了多个值,却只应用第一个
当同一属性的各个值之间采用 OR 逻辑时,选择红色、蓝色和绿色应显示这三种颜色中任意一种的产品。如果在归档模板上设置为当前查询 (Current Query) 的 Loop Grid 只显示红色的产品,说明 Loop Grid 以自己的方式根据请求构建查询,只保留了第一个值。筛选器本身没有问题:同样的请求在 Products 小工具或 [woof_products] 中会显示正确的产品。
请把 Loop Grid 换成设置为当前查询 (Current Query) 的 Products 小工具,或者换成 [woof_products]。同时检查该属性确实使用 OR:在结构 (Structure)选项卡中打开该属性的附加选项,查看筛选逻辑 (Logic of filtering)。AND 只适用于允许多个值的筛选器类型,例如复选框。
Theme Builder 归档:设计丢失与模板错误
AJAX 结果看起来像普通的 WooCommerce 列表
如果 Archive Products 小工具内部存在 AJAX 区域,每次更改筛选器后产品会在原位被替换,但新的 HTML 是由 [woof_products] 在服务器上根据 WooCommerce 的标准部件渲染的,不经过 Elementor 的页面渲染。其中没有 Elementor 的类和小工具设置:产品会失去该小工具的网格、间距和按钮文字。AJAX 模式如何重建网格,请参阅 AJAX 筛选破坏产品网格布局。
可靠的修复方法是将尝试对商店启用 AJAX (Try to ajaxify the shop) 设为否 (No):筛选后的网址由 Elementor 渲染,外观与模板完全一致。如果想保留 AJAX,可以用 woof_draw_products_html 过滤器修补响应,让 Elementor 的网格 CSS 重新生效:
/**
* HUSKY AJAX results inside an Elementor Archive Products widget:
* add the class Elementor's grid styles expect.
* Child theme functions.php or a code snippets plugin.
*/
add_filter( 'woof_draw_products_html', function ( $html, $shortcode_str ) {
return str_replace(
'<ul class="products columns-',
'<ul class="products elementor-grid columns-',
$html
);
}, 10, 2 );
使用之前,请在全新加载的页面上检查产品列表,确认 ul.products 上的类名;如有不同,请以您页面上的为准。其余差异,例如按钮被多包了一层元素或标签发生变化,用几行 CSS 处理比用 PHP 更容易。如果筛选后列数发生变化,请按布局文章中所示,用 loop_shop_columns 进行设置。
筛选后的分类页面使用了商店模板
筛选器处于激活状态时,HUSKY 默认会把请求标记为产品文章类型归档,并关闭 WordPress 的“分类法归档”标志。于是 Elementor 的显示条件看到的是商店而不是分类:分配给“产品分类”的模板被通用模板取代,归档标题显示的是商店名称而不是分类名称。请在高级 (Advanced) → 选项 (Options) 中将禁用 swoof 影响 (Disable swoof influence) 设为是 (Yes),然后再次测试。详细说明和副作用请参阅筛选时保持分类页面。
分类模板上显示整个商店数量的计数,通常来自筛选器短代码本身:带有 dynamic_recount=0 的 [woof] 不会针对当前分类重新计数。请移除该属性,或将其设为 1。
Elementor 弹窗或侧滑面板中的筛选器没有反应
HUSKY 在页面就绪时只把脚本绑定到筛选表单一次。如果弹窗或侧滑面板稍后才插入其内容,筛选器虽然出现了,点击却没有任何反应,因为新表单从未被初始化。打开页面源代码并搜索 woof_redraw_zone:如果弹窗打开之前筛选器的标记不在其中,就是这种情况。
请改用插件自带的滑出面板:在 Shortcode 小工具中放入 [woof_slideout location="left"],或者在滑出面板 (Slideout)选项卡中将全局可见性 (Global visibility) 设为显示 (Show),把它添加到商店页面。它的表单从一开始就是页面的一部分,因此与其他筛选器的工作方式相同。其他方案包括:随页面一起渲染内容的弹窗,或用按钮显示和隐藏的区块。
启用 HUSKY 后 Elementor 编辑器无法加载
旧版本中的编辑器错误(Call to a member function get() on null)在当前版本中已经处理:在 Elementor 编辑器中打开页面时,[woof_products] 会跳过商店循环的钩子。请先更新插件。如果仅在 HUSKY 启用时编辑器仍然卡住,请从 Elementor 面板中移除 HUSKY 的经典 WordPress 小工具;您仍然可以通过 Shortcode 小工具放置筛选器:
/**
* Hide HUSKY's WordPress widget from the Elementor panel.
* Child theme functions.php or a code snippets plugin.
*/
add_action( 'elementor/widgets/register', function ( $widgets_manager ) {
$widgets_manager->unregister( 'wp-widget-woof_widget' );
} );
这里使用的是当前 Elementor 版本的注册钩子;Elementor 编辑器冲突常见问题中的旧钩子在这些版本中已被弃用。
检查清单
- 您知道是哪个元素输出产品,并且作为对照的
[woof_products]在同一页面上能正确筛选。 - Loop Grid 或附加组件网格:用加强版
pre_get_posts代码替换旧代码,筛选时页面会重新加载,第 2 页的链接保留swoof=1。 - 同一属性的多个值:使用 Products 小工具或
[woof_products],而不是设置为当前查询 (Current Query) 的 Loop Grid。 - Theme Builder 分类模板:禁用 swoof 影响 (Disable swoof influence) = 是 (Yes);关闭 AJAX,或用
woof_draw_products_html修补响应。 - 弹窗中的筛选器:替换为
[woof_slideout]。 - 已清除缓存,并在隐私窗口中测试了结果。
如果对照短代码正常,而您的 Elementor 元素仍然不行,请在 HUSKY 支持论坛上发起主题,附上页面链接,以及显示产品的元素和附加组件的名称。