如何通过自定义插件覆盖或修改WooCommerce默认税费？

问题说明 #

开发自定义配送插件时，需通过API获取税费并替换WooCommerce后台配置的默认税费，但使用add_fee()方法会在结账页面新增单独费用行，不符合需求。

解决方案 #

add_fee()仅用于添加额外费用，无法替换原有税费逻辑，需通过WooCommerce的税费计算钩子直接覆盖默认值：

1. 核心代码：替换税费计算结果

add_action('woocommerce_calculate_totals', 'override_default_tax_with_api_data', 10, 1);
function override_default_tax_with_api_data($cart) {
    if (is_admin() && !defined('DOING_AJAX')) return;

    // 替换为你的API调用逻辑，获取税费和关税
    $api_tax = 12.5; // 示例：API返回的税费金额
    $api_duty = 3.8; // 示例：API返回的关税金额
    $total_custom_tax = $api_tax + $api_duty;

    // 清空WooCommerce自动计算的税费
    $cart->tax_total = 0;
    $cart->shipping_tax_total = 0;
    $cart->total_tax = 0;

    // 设置API返回的税费数据
    $cart->tax_total = $api_tax;
    $cart->shipping_tax_total = $api_duty; // 若关税属于运费相关税费，可调整此处
    $cart->total_tax = $total_custom_tax;
}

2. 自定义税费显示（可选）

如果需要分开显示税费和关税，可调整结账页面的税费行结构：

add_filter('woocommerce_cart_totals_taxes_html', 'custom_tax_display_html', 10, 1);
function custom_tax_display_html($tax_html) {
    // 从API获取数据（建议缓存API结果，避免重复调用）
    $api_tax = 12.5;
    $api_duty = 3.8;

    $tax_html = '';
    // 添加税费行
    $tax_html .= '<tr class="tax-row">
        <th>' . __('税费', 'woocommerce') . '</th>
        <td data-title="' . __('税费', 'woocommerce') . '">' . wc_price($api_tax) . '</td>
    </tr>';
    // 添加关税行
    $tax_html .= '<tr class="duty-row">
        <th>' . __('关税', 'woocommerce') . '</th>
        <td data-title="' . __('关税', 'woocommerce') . '">' . wc_price($api_duty) . '</td>
    </tr>';

    return $tax_html;
}

注意事项 #

• API调用需结合购物车商品、配送地址等参数，确保返回税费准确
• 建议对API结果做缓存处理，避免频繁调用影响性能
• 测试时可禁用WooCommerce后台的自动税费计算，确保代码逻辑生效

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