本教程详细介绍了如何在woocommerce中配置优惠券，使其仅对处于缺货状态的商品生效。通过利用`woocommerce_coupon_get_discount_amount`过滤器，我们可以精确控制每个购物车商品的折扣金额，确保只有缺货商品获得优惠，从而避免优惠券错误地应用于有库存商品。文章提供了完整的代码实现、详细解释及注意事项，帮助开发者有效管理特定商品的促销策略。
在WooCommerce商店运营中，有时需要针对特定商品状态（例如缺货商品）提供专属优惠。然而，直接实现这一功能可能会遇到挑战，尤其是在确保优惠券仅应用于缺货商品而非所有商品时。常见的做法是尝试通过woocommerce_coupon_is_valid过滤器来判断优惠券的整体有效性，但这往往无法实现对购物车中单个商品层面的精细控制。
挑战与常见误区
许多开发者可能会尝试在woocommerce_coupon_is_valid过滤器中遍历购物车商品，检查是否存在缺货商品，以此来决定优惠券是否有效。例如，以下代码片段展示了这种尝试：
add_filter( 'woocommerce_coupon_is_valid', 'specific_coupons_valid_for_backorders', 10, 3 );
function specific_coupons_valid_for_backorders( $is_valid, $coupon, $discount ){
// 假设 'beauty' 是目标优惠券代码
$coupon_codes = array( 'beauty' );
if( in_array( $coupon->get_code(), $coupon_codes ) ) {
$is_valid = false; // 默认无效
// 遍历购物车商品并检查缺货状态
foreach ( WC()->cart->get_cart() as $cart_item ) {
if( $cart_item['data']->is_on_backorder( $cart_item['quantity'] ) ) {
$is_valid = true; // 发现缺货商品，优惠券有效
break; // 退出循环
}
}
}
return $is_valid;
}这种方法的局限性在于，woocommerce_coupon_is_valid过滤器主要用于判断优惠券在购物车整体层面的有效性。即使通过此过滤器将优惠券标记为有效，WooCommerce的WC_Discounts类在计算折扣时，仍然会尝试将其应用于所有符合条件的商品，而不是仅限于缺货商品。这意味着，如果购物车中既有缺货商品也有有库存商品，并且优惠券被标记为有效，那么它可能会错误地应用于所有商品。
解决方案：精确控制折扣金额
要实现优惠券仅应用于缺货商品，我们需要在折扣金额计算的环节进行干预。woocommerce_coupon_get_discount_amount过滤器提供了这样的能力，它允许我们针对购物车中的每一个商品，动态地调整其应获得的折扣金额。
通过此过滤器，我们可以检查当前商品是否处于缺货状态。如果商品没有缺货，我们便将该商品的折扣金额设置为零，从而 effectively 阻止优惠券对其生效。
代码实现
将以下代码添加到您的主题的 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_for_backorders( $discount, $price_to_discount, $cart_item, $single, $coupon ) {
// 检查当前商品是否处于缺货状态
// 如果商品没有缺货 (即 is_on_backorder() 返回 false)，则将折扣金额设置为 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_for_backorders', 10, 5 );代码解释
-
filter_woocommerce_coupon_get_discount_amount_for_backorders( $discount, $price_to_discount, $cart_item, $single, $coupon ):
- 这是一个自定义函数，用于处理 woocommerce_coupon_get_discount_amount 过滤器。
- $discount: WooCommerce 默认计算出的该商品应获得的折扣金额。
- $price_to_discount: 商品的原始价格，用于计算折扣。
- $cart_item: 一个包含当前购物车商品详细信息的数组。其中 $cart_item['data'] 是 WC_Product 对象，代表购物车中的产品。
- $single: 一个布尔值，指示是否为单个商品的折扣计算。
- $coupon: 当前应用的 WC_Coupon 对象。
-
if ( ! $cart_item['data']->is_on_backorder() ):
- 这是核心逻辑。我们通过 $cart_item['data'] 获取到产品对象，并调用其 is_on_backorder() 方法。
- is_on_backorder() 方法用于检查该产品是否处于缺货状态。
- ! 运算符表示“非”，所以 ! $cart_item['data']->is_on_backorder() 意味着“如果产品没有缺货”。
-
$discount = 0;:
- 如果产品没有缺货，我们就将该商品的折扣金额 $discount 设置为 0。这意味着，即使优惠券在整体上是有效的，但对于这个特定的有库存商品，它将不会获得任何折扣。
-
return $discount;:
- 返回最终的折扣金额。对于缺货商品，它将返回原始计算的折扣金额；对于有库存商品，它将返回 0。
-
add_filter( 'woocommerce_coupon_get_discount_amount', 'filter_woocommerce_coupon_get_discount_amount_for_backorders', 10, 5 );:
- 将我们的自定义函数挂载到 woocommerce_coupon_get_discount_amount 过滤器上。
- 10 是优先级，5 是函数接受的参数数量。
使用注意事项
优惠券创建：在WooCommerce后台创建优惠券时，您无需设置任何特殊的产品限制。此代码将自动处理哪些商品可以获得折扣。
用户体验：当用户将优惠券应用到购物车时，如果购物车中包含缺货商品，优惠券将显示为已应用。但最终的折扣金额将只反映缺货商品的优惠。如果购物车中只有有库存商品，优惠券虽然可以应用，但总折扣金额将为零。
-
与特定优惠券结合：如果您希望此逻辑仅适用于特定的优惠券，可以在 filter_woocommerce_coupon_get_discount_amount_for_backorders 函数内部添加一个条件判断，通过 $coupon->get_code() 获取优惠券代码，并与预设的特定优惠券代码进行比较。
function filter_woocommerce_coupon_get_discount_amount_for_backorders( $discount, $price_to_discount, $cart_item, $single, $coupon ) { // 假设 'backorder_discount' 是您希望仅应用于缺货商品的优惠券代码 $specific_coupon_codes = array( 'backorder_discount' ); if ( in_array( $coupon->get_code(), $specific_coupon_codes ) ) { if ( ! $cart_item['data']->is_on_backorder() ) { $discount = 0; } } return $discount; } add_filter( 'woocommerce_coupon_get_discount_amount', 'filter_woocommerce_coupon_get_discount_amount_for_backorders', 10, 5 ); 兼容性：此方法利用了WooCommerce的核心过滤器，通常具有良好的兼容性。但在进行任何代码更改之前，请务必在开发或测试环境中进行测试。
总结
通过利用 woocommerce_coupon_get_discount_amount 过滤器，我们可以精确地控制WooCommerce优惠券仅应用于购物车中的缺货商品。这种方法避免了在优惠券整体有效性判断上的复杂性，转而关注于每个商品的实际折扣计算，从而提供了一个更健壮和灵活的解决方案。它确保了促销策略的精准执行，提升了商店管理的效率和用户体验。
