如何在WooCommerce中实现含小费的便利费叠加计算

问题背景 #

需要在WooCommerce中实现以下费用计算逻辑：

• 小费插件生成的小费被标记为fee类型
• 需按订单总额（包含小费）的3.99%收取便利费

当前代码存在的问题：

• 用户添加小费时，便利费未将小费纳入计算范围
• 代码中$tip变量无法获取到小费金额，硬编码数值时计算正常，推测是遍历费用对象的方式错误

错误原因分析 #

1. 费用对象访问方式错误：$woocommerce->cart->get_fees()返回的是WC_Fee对象数组，而非关联数组，原代码用$fee['name']、$fee['amount']这种数组方式访问属性是无效的，应该使用对象的方法或属性访问。
2. 小费名称匹配不灵活：原代码仅匹配固定名称Tip (10%)，但小费比例可能有多种（如5%、15%），会导致其他比例的小费无法被识别。
3. 未初始化变量：如果没有找到小费，$tip变量会处于未定义状态，引发计算错误。
4. 税费计算错误：$woocommerce->cart->get_tax_totals是方法，需要加括号调用，但它返回的是税费明细数组，并非总税费金额，应该直接使用tax_total属性获取总税费。

修正后的代码 #

add_action( 'woocommerce_cart_calculate_fees','woocommerce_custom_surcharge' );

function woocommerce_custom_surcharge() {
    global $woocommerce;
    
    // 初始化小费金额为0
    $tip = 0;

    // 遍历费用对象，获取小费金额
    foreach($woocommerce->cart->get_fees() as $fee) {
        // 匹配包含"Tip"的费用（兼容不同比例的小费）
        if (str_contains($fee->get_name(), 'Tip')) {
            $tip = $fee->get_amount();
            break; // 找到小费后退出循环，提升效率
        }
    }

    $percentage = 0.0399;
    
    // 计算便利费基数：商品总额+运费+税费+小费
    $surcharge = (
        $woocommerce->cart->cart_contents_total +
        $woocommerce->cart->shipping_total + 
        $woocommerce->cart->tax_total +
        $tip
    ) * $percentage;
    
    // 添加便利费到购物车
    $woocommerce->cart->add_fee( 'Convenience Fee', $surcharge, false, '' );
}

补充说明 #

• 代码中使用str_contains()匹配小费名称（PHP 8.0+支持），如果你的PHP版本低于8.0，可以改用strpos($fee->get_name(), 'Tip') !== false替代。
• 便利费计算基数包含了所有必要的订单金额项，确保小费被纳入计算范围。
• 初始化$tip为0，避免因未找到小费而出现未定义变量的报错。

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