WooCommerce：如何调整代码实现特定商品强制使用任意指定优惠券

原代码核心问题 #

• 优惠券配置为逗号拼接的字符串而非数组，无法支持多值匹配逻辑
• 校验逻辑采用单值精确匹配，既不能实现“任意白名单优惠券即可通过”的规则，也无法高效适配百级量级的商品、优惠券清单
• 校验流程未做前置判断，购物车无目标商品时仍会执行全量校验，存在性能浪费

调整后逻辑说明 #

• 目标商品ID、可接受的优惠券编码均采用标准PHP数组存储，后续扩充到100个商品、100个优惠券时，直接向数组追加条目即可，无需修改判断逻辑
• 优惠券校验采用数组交集匹配：只要用户已应用的优惠券与预设白名单存在任意一个重叠值，即视为满足校验要求
• 增加前置判断逻辑：先校验购物车是否包含目标商品，无目标商品时直接退出流程，减少无意义运算
• 统一大小写匹配规则，避免因优惠券大小写不一致导致的判断失效

完整可用代码 #

add_action( 'woocommerce_check_cart_items', 'mandatory_coupon_for_specific_items' );
function mandatory_coupon_for_specific_items() {
    // 目标商品ID数组，可直接追加ID值扩充清单
    $targeted_ids = array(40, 41, 42, 43, 44);
    // 允许使用的优惠券编码数组，可直接追加券码扩充清单
    $allowed_coupons = array('summer1', 'summer2', 'summer3', 'summer4', 'summer5');

    // 统一转换为小写做匹配，消除大小写差异的影响
    $applied_coupons = array_map('strtolower', WC()->cart->get_applied_coupons());
    $normalized_allowed_coupons = array_map('strtolower', $allowed_coupons);

    // 第一步：判断购物车是否包含目标商品
    $has_target_product = false;
    $target_product_name = '';
    foreach (WC()->cart->get_cart() as $cart_item) {
        if (in_array($cart_item['product_id'], $targeted_ids)) {
            $has_target_product = true;
            $target_product_name = $cart_item['data']->get_name();
            break;
        }
    }
    // 无目标商品时直接退出，不执行后续校验
    if (!$has_target_product) {
        return;
    }

    // 第二步：判断是否已使用任意一个允许的优惠券
    $is_valid_coupon_used = count(array_intersect($applied_coupons, $normalized_allowed_coupons)) > 0;

    // 未使用合规优惠券时抛出错误阻止结账
    if (!$is_valid_coupon_used) {
        wc_clear_notices();
        wc_add_notice(
            sprintf('商品「%s」结账需使用指定优惠券，请选择可用优惠券后再继续。', $target_product_name),
            'error'
        );
    }
}

性能适配说明 #

• 数组交集匹配采用PHP内置函数实现，运算效率远高于手写双层循环，即使清单扩充到100个商品、100个优惠券，校验耗时也在毫秒级，不会影响页面加载速度
• 提前退出逻辑避免了非必要的运算，当购物车不包含目标商品时，不会触发优惠券比对流程
• 代码逻辑与配置完全分离，后续扩充清单时不需要修改核心判断逻辑，只需要在对应数组里追加值即可

内容的提问来源于stack exchange，提问作者Santiago Cuartas Rmrz