在woocommerce的运营中，有时需要根据用户购物车内商品的具体情况，动态调整可用的配送方式。例如，某些特定商品可能只允许自提，或者不能使用某些平价快递。本教程将详细介绍如何通过自定义代码实现这一功能，确保用户只能看到符合其购物车内容的配送选项。
核心概念：woocommerce_package_rates 过滤器
woocommerce_package_rates 是WooCommerce提供的一个强大过滤器，它允许开发者在计算并显示配送方式之前，对所有可用的配送费率进行修改。该过滤器接收两个参数：
- $rates: 一个包含所有可用配送费率的关联数组，键是配送方式ID，值是配送方式对象。
- $package: 一个包含购物车商品、收货地址等信息的数组。
通过操作$rates数组，我们可以添加、修改或移除特定的配送方式。
实现步骤与代码示例
实现此功能的关键在于两步：首先，检查购物车中是否存在特定的商品；其次，如果存在，则遍历并移除预设的配送方式。
1. 定义触发商品和要隐藏的配送方式
首先，我们需要明确哪些商品的存在会触发配送方式的隐藏，以及具体要隐藏哪些配送方式。这些信息将以ID数组的形式定义。
- 商品ID ($product_ids): 购物车中只要包含这些ID中的任意一个，就会触发隐藏逻辑。
- 配送方式ID ($rate_ids): 当触发条件满足时，这些ID对应的配送方式将被隐藏。
2. 检查购物车商品
我们需要遍历$package['contents']数组，检查购物车中的每一个商品项，判断其product_id是否在预定义的$product_ids数组中。一旦找到任何一个匹配的商品，即可设置一个标志位并停止遍历。
3. 遍历并移除配送方式
如果第2步的检查结果为真（即购物车中存在触发商品），那么就需要遍历当前可用的所有配送方式$rates。对于$rates中的每一个配送方式，我们检查其ID（即数组的键）是否在预定义的$rate_ids数组中。如果匹配，则使用unset()函数将其从$rates数组中移除。
完整代码示例
将以下代码添加到您的主题的 functions.php 文件中，或通过自定义插件引入。
/**
* 根据购物车中的特定商品ID，隐藏一组配送方式。
*
* @param array $rates 所有可用的配送费率。
* @param array $package 包含购物车商品和地址信息的包裹数据。
* @return array 过滤后的配送费率。
*/
function custom_hide_shipping_methods_by_product( $rates, $package ) {
// -------------------------------------------------------------------
// 配置区域：请根据您的需求修改以下数组
// -------------------------------------------------------------------
// 定义当购物车中存在这些商品ID时，将触发配送方式隐藏。
// 例如：array( 240555, 30 )
$trigger_product_ids = array( 240555, 30 );
// 定义要隐藏的配送方式ID。
// 这些ID通常由配送方式类型和实例ID组成，例如 'flat_rate:7', 'local_pickup:24'。
// 例如：array( 'flat_rate:7', 'flat_rate:13', 'local_pickup:24', 'free_shipping:2' )
$shipping_method_ids_to_hide = array(
'flat_rate:7',
'flat_rate:13',
'flat_rate:26',
'flat_rate:27',
'local_pickup:24',
'local_pickup:1',
'free_shipping:2'
);
// -------------------------------------------------------------------
// 逻辑处理：通常无需修改
// -------------------------------------------------------------------
$found_trigger_product = false;
// 遍历购物车中的商品，检查是否存在触发隐藏的商品ID
foreach ( $package['contents'] as $cart_item ) {
if ( in_array( $cart_item['product_id'], $trigger_product_ids ) ) {
$found_trigger_product = true;
break; // 找到一个匹配商品即可停止遍历
}
}
// 如果找到了触发商品，则开始隐藏指定的配送方式
if ( $found_trigger_product ) {
// 遍历所有可用的配送费率
foreach ( $rates as $rate_id => $rate ) {
// 如果当前费率的ID在需要隐藏的列表中，则将其移除
if ( in_array( $rate_id, $shipping_method_ids_to_hide ) ) {
unset( $rates[$rate_id] );
}
}
}
return $rates; // 返回修改后的配送费率数组
}
// 将自定义函数挂载到 woocommerce_package_rates 过滤器上
add_filter( 'woocommerce_package_rates', 'custom_hide_shipping_methods_by_product', 10, 2 );
注意事项
-
代码放置位置:
- 最常见的方法是将代码添加到您当前主题的 functions.php 文件中。
- 更推荐的做法是创建一个自定义插件来管理这类功能性代码，以避免主题更新时代码丢失，并保持代码的模块化。
-
获取配送方式ID:
- 方法一 (检查元素): 在WooCommerce结账页面，右键点击配送方式选项，选择“检查元素”。通常可以在HTML输入字段的value属性中找到配送方式ID，例如 flat_rate:7。
- 方法二 (临时调试): 在上述代码的 custom_hide_shipping_methods_by_product 函数开头，临时添加 error_log( print_r( $rates, true ) ); 或 var_dump( $rates ); exit;。然后访问购物车或结账页面，检查您的PHP错误日志或页面输出，即可看到所有可用配送方式的ID和详细信息。
- 性能考量: 对于购物车商品数量非常大（例如数百个）或需要隐藏的配送方式非常多（例如数十个）的极端情况，虽然上述代码效率较高，但仍需注意潜在的性能影响。在大多数标准电商场景中，此代码的性能表现良好。
- 兼容性: 确保您的代码与当前使用的WooCommerce版本兼容。在WooCommerce大版本更新后，建议测试此功能。
- 与其他插件的冲突: 如果您使用了其他WooCommerce插件也修改了配送方式，可能会出现冲突。请仔细测试，并根据需要调整代码执行的优先级（通过 add_filter 函数的第三个参数）。
总结
通过利用 woocommerce_package_rates 过滤器，我们可以精确控制WooCommerce中配送方式的可见性，根据购物车中商品的具体情况进行动态调整。这不仅能帮助您更好地管理物流规则，还能为顾客提供更清晰、更符合其订单内容的结账体验，从而减少混淆并提高转化率。请务必在生产环境部署前，在测试环境中充分验证代码的正确性。
