本教程旨在解决woocommerce中优惠券默认应用于所有商品而非仅限缺货商品的问题。通过利用`woocommerce_coupon_get_discount_amount`过滤器，我们可以实现对优惠券折扣金额的精细控制。文章将详细介绍如何编写自定义代码，确保只有处于缺货状态的商品才能获得折扣，从而优化您的电商促销策略。
在WooCommerce中，商家常常需要对特定商品或商品状态应用优惠券，例如仅对缺货（Backordered）商品提供折扣。然而，默认的优惠券机制通常会对购物车中的所有符合条件的商品生效，这与精细化运营的需求不符。本文将指导您如何通过自定义代码，精确控制优惠券的适用范围，使其仅作用于缺货商品。
理解WooCommerce优惠券的限制
尝试通过woocommerce_coupon_is_valid等过滤器直接在购物车层面判断优惠券是否对缺货商品有效，可能会遇到挑战。这是因为WC_Discounts类在处理优惠券时，会设定购物车中的商品项。在这种情况下，在woocommerce_coupon_is_valid钩子内部循环遍历购物车商品并检查其缺货状态，可能无法准确地控制每个商品项的折扣金额。
一个更有效的方法是，在优惠券折扣金额计算的环节进行干预，对每个商品项独立判断其是否应获得折扣。
解决方案：使用 woocommerce_coupon_get_discount_amount 过滤器
WooCommerce提供了woocommerce_coupon_get_discount_amount过滤器，允许我们在计算每个商品项的折扣金额时进行自定义。通过这个过滤器，我们可以检查当前商品是否处于缺货状态，并据此决定其应获得的折扣金额。
核心代码实现
以下代码片段展示了如何使用此过滤器来实现仅对缺货商品应用折扣：
/**
* 过滤WooCommerce优惠券折扣金额，仅对缺货商品应用折扣
*
* @param float $discount 当前商品项的折扣金额
* @param float $price_to_discount 商品项可用于折扣的价格
* @param WC_Cart_Item $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 (当前应用的优惠券对象)。
- 核心逻辑是 ! $cart_item['data']->is_on_backorder()。$cart_item['data'] 代表了 WC_Product 对象，其 is_on_backorder() 方法用于判断该商品是否处于缺货状态。
- 如果商品不处于缺货状态（即条件为真），我们将 $discount 设置为 0。这意味着该商品将不会获得任何折扣。
- 最后，函数返回修改后的 $discount 值。
-
add_filter 函数:
- add_filter( 'woocommerce_coupon_get_discount_amount', 'filter_woocommerce_coupon_get_discount_amount', 10, 5 ); 将我们的自定义函数挂载到 woocommerce_coupon_get_discount_amount 过滤器上。
- 10 是优先级，5 表示我们的函数接受五个参数。
如何集成此代码
将上述代码添加到您的WordPress主题的 functions.php 文件中，或者更推荐的做法是，创建一个自定义插件来管理此类功能。
示例：添加到 functions.php
- 登录您的WordPress后台。
- 导航到“外观” > “主题文件编辑器”。
- 选择您当前使用的主题。
- 找到 functions.php 文件并打开。
- 将上述代码粘贴到文件末尾（在 ?> 标签之前，如果存在的话）。
- 点击“更新文件”保存更改。
注意事项与扩展
通用性: 上述代码会使得任何应用的优惠券，其折扣金额在非缺货商品上都变为0。这意味着如果您有多个优惠券，它们都将遵循此规则。
-
针对特定优惠券: 如果您希望此逻辑仅应用于特定的优惠券（例如，只有名称为“beauty”的优惠券），您需要在 filter_woocommerce_coupon_get_discount_amount 函数内部添加额外的条件判断：
function filter_woocommerce_coupon_get_discount_amount( $discount, $price_to_discount, $cart_item, $single, $coupon ) { // 定义需要特殊处理的优惠券代码 $specific_coupon_codes = array( 'beauty', 'backorder_promo' ); // 仅当当前优惠券是指定优惠券之一时，才应用此逻辑 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', 10, 5 ); 测试: 在生产环境部署任何代码更改之前，务必在开发或测试环境中进行充分测试，确保功能符合预期，且没有引入新的问题。
缓存: 如果您使用了缓存插件，在更改代码后可能需要清除缓存，以确保新的逻辑能够生效。
总结
通过利用 woocommerce_coupon_get_discount_amount 过滤器，我们能够对WooCommerce中的优惠券折扣行为进行高度定制。这种方法提供了商品项级别的精细控制，确保优惠券仅应用于缺货商品，从而帮助商家更灵活、精确地管理促销活动。此教程提供的代码简单高效，是实现此类特定业务需求的强大工具。
