本教程旨在指导您如何在 WooCommerce 中实现优惠券仅对处于缺货状态的商品生效。我们将探讨常见的实现误区，并提供一种利用 woocommerce_coupon_get_discount_amount 过滤器的高效解决方案。通过修改折扣金额为零的方式，确保优惠券的价值仅分配给预购或缺货商品，从而实现精准的营销策略。
理解优惠券应用机制与常见挑战
在 WooCommerce 中，为特定商品类型（如缺货商品）应用优惠券是一个常见的需求。开发者通常会尝试通过 woocommerce_coupon_is_valid 过滤器来控制优惠券的整体有效性。然而，直接在此过滤器中遍历购物车商品并判断其是否缺货，可能无法达到预期效果。这是因为 WooCommerce 的 WC_Discounts 类在内部处理优惠券与购物车商品的关联逻辑，简单地将优惠券标记为有效或无效，并不能精确控制其折扣金额如何分配到每个具体商品上。例如，如果购物车中既有缺货商品也有现货商品，即使优惠券被标记为有效，其折扣也可能平均分配给所有商品，而非仅限于缺货商品。
解决方案：利用 woocommerce_coupon_get_discount_amount 过滤器
为了精确控制优惠券仅应用于缺货商品，我们推荐使用 woocommerce_coupon_get_discount_amount 过滤器。这个过滤器允许我们在计算每个购物车商品的具体折扣金额时进行干预。其核心思想是：如果某个商品不是缺货状态，我们就将其应获得的折扣金额设置为零，从而间接实现优惠券仅对缺货商品生效的目的。
实施步骤
将以下代码添加到您的主题 functions.php 文件或自定义插件中：
/**
* 过滤 WooCommerce 优惠券的折扣金额，使其仅应用于缺货商品。
*
* @param float $discount 当前计算的折扣金额。
* @param float $price_to_discount 商品可用于折扣的价格。
* @param array $cart_item 当前的购物车商品数据。
* @param bool $single 是否为单个商品折扣计算。
* @param WC_Coupon $coupon 当前正在处理的优惠券对象。
* @return float 调整后的折扣金额。
*/
function filter_woocommerce_coupon_get_discount_amount( $discount, $price_to_discount, $cart_item, $single, $coupon ) {
// 检查当前商品是否为缺货状态
// 如果商品不是缺货状态，则将其折扣金额设置为 0
if ( ! $cart_item['data']->is_on_backorder() ) {
$discount = 0;
}
return $discount;
}
add_filter( 'woocommerce_coupon_get_discount_amount', 'filter_woocommerce_coupon_get_discount_amount', 10, 5 );代码解析
-
filter_woocommerce_coupon_get_discount_amount 函数：
- 此函数接收五个参数：$discount (当前计算的折扣金额), $price_to_discount (商品可用于折扣的价格), $cart_item (当前的购物车商品数据), $single (是否为单个商品折扣计算), 和 $coupon (当前正在处理的优惠券对象)。
- 我们的目标是修改 $discount 的值。
-
! $cart_item['data']->is_on_backorder()：
- $cart_item['data'] 获取到的是 WC_Product 对象。
- is_on_backorder() 方法用于判断当前商品是否处于缺货状态。
- ! 运算符表示“非”，因此 ! $cart_item['data']->is_on_backorder() 检查的是商品是否 不 处于缺货状态。
-
$discount = 0;：
- 如果商品不是缺货状态，我们就将它原本应获得的折扣金额强制设置为 0。这意味着，即使购物车中存在该商品，并且优惠券本身是有效的，这个非缺货商品也不会获得任何折扣。
-
add_filter(...)：
- 将我们的自定义函数挂载到 woocommerce_coupon_get_discount_amount 过滤器上。优先级 10 是默认值，5 表示函数接收五个参数。
注意事项与最佳实践
- 优惠券适用性：此方法不会阻止优惠券被添加到购物车中，而是控制其折扣金额的分配。如果购物车中没有任何缺货商品，即使应用了优惠券，最终的折扣总额也将为零。
-
特定优惠券限制：如果您希望此逻辑仅应用于特定的优惠券，可以在 filter_woocommerce_coupon_get_discount_amount 函数内部添加条件判断，例如根据 $coupon->get_code() 来检查优惠券代码。
// 示例：仅对 'YOUR_COUPON_CODE' 优惠券生效 if ( 'YOUR_COUPON_CODE' === $coupon->get_code() ) { if ( ! $cart_item['data']->is_on_backorder() ) { $discount = 0; } } return $discount; - 测试：在生产环境中使用前，务必在测试环境中充分测试此功能，确保其符合您的预期。
- 代码位置：建议将此代码放入自定义插件中，而不是直接修改主题的 functions.php 文件，以便在主题更新时代码不会丢失。
总结
通过利用 woocommerce_coupon_get_discount_amount 过滤器，我们可以有效地实现 WooCommerce 优惠券仅对缺货商品生效的精确控制。这种方法避免了直接修改优惠券有效性判断的复杂性，而是从折扣金额分配的层面进行干预，提供了一个既灵活又可靠的解决方案，帮助商家更精准地进行营销活动。
