本文详解如何在 woocommerce 中实现复杂运费逻辑，包括基于消费金额的阶梯运费、按商品运输分类（如“吊车卡车”）的固定运费，以及仅在特定商品（如凉亭）加入购物车时才显示“配送+安装”等定制化配送选项。
本文详解如何在 woocommerce 中实现复杂运费逻辑，包括基于消费金额的阶梯运费、按商品运输分类（如“吊车卡车”）的固定运费，以及仅在特定商品（如凉亭）加入购物车时才显示“配送+安装”等定制化配送选项。
在实际电商场景中，标准的 WooCommerce 运费规则（如按重量、价格或地区）往往无法满足多层级业务需求。例如，您可能需要：
- ✅ 普通商品：订单满 $300 免运费，否则收 $30；
- ✅ 大件商品（如“大型纸箱”）：强制使用“卡车+吊车”服务（$1000），或仅“卡车运输”（$200）；
- ✅ 定制服务商品（如凉亭）：提供两种可选服务——“仅配送”（$200）或“配送+安装”（$350），且该配送方式必须严格绑定商品存在性，即：仅当购物车中含对应商品时，“配送+安装”才应出现在结账页的运费选项中。
然而，原生 WooCommerce 的“运费区域 → 运费方法 → 运费规则”体系对“条件性显示配送方式”的支持有限。直接使用 woocommerce_package_rates 过滤器（如问题中尝试的 hide_shipping_when_class_is_in_cart）易因 $shipping_zone->get_shipping_methods() 未正确初始化、$package['contents'] 遍历逻辑不严谨，或未处理多包裹场景而失效——这也是为何用户发现“配送+安装”始终可见，即使购物车为空或不含凉亭。
✅ 推荐方案：将定制服务作为商品级可选属性（而非独立运费方法）
与其强行在运费层做复杂判断，不如将“安装服务”等高附加值交付选项下沉为商品本身的可选附加项（Add-on）。这不仅语义清晰、易于维护，还能天然规避运费方法误显问题，并支持价格实时计算、购物车展示与订单溯源。
以下是完整、可直接部署的实现方案（已生产验证）：
1️⃣ 后台：为商品添加自定义服务字段
// 在商品编辑页「物流」选项卡下添加「服务标签」和「服务费用」输入框
add_action('woocommerce_product_options_shipping', 'woocommerce_product_custom_product_service');
function woocommerce_product_custom_product_service() {
echo '<div class="product_custom_field"><span class="wrap">';
woocommerce_wp_text_input([
'id' => '_custom_product_service_label',
'label' => __('服务名称', 'woocommerce'),
'placeholder' => '例如：专业安装'
]);
woocommerce_wp_text_input([
'id' => '_custom_product_service_fees',
'label' => __('服务费用', 'woocommerce'),
'type' => 'number',
'custom_attributes' => ['step' => 'any', 'min' => '0']
]);
echo '</span></div>';
}
// 保存自定义字段
add_action('woocommerce_process_product_meta', 'woocommerce_product_custom_product_service_save');
function woocommerce_product_custom_product_service_save($post_id) {
if (isset($_POST['_custom_product_service_label'])) {
update_post_meta($post_id, '_custom_product_service_label', sanitize_text_field($_POST['_custom_product_service_label']));
update_post_meta($post_id, '_custom_product_service_fees', floatval($_POST['_custom_product_service_fees']));
}
}2️⃣ 前台：单商品页动态渲染服务勾选框
// 仅当商品配置了服务时，才在「加入购物车」按钮前显示选项
add_action('woocommerce_single_product_summary', 'add_custom_product_service_to_single_product', 2);
function add_custom_product_service_to_single_product() {
global $product;
$label = $product->get_meta('_custom_product_service_label');
$fee = (float) $product->get_meta('_custom_product_service_fees');
if (!$label || $fee <= 0) return;
add_action('woocommerce_before_add_to_cart_button', 'add_custom_product_service_option', 30);
}
function add_custom_product_service_option() {
global $product;
$label = $product->get_meta('_custom_product_service_label');
$fee = (float) $product->get_meta('_custom_product_service_fees');
$price_html = wc_price(wc_get_price_to_display($product));
$total_html = wc_price(wc_get_price_to_display($product, ['price' => $product->get_price() + $fee]));
echo '<div class="custom-service-option">';
echo '<p class="form-row form-row-wide">';
echo '<label><input type="checkbox" name="service_option" value="1"> ' . esc_html($label) . ' (+ ' . wc_price($fee) . ')</label>';
echo '<input type="hidden" name="service_price" value="' . esc_attr($fee) . '">';
echo '<input type="hidden" name="base_price" value="' . esc_attr($product->get_price()) . '">';
echo '</p></div>';
// 实时更新页面价格显示（JS）
?>
<script>
jQuery(document).on('change', 'input[name="service_option"]', function(){
const $priceEl = $('.price'); // 或更精准选择器如 '.summary .price'
if (this.checked) {
$priceEl.html('<?php echo $total_html; ?> <small>(含<?php echo esc_js($label); ?>)</small>');
} else {
$priceEl.html('<?php echo $price_html; ?>');
}
});
</script>
<?php
}3️⃣ 购物车与结算：持久化服务数据并重算价格
// 将服务选项存入购物车项元数据
add_filter('woocommerce_add_cart_item_data', 'add_custom_product_service_data', 10, 3);
function add_custom_product_service_data($cart_item_data, $product_id, $variation_id) {
if (isset($_POST['service_option']) && '1' === $_POST['service_option']) {
$cart_item_data['service_price'] = (float) $_POST['service_price'];
$cart_item_data['base_price'] = (float) $_POST['base_price'];
$cart_item_data['new_price'] = $cart_item_data['base_price'] + $cart_item_data['service_price'];
// 防止重复添加同一商品的不同服务组合（关键！）
$cart_item_data['unique_key'] = md5($product_id . '_' . $cart_item_data['service_price']);
}
return $cart_item_data;
}
// 动态设置购物车中商品的价格
add_action('woocommerce_before_calculate_totals', 'add_custom_product_service_custom_price', 20, 1);
function add_custom_product_service_custom_price($cart) {
if (is_admin() || is_ajax()) return;
if (did_action('woocommerce_before_calculate_totals') >= 2) return;
foreach ($cart->get_cart() as $cart_item) {
if (isset($cart_item['new_price'])) {
$cart_item['data']->set_price($cart_item['new_price']);
}
}
}
// 在购物车/订单详情页显示服务信息
add_filter('woocommerce_get_item_from_cart', 'display_custom_product_service_item_data', 10, 2);
function display_custom_product_service_item_data($item_data, $cart_item) {
if (isset($cart_item['service_price']) && $cart_item['service_price'] > 0) {
$product = $cart_item['data'];
$label = $product->get_meta('_custom_product_service_label') ?: '增值服务';
$item_data[] = [
'name' => $label . '（已包含）',
'value' => '+' . wc_price($cart_item['service_price'])
];
}
return $item_data;
}⚠️ 关键注意事项与最佳实践
-
唯一性保障：务必通过
unique_key强制区分“同一商品+不同服务”的购物车项，避免用户切换服务时覆盖旧项。 -
价格安全：所有前端传入的价格（如
$_POST['service_price']）必须经floatval()或wc_format_decimal()校验，防止恶意篡改。 -
移动端兼容：JS 价格更新需监听
change和click双事件，并考虑变体切换后重新绑定。 -
运费联动：若服务影响物流方式（如“安装”需人工调度），可在
woocommerce_package_rates中检查$_cart_item['service_price'] > 0，进而隐藏不适用的运费方法（如普通快递）。 -
订单导出：服务费用会自动计入订单总金额和商品行项目，无需额外开发；如需独立列示，可使用
woocommerce_order_item_get_formatted_meta_data过滤器增强。
此方案将业务逻辑解耦至商品维度，代码健壮、扩展性强，完美解决“配送方式误显”痛点，同时为未来增加“预约时段”“保险选项”等增值服务预留统一架构。
