WooCommerce 如何仅在购物车全属Extra配送类时隐藏免运费？

• 循环逻辑错误：遍历购物车内容时，检查到第一个商品就直接触发break，没有遍历全部商品，无法准确判断购物车是否全部为Extra配送类商品
• 配送类匹配错误：WooCommerce中get_shipping_class()返回的是配送类的Slug别名，并非后台展示的类名称。使用'Extra'作为匹配值，永远无法命中正确的配送类判断
• 逻辑判断混乱：没有正确统计所有商品的配送类归属，导致隐藏免运费的触发条件始终不成立

• 进入WooCommerce后台「配送」-「配送类」页面，找到Extra类对应的Slug值（例如后台显示名称为Extra，Slug通常为extra）
• 在对应配送区域提前配置好金额为5美元的固定运费方法，确保隐藏免运费后，系统可以正常展示该运费选项

// 购物车全部为Extra配送类时，移除免运费权益
add_filter( 'woocommerce_package_rates', 'disable_free_shipping_for_all_extra_items', 10, 2 );
function disable_free_shipping_for_all_extra_items( $available_shipping_methods, $package ) {
    // 替换为你的Extra配送类实际Slug
    $target_shipping_class_slug = 'extra';
    // 需要禁用的配送方法ID
    $exclude_method_ids = array( 'free_shipping' );
    // 初始化判断标记
    $all_items_target_class = true; // 默认假设所有商品属于目标配送类
    $has_any_item = false; // 标记购物车是否存在商品
    
    // 遍历购物车全部商品，校验配送类归属
    foreach( $package['contents'] as $cart_item ) {
        $has_any_item = true;
        $product_shipping_class = $cart_item['data']->get_shipping_class();
        // 只要存在任意不属于目标类的商品，就修正标记
        if ( $product_shipping_class !== $target_shipping_class_slug ) {
            $all_items_target_class = false;
            break;
        }
    }
    // 触发条件：购物车有商品，且所有商品都属于Extra配送类
    if ( $has_any_item && $all_items_target_class ) {
        // 遍历可用配送方法，移除免运费选项
        foreach( $available_shipping_methods as $method_key => $method_obj ) {
            if ( in_array( $method_obj->method_id, $exclude_method_ids ) ) {
                unset( $available_shipping_methods[ $method_key ] );
            }
        }
    }
    return $available_shipping_methods;
}

• 代码中的$target_shipping_class_slug必须替换为后台Extra配送类的实际Slug，不要填写后台显示的类名称
• 修改代码后，需要进入WooCommerce「状态」-「工具」页面，清除「运费缓存」和「临时数据」，否则旧的配送规则缓存会导致代码不生效
• 如果需要针对多个配送类触发该规则，可将$target_shipping_class_slug改为数组，判断时将匹配逻辑替换为!in_array($product_shipping_class, $target_shipping_class_slug)即可
• 当购物车混入任意一个非Extra类商品时，代码不会触发移除逻辑，免运费权益会正常生效

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