如何修改WooCommerce默认变体自动选择PHP脚本以兼容缺货情况
可实现自动匹配有库存变体的代码改造
原脚本核心缺陷
原逻辑仅从商品属性列表中提取排序第一的属性值作为默认选中项,完全未校验对应变体的实际库存状态,只要排序靠前的尺寸处于缺货状态,就无法匹配到有效在售变体,最终导致变体图片无法自动加载。
改造实现逻辑
- 识别URL中携带的预选属性(即从商店页颜色气泡跳转时传递的指定颜色值)
- 拉取商品下所有已发布、有库存的有效变体
- 优先匹配和预选属性(如指定颜色)一致的在售变体,从该变体池中按属性排序取第一个对应尺寸
- 若同属性下靠前排序的尺寸缺货,自动顺延查找后续第二个、第三个有库存的尺寸,直到匹配到有效组合
- 将匹配到的有效属性组合写入商品默认属性元字段,触发WooCommerce自动加载对应变体的图片
可直接复用的改造后代码
<?php add_action('woocommerce_before_single_product_summary', 'quadlayers_product_default_attributes'); function quadlayers_product_default_attributes() { global $product; // 仅针对可变商品执行逻辑 if (!$product->is_type('variable')) return; // 读取URL中携带的预选属性(匹配从列表页跳转过来的已选颜色) $preselected_attrs = []; foreach ($product->get_attributes() as $taxonomy => $attribute) { if (!$attribute->get_variation()) continue; $attr_param_key = 'attribute_' . sanitize_title($taxonomy); if (isset($_GET[$attr_param_key])) { $preselected_attrs[$taxonomy] = sanitize_title(wp_unslash($_GET[$attr_param_key])); } } // 拉取所有在售、已发布的有效变体 $valid_variations = wc_get_products([ 'parent_id' => $product->get_id(), 'type' => 'variation', 'status' => 'publish', 'limit' => -1, 'stock_status' => 'instock', 'return' => 'objects' ]); // 无有效库存时触发原逻辑兜底 if (empty($valid_variations)) { $existing_defaults = get_post_meta($product->get_id(), '_default_attributes', true); if (!empty($existing_defaults)) return; $new_defaults = []; $product_attributes = $product->get_attributes(); foreach ($product_attributes as $key => $attributes) { $values = explode(',', $product->get_attribute($key)); if (isset($values[0])) { $new_defaults[$key] = sanitize_key($values[0]); } } update_post_meta($product->get_id(), '_default_attributes', $new_defaults); return; } // 匹配和预选属性一致的在售变体 $matched_variation = null; foreach ($valid_variations as $variation) { $variation_attr_map = $variation->get_attributes(); $is_full_match = true; foreach ($preselected_attrs as $taxonomy => $selected_val) { if (($variation_attr_map[$taxonomy] ?? '') !== $selected_val) { $is_full_match = false; break; } } if ($is_full_match) { $matched_variation = $variation; break; } } // 无完全匹配项时取第一个在售变体兜底 if (!$matched_variation) { $matched_variation = reset($valid_variations); } // 更新默认属性元字段,触发变体图片自动加载 $new_defaults = $matched_variation->get_attributes(); update_post_meta($product->get_id(), '_default_attributes', $new_defaults); } ?>
改造后实际效果
- 从商店页点击颜色气泡跳转时,会自动选中同颜色下第一个有库存的尺寸,直接加载对应变体图片,无需用户手动选择尺寸
- 同属性下靠前排序的尺寸缺货时,会自动顺延匹配后续有库存的尺寸,不会出现无选中值的空白状态
- 无需对店铺内1000+商品逐一手改配置,脚本会在商品详情页加载时自动校验、刷新有效默认属性
落地注意事项
- 代码可添加到子主题的
functions.php文件,或通过自定义代码片段插件加载,避免主题更新造成代码丢失 - 代码生效后需清除WooCommerce缓存、浏览器缓存,让旧的无效默认属性值被新逻辑重新计算替换
内容的提问来源于stack exchange,提问作者eldds1997
相关产品推荐
相关产品推荐

