WooCommerce 尺码筛选器显示缺货变体:修复方法
顾客勾选了尺码 M,WooCommerce 的尺码筛选器却显示了一件 M 码变体已缺货的 T 恤。商品页面上写着该尺码已售罄,顾客随即离开。筛选器并没有坏:默认情况下,它和 WooCommerce 一样,是按父商品来判断可变商品的,只要有任何一个变体有货,父商品就保持有货。下文将说明筛选器为何会显示缺货变体,HUSKY 中让它检查所选尺码库存的设置,该检查遵循的规则,以及结果或计数仍然不对时需要修复什么。
为什么尺码筛选器会显示已售罄的变体
在 WooCommerce 中,一个可变商品由两类记录组成。商店页和分类页列出的是父商品。它的属性(Attributes)标签页中保存着各个值(尺码:S、M、L;颜色:黑色、红色),这些值作为属性项附加在父商品上。每个变体,例如 M / 黑色,则是一条独立的记录,有自己的价格和库存。
属性筛选器查找的是带有所选属性项的父商品。如果 T 恤的属性(Attributes)标签页中列有 M,那么无论 M 变体的库存如何,它都匹配尺码 M。父商品的库存状态也帮不上忙:只要至少有一个变体有货,WooCommerce 就会把它保持为有货(In stock)(如果有变体处于延期交货,则为延期交货(On backorder)),只有当每个变体都售罄时才会切换为缺货(Out of stock)。出于同样的原因,WooCommerce 的选项隐藏目录中缺货的商品(Hide out of stock items from the catalog)(WooCommerce → 设置 → 商品 → 库存)也解决不了这个问题:只有当 T 恤的所有尺码都没了,它才会隐藏这件 T 恤。“尺码 M 有货吗?”这个问题必须去问变体,而筛选器只有在您告诉它时才会去问。
让 HUSKY 检查所选尺码的库存
变体检查属于有货(In stock)元素。在 HUSKY 3.4.6 中,它是始终启用的内置扩展,因此无需在扩展(Extensions)标签页中开启任何东西。
- 打开 WooCommerce → 设置 → Products Filter,进入结构(Structure)标签页,找到有货(In stock)一行。如果希望顾客看到该复选框,请将其设置为是(Yes)。
- 点击它旁边的齿轮按钮(附加选项(additional options))。在打开的窗口中,把第一项设置在可变商品中搜索(Search in variable produts)设为在商品及其变体中搜索(Search in products and their variations)。默认值仅限简单商品(Simple products only)只看每个商品自身的库存状态,而对可变商品来说,那就是父商品的状态。
- 保持使用新数据库(Use new DB.)为是(Yes),并在显示方式(View)下选择复选框(Checkbox)或开关(Switcher)。
- 保存,清除页面缓存并测试:选择一个您确知在某个商品中已售罄的尺码,勾选有货(In stock),该商品应当从结果中消失。
只有当有货(In stock)是搜索的一部分,并且至少选择了一个商品属性(pa_ 分类法,例如尺码或颜色)时,检查才会运行。没有有货(In stock)时,属性筛选仍然以父商品为准。该设置会带来额外的数据库开销,这就是它默认关闭的原因;请参阅下面关于速度的部分。
不使用复选框也能应用“有货”
如果已售罄的尺码永远不应该匹配,就不必依赖顾客去勾选这个复选框。woof_get_request_data 过滤器可以把有货条件添加到插件运行的每一次搜索中:
/*
* HUSKY: always search in-stock products only.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
$data['stock'] = 'instock';
return $data;
});
如常见问题仅显示有货商品中所述,这样还会把缺货的简单商品和完全售罄的可变商品从筛选器控制的每个商品列表中移除。请将有货(In stock)一行设置为否(No),这样顾客就不会看到一个始终处于勾选状态的复选框。
如果希望顾客浏览时仍能看到缺货商品,只在按属性筛选时才将其剔除,那么只在搜索中含有属性时才添加该条件:
/*
* HUSKY: apply In stock only when a product attribute (pa_*) is being filtered.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_get_request_data', function ($data) {
foreach (array_keys($data) as $key) {
if (strpos($key, 'pa_') === 0) {
$data['stock'] = 'instock';
break;
}
}
return $data;
});
变体检查如何判定
当使用新数据库(Use new DB.)设置为是(Yes)时,HUSKY 会读取 WooCommerce 的商品属性查找表,其中每个变体的每个属性值都有一行记录,并附带一个有货标志。对于每个可变商品,它会收集带有任一所选值的变体,如果存在这样的变体而且没有一个有货,就移除该商品。这条规则可以解释乍看之下有些奇怪的结果:
| 商品 | 搜索 | 结果 |
|---|---|---|
| S 有货,M 售罄 | 尺码 M + 有货 | 隐藏 |
| S 有货,M 售罄 | 尺码 S 或 M + 有货 | 显示:S 可购买 |
| 属性(Attributes)标签页中列有 M,但不存在 M 变体 | 尺码 M + 有货 | 显示:不存在 M 变体,也就不可能缺货 |
| 某个变体设置为任意尺码(Any Size),且有货 | 尺码 L + 有货 | 显示:任意尺码(Any Size)变体对商品上列出的每个尺码都算数 |
| M / 黑色售罄,M / 红色和 S / 黑色有货 | 尺码 M + 颜色黑色 + 有货 | 显示:每个所选值都有一个有货的变体 |
| M 变体延期交货(On backorder) | 尺码 M + 有货 | 显示:延期交货算作可购买 |
第三行是数据问题,而不是筛选器的问题。删除了变体之后仍留在父商品属性(Attributes)标签页中的值,或者从未用于任何变体的值,会继续匹配并继续被计数。请只保留有变体的值,或者创建该变体并将其标记为缺货(Out of stock)。
最后两行是该检查的局限。不同属性的值是逐个检查的,而不是按顾客选择的确切组合来检查,因此当那一个具体组合售罄时,商品仍可能出现。延期交货的变体是可以购买的,所以有货(In stock)会保留它们;如果它们也不应该匹配,请添加排除延期交货商品元素,它有同样的在商品及其变体中搜索(Search in products and their variations)设置。还要检查导入实际写入了什么:被保存为延期交货(On backorder)而不是缺货(Out of stock)的变体会留在结果中。
结果仍然不对:刷新 WooCommerce 查找表
查找表(wc_product_attributes_lookup)属于 WooCommerce。通过 WooCommerce 保存商品或变体时它会更新,默认带有短暂延迟:WooCommerce 把更新安排为后台操作。在以下情况下,该表会落后于实际数据:
- 库存是由导入或同步工具更改的,这些工具直接写入数据库,而不是通过 WooCommerce 保存商品;
- 后台操作没有运行,例如禁用了 WP-Cron 却没有用服务器 cron 来替代。钩子为
woocommerce_run_product_attribute_lookup_update_callback的待处理操作就会在 WooCommerce → 状态 → 计划操作下堆积起来; - 对该表的完整重新生成被中断了。
这时筛选器使用的是旧的库存数据,结果看起来杂乱无章。要重建该表,请打开 WooCommerce → 状态 → 工具,点击重新生成商品属性查找表(Regenerate the product attributes lookup table)旁边的重新生成(Regenerate)。它会在后台分批运行;在完成之前,按钮会显示填充进行中(Filling in progress)和一个计数器。关于价格和库存筛选器不起作用的常见问题涉及同样的工具。如果库存经常变动,可以考虑 WooCommerce → 设置 → 商品 → 高级 → 商品属性查找表(Product attributes lookup table) → 直接更新(Direct updates),它会在保存商品的那一刻更新该表。
作为测试,或者当该表无法保持最新时,可将使用新数据库(Use new DB.)设置为否(No)。这样 HUSKY 会读取变体本身(它们的 _stock_status 和 attribute_pa_… 值)。变体很多时这种方式较慢,而且遵循更严格的规则:只要带有所选值的任一变体缺货,该商品就会被移除,所以“尺码 S 或 M”会把上表中的那件 T 恤隐藏起来。要获得与查找表相同的规则,请添加:
/*
* HUSKY, In stock with "Use new DB." = No: keep a variable product when at least
* one variation with a selected value is in stock.
* Child theme functions.php or a code snippets plugin.
*/
add_filter('woof_exclude_existing_variations', '__return_true');
包含缺货变体的计数
尺码旁边的数字来自与结果相同的查询,因此遵循相同的规则。
- 搜索中没有有货(In stock)时,M 的计数包含父商品上带有 M 的每个商品,无论是否售罄。当有货(In stock)生效时(已勾选,或通过上面的代码片段强制启用)并且开启了变体搜索,每个尺码都会通过针对该尺码的变体检查来计数。
- 在此基础上再加上动态重新计数(Dynamic recount)和隐藏空项(Hide empty terms)(选项(Options)标签页),计数降为零的尺码就会从筛选器中消失,这样已售罄的尺码就根本不会再被提供。
- 如果 WooCommerce 隐藏了缺货商品,请将遵循目录可见性(Listen catalog visibility)(高级 → 选项)保持为是(Yes)。设置为否(No)时,计数器也会包含 WooCommerce 隐藏的商品,某个分类项可能显示有计数,而它的结果却是空的。
- 启用缓存筛选器中每个项目的动态重新计数结果(Cache dynamic recount number for each item in filter)(高级 → 选项)后,计数会被存储起来,在缓存被自动清理或通过清除缓存(clear cache)按钮清除之前,不会随库存变化而更新。页面缓存同样可能提供旧的数字。
速度:检查变体的代价
每次将属性与有货(In stock)组合的搜索都会运行额外的查询:使用新数据库(Use new DB.)为是(Yes)时,对查找表执行两次查询;为否(No)时,对所有匹配的变体执行一次查询。启用动态重新计数(Dynamic recount)时,每个需要计数的值也都会运行该检查,所以一个包含 40 个尺码和颜色的筛选器,每个页面会重复 40 次。若有数万个变体,这一点就很明显。
- 保持使用新数据库(Use new DB.)为是(Yes),并让查找表保持最新;这是更快的方法。
- 启用缓存筛选器中每个项目的动态重新计数结果(Cache dynamic recount number for each item in filter),并选择与您库存变化速度相匹配的自动清理间隔。
- 更多选项见如何加速大型商品目录中的产品筛选。
涡轮模式在这里不是捷径。它根据预先生成的文件在访客的浏览器中进行筛选,其有货(In stock)检查只看每个商品自身的库存状态:变体设置在那里不起作用,库存变化只有在文件重建后才会体现。如果已售罄的尺码绝不能匹配,请保持涡轮模式关闭;它的其他限制列在涡轮模式故障排除中。
检查清单
- 有货(In stock) → 齿轮 → 已选择并保存在商品及其变体中搜索(Search in products and their variations)。
- 有货(In stock)是搜索的一部分:由顾客勾选,或通过
woof_get_request_data强制启用。 - 可变商品只列出有变体的属性值。
- 已售罄的变体状态为缺货(Out of stock),而不是延期交货(On backorder)。
- 导入之后已重新生成查找表,并且计划操作中没有卡住的查找表更新。
- 库存变化后已清除重新计数缓存和页面缓存;涡轮模式已关闭。
如果筛选器仍然返回所选尺码已售罄的商品,请在 HUSKY 支持论坛上发起一个主题,附上筛选器链接、该商品以及其各变体的库存状态。