本文详解如何正确使用 woocommerce_cart_shipping_method_full_label 钩子，基于商品的运费分类（Shipping Class）动态重写配送方式在购物车页显示的完整标签，避免因参数误用导致的致命错误。
本文详解如何正确使用 `woocommerce_cart_shipping_method_full_label` 钩子，基于商品的运费分类（shipping class）动态重写配送方式在购物车页显示的完整标签，避免因参数误用导致的致命错误。
在 WooCommerce 开发中，常需根据商品属性定制前端展示逻辑。一个典型场景是：当购物车中包含特定运费分类（如“托盘运输”）的商品时，希望将默认的配送方式标签（如“Flat Rate: $10.00”）替换为更具业务意义的提示，例如“托盘专用配送（含装卸服务）”。但若直接将适用于 woocommerce_before_calculate_totals 的逻辑迁移到 woocommerce_cart_shipping_method_full_label，极易触发 Fatal error: Call to a member function get_cart() —— 根本原因在于该钩子传递的参数与预期不符。
woocommerce_cart_shipping_method_full_label 是一个 filter 钩子（非 action），其函数签名明确为：
apply_filters( 'woocommerce_cart_shipping_method_full_label', string $label, WC_Shipping_Rate $method )
它接收两个参数：当前配送方式的原始标签 $label 和对应的 WC_Shipping_Rate 对象 $method，并不传入 $cart 实例。因此，原代码中将 $cart 作为函数参数、并调用 $cart->get_cart() 的写法必然失败。
此外，wc_add_notice() 和 wc_clear_notices() 在此上下文中也完全不适用：该钩子仅用于修饰并返回标签文本，而非触发通知逻辑；且其执行时机处于配送方法渲染阶段，与用户可见的通知系统无关联。
✅ 正确做法是：通过 WC()->cart 全局访问购物车实例，在钩子回调中遍历商品，检测是否存在指定运费分类，并据此修改 $label 后返回。以下是经过验证的专业实现：
/**
* 根据购物车中商品的运费分类，动态重写配送方式完整标签
* 钩子：woocommerce_cart_shipping_method_full_label（filter）
*/
function filter_woocommerce_cart_shipping_method_full_label( $label, $method ) {
// 定义目标运费分类 ID（请按实际修改）
$target_shipping_class_id = 28;
// 确保购物车可用（避免后台或 AJAX 非预期调用）
if ( ! WC()->cart || ! is_cart() || is_admin() ) {
return $label;
}
$cart = WC()->cart;
$has_target_class = false;
// 遍历购物车项，检查是否存在匹配的运费分类
foreach ( $cart->get_cart() as $cart_item ) {
if ( $cart_item['data']->get_shipping_class_id() === $target_shipping_class_id ) {
$has_target_class = true;
break;
}
}
// 若存在目标分类，则覆盖原始标签（支持多语言）
if ( $has_target_class ) {
$label = __( '托盘专用配送（含装卸服务）', 'your-textdomain' );
// 可选：追加原始标签以保留价格信息
// $label = sprintf( __( '托盘专用配送（含装卸服务） — %s', 'your-textdomain' ), $label );
}
return $label;
}
add_filter( 'woocommerce_cart_shipping_method_full_label', 'filter_woocommerce_cart_shipping_method_full_label', 10, 2 );? 关键注意事项：
- 优先级与参数数量：务必使用 add_filter(..., ..., 10, 2) 显式声明接收 2 个参数，否则 $method 将无法获取；
- 性能优化：is_cart() 和 WC()->cart 的双重校验可避免在非购物车页面（如结算页、后台）意外执行；
- 多语言支持：所有静态文本必须包裹 __() 或 _e() 函数，并确保主题/插件已加载对应语言包；
- 扩展性建议：若需支持多个运费分类映射不同标签，可将 $target_shipping_class_id 替换为关联数组，如 array(28 => '托盘专用', 32 => '冷链运输')，再循环匹配；
- 调试技巧：临时添加 error_log( print_r( $cart_item['data']->get_shipping_class_id(), true ) ); 可快速确认实际分类 ID。
此方案严格遵循 WooCommerce 钩子设计规范，安全、高效、可维护，适用于 Storefront 子主题及绝大多数主流主题环境。
