WooCommerce特定100%优惠券自动加购与金额校验问题求助

核心需求 #

• 用户输入指定100%折扣优惠券时：
  • 关联商品不在购物车则自动添加
  • 购物车总额未达300美元时，显示错误提示并终止优惠券应用、加购逻辑
  • 确保商品加购后优惠券正常生效，无时序冲突或异常

原方案的核心问题 #

• 商品加购不稳定，偶发失败
• 重复提交优惠券时会移除已添加商品
• 前端AJAX拦截不可靠，无法精准控制优惠券流程时序
• 依赖固定延迟的同步方式，容易出现会话不一致问题

可靠解决方案：基于WooCommerce原生钩子实现 #

放弃前端AJAX拦截方案，改用WooCommerce原生钩子在服务器端处理所有逻辑，彻底避免时序和同步问题。

修改后的PHP代码 #

// 优惠券验证通过后、正式应用前，执行前置检查与加购逻辑
add_action('woocommerce_coupon_validated', 'cns_prevalidate_coupon_requirements', 10, 2);
function cns_prevalidate_coupon_requirements($coupon, $result) {
    // 仅处理100%百分比折扣的指定优惠券
    if ($coupon->get_discount_type() !== 'percent' || $coupon->get_amount() != 100) {
        return;
    }

    $product_ids = $coupon->get_product_ids();
    if (empty($product_ids)) {
        return;
    }

    $required_min_total = 300;
    $current_cart_total = WC()->cart->get_cart_contents_total();

    // 第一步：校验购物车金额是否达标
    if ($current_cart_total < $required_min_total) {
        wc_add_notice(__('购物车总额未达到300美元最低要求，无法应用此优惠券。', 'woocommerce'), 'error');
        throw new Exception('金额未达标');
    }

    $target_product_id = reset($product_ids); // 取优惠券关联的单个商品ID
    $product_in_cart = false;

    // 检查商品（含变体）是否已在购物车
    foreach (WC()->cart->get_cart() as $cart_item) {
        if ($cart_item['product_id'] == $target_product_id || $cart_item['variation_id'] == $target_product_id) {
            $product_in_cart = true;
            break;
        }
    }

    // 第二步：自动添加商品到购物车（如果不存在）
    if (!$product_in_cart) {
        $add_result = WC()->cart->add_to_cart($target_product_id);
        if ($add_result) {
            WC()->cart->calculate_totals();
            wc_add_notice(__('已自动添加关联商品到购物车。', 'woocommerce'), 'success');
        } else {
            wc_add_notice(__('无法添加关联商品到购物车，请重试。', 'woocommerce'), 'error');
            throw new Exception('加购失败');
        }
    }
}

// 拦截自定义异常，优化错误提示逻辑
add_action('woocommerce_coupon_error', 'cns_handle_coupon_error', 10, 3);
function cns_handle_coupon_error($error_code, $error_message, $coupon) {
    // 针对我们抛出的自定义异常，调整提示逻辑
    if (strpos($error_message, '金额未达标') !== false || strpos($error_message, '加购失败') !== false) {
        remove_action('woocommerce_coupon_error', 'wc_add_notice'); // 避免默认提示重复显示
        wc_add_notice($error_message, 'error');
    }
}

关键优化点 #

1. 钩子时机精准：使用woocommerce_coupon_validated钩子，在优惠券验证通过后、正式应用前执行逻辑，完全贴合WooCommerce原生流程
2. 服务器端处理：所有购物车操作、校验都在服务器端完成，避免前端AJAX带来的会话同步问题
3. 严谨的商品检查：同时校验商品ID和变体ID，确保不会遗漏已添加的商品变体
4. 异常终止逻辑：通过抛出异常直接终止优惠券应用流程，确保不符合条件时不会生效优惠券

清理工作 #

• 删除原有的cns-coupon-handler.js文件，不需要再前端拦截表单提交
• 移除原代码中挂载到wp_enqueue_scripts和template_redirect的自定义函数

测试验证场景 #

1. 购物车金额不足300美元：输入优惠券→显示错误提示，优惠券不生效，无加购操作
2. 购物车金额达标但无关联商品：输入优惠券→自动添加商品，优惠券正常生效
3. 购物车已有关联商品且金额达标：输入优惠券→直接生效，无重复加购
4. 重复提交优惠券：不会移除已添加商品，无异常提示

内容的提问来源于stack exchange，提问作者Pascal Bajorat