WooCommerce如何限制美国境外用户购买实体商品？

核心思路 #

通过后端钩子强制验证+前端辅助提示的组合方式，既确保虚拟商品全球可售，又严格阻止境外用户购买实体商品的结账流程，解决原仅靠配送提示的漏洞。

方案一：后端钩子拦截结账流程（最可靠） #

利用WooCommerce的woocommerce_check_cart_items钩子，在结账前完成三重验证：购物车是否含实体商品、用户配送国家是否为美国、是否跳过配送地址设置，不符合条件则直接阻止结账并给出明确提示。

将以下代码添加到主题的functions.php文件或自定义插件中：

add_action( 'woocommerce_check_cart_items', 'block_international_physical_checkout' );
function block_international_physical_checkout() {
    // 仅在结账页触发（排除订单完成等端点）
    if ( ! is_checkout() || is_wc_endpoint_url() ) return;

    $has_physical = false;
    $user_country = WC()->customer->get_shipping_country() ?: WC()->customer->get_billing_country();

    // 遍历购物车，判断是否存在实体商品（排除虚拟/可下载商品）
    foreach ( WC()->cart->get_cart() as $cart_item ) {
        $product = $cart_item['data'];
        if ( ! $product->is_virtual() && ! $product->is_downloadable() ) {
            $has_physical = true;
            break;
        }
    }

    // 触发拦截条件：有实体商品 + 用户不在美国
    if ( $has_physical && $user_country !== 'US' ) {
        // 显示错误提示
        wc_add_notice( '实体商品仅支持美国境内配送，若您仅需虚拟商品，请移除购物车中的实体商品后重试。', 'error' );
        // 移除结账按钮，彻底阻断流程
        remove_action( 'woocommerce_proceed_to_checkout', 'woocommerce_button_proceed_to_checkout', 20 );
    }
}

代码说明：

• 优先读取用户的配送国家，未设置则读取账单国家，覆盖所有场景
• 自动识别实体商品：排除虚拟和可下载属性的商品，无需手动标记
• 不仅提示错误，还直接移除结账按钮，避免用户忽略提示继续操作

方案二：配合后台配送规则加固 #

先在WooCommerce后台完成基础配置，再结合方案一的钩子实现双重保障：

1. 进入WooCommerce > 设置 > 配送，创建仅包含美国的配送区域
2. 为该区域添加实体商品可用的配送方法（如USPS、Flat Rate）
3. 确保其他区域无实体商品的配送方法

此配置会在用户选择境外地址时隐藏配送选项，再通过方案一的钩子彻底阻止结账，解决原问题中"无配送选项仍可结账"的漏洞。

方案三：前端辅助提示（提升用户体验） #

通过JS在前端实时检测用户选择的国家和购物车内容，提前隐藏结账按钮并提示，减少用户无效操作：

将以下代码添加到结账页的自定义脚本中（可通过主题自定义功能或插件实现）：

jQuery(document).ready(function($) {
    // 监听国家选择框变化
    $('#billing_country, #shipping_country').on('change', checkCartStatus);
    // 页面加载时立即检查
    checkCartStatus();

    function checkCartStatus() {
        // 从后端获取购物车是否含实体商品（需配合方案一的PHP逻辑传递变量）
        const hasPhysical = <?php echo isset($has_physical) && $has_physical ? 'true' : 'false'; ?>;
        const userCountry = $('#shipping_country').val() || $('#billing_country').val();

        if (hasPhysical && userCountry !== 'US') {
            // 隐藏结账支付区域
            $('.woocommerce-checkout-payment').hide();
            // 显示自定义提示（若后端未显示）
            if (!$('.woocommerce-error').length) {
                $('.woocommerce-checkout').prepend('<div class="woocommerce-error">实体商品仅支持美国境内配送</div>');
            }
        } else {
            $('.woocommerce-checkout-payment').show();
            $('.woocommerce-error:contains("实体商品仅支持美国境内配送")').remove();
        }
    }
});

注意：

• 前端仅为体验优化，必须依赖方案一的后端钩子，否则用户可通过禁用JS绕过限制

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