WooCommerce 购物车添加差异化费用教程

前言：理解需求与挑战

在 WooCommerce 中，商家经常需要根据特定商品收取额外的费用，例如包装费、服务费或特殊处理费。然而，直接使用 WC()->cart->add_fee() 方法并结合简单的产品 ID 判断，往往只能实现为一组产品添加单一的固定费用。当需要为不同的产品设置不同的费用时，例如产品 A 收取 10 元，产品 B 收取 20 元，传统方法可能导致代码冗余、效率低下，甚至产生错误。本教程将介绍两种高效且专业的代码实现方式，以解决这一挑战。

方法一：汇总显示不同商品的附加费用

此方法适用于当您希望为购物车中所有符合条件的产品计算总的附加费用，并将其作为一个单一的费用项显示给客户时。这种方式代码简洁，避免了多次遍历购物车，提高了性能。

实现原理

核心思想是创建一个关联数组，将附加费用作为键（key），对应的产品 ID 作为值（value）。然后，遍历购物车中的商品，查找是否存在于该关联数组中。如果找到，则将对应的费用累加起来，最后作为一个总费用添加到购物车。

示例代码

将以下代码添加到您的主题 functions.php 文件或自定义插件中：

/**
 * 在 WooCommerce 购物车中为不同商品添加并汇总附加费用。
 *
 * @param WC_Cart $cart WooCommerce 购物车对象。
 */
function action_woocommerce_cart_calculate_fees_summed( $cart ) {
    // 确保只在前端且非 AJAX 请求时执行，避免后台或不必要的计算。
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 配置：以“附加费用金额 => 产品 ID”的形式定义。
    // 例如：10 元费用对应产品 ID 1234。
    $settings = array(
        10  => 1234, // 产品 ID 1234 产生 10 元附加费
        20  => 5678, // 产品 ID 5678 产生 20 元附加费
        5   => 30,   // 产品 ID 30 产生 5 元附加费
        2   => 815,  // 产品 ID 815 产生 2 元附加费
    );

    // 初始化总附加费用。
    $total_additional_fee = 0;

    // 遍历购物车中的所有商品项。
    foreach ( $cart->get_cart_contents() as $cart_item ) {
        // 获取当前商品的产品 ID。
        $product_id = $cart_item['product_id'];

        // 在设置数组中查找产品 ID。如果找到，array_search 会返回对应的键（即费用金额）。
        if ( false !== $fee_amount = array_search( $product_id, $settings ) ) {
            // 将找到的费用金额累加到总附加费用中。
            $total_additional_fee += $fee_amount;
        }
    }

    // 如果总附加费用大于 0，则将其添加到购物车。
    if ( $total_additional_fee > 0 ) {
        // 第三个参数 'false' 表示此费用不含税。
        $cart->add_fee( __( '附加费用', 'woocommerce' ), $total_additional_fee, false );
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_summed', 10, 1 );

代码解析

1. $settings 数组：这是核心配置，以 费用金额 => 产品 ID 的键值对形式存储。您可以根据需要添加任意数量的费用规则。
2. 购物车遍历：foreach ( $cart->get_cart_contents() as $cart_item ) 循环遍历购物车中的每个商品。
3. array_search()：此函数用于在 $settings 数组中查找当前商品 product_id 对应的值。如果找到，它会返回该值的键，即我们定义的费用金额。
4. 费用累加：$total_additional_fee += $fee_amount; 将找到的费用累加到一个变量中。
5. $cart->add_fee()：最后，如果 $total_additional_fee 大于零，就将这个总费用作为一个新的费用项添加到购物车中。__( '附加费用', 'woocommerce' ) 是费用显示的名称，$total_additional_fee 是费用金额，false 表示该费用不含税。

方法二：为不同商品单独显示附加费用

如果您希望客户清楚地看到每项附加费用是针对哪个产品或服务收取的，那么可以使用此方法。它允许您为每个产品定义一个独特的费用名称和金额，并在购物车中分别显示。

实现原理

此方法使用一个多维数组来存储每个产品的附加费用信息，包括产品 ID、费用金额和费用名称。然后，遍历购物车和设置数组，当找到匹配的产品时，立即将对应的费用添加到购物车。

示例代码

将以下代码添加到您的主题 functions.php 文件或自定义插件中：

/**
 * 在 WooCommerce 购物车中为不同商品单独添加并显示附加费用。
 *
 * @param WC_Cart $cart WooCommerce 购物车对象。
 */
function action_woocommerce_cart_calculate_fees_individual( $cart ) {
    // 确保只在前端且非 AJAX 请求时执行。
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 配置：以多维数组形式定义每个产品的附加费用详情。
    $settings = array(
        array(
            'product_id' => 30,
            'amount'     => 5,
            'name'       => __( '额外服务费', 'woocommerce' ),
        ),
        array(
            'product_id' => 813,
            'amount'     => 10,
            'name'       => __( '包装费', 'woocommerce' ),
        ),
        array(
            'product_id' => 815,
            'amount'     => 15,
            'name'       => __( '其他杂项费', 'woocommerce' ),
        ),
    );

    // 遍历购物车中的所有商品项。
    foreach ( $cart->get_cart_contents() as $cart_item ) {      
        // 获取当前商品的产品 ID。
        $product_id = $cart_item['product_id'];

        // 遍历设置数组中的每个费用规则。
        foreach ( $settings as $setting ) {
            // 查找与购物车商品匹配的产品 ID。
            if ( $setting['product_id'] == $product_id ) {
                // 如果匹配，则将此费用添加到购物车。
                // 费用名称、金额和是否含税 (false 为不含税)。
                $cart->add_fee( $setting['name'], $setting['amount'], false );
            }
        }       
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_individual', 10, 1 );

代码解析

1. $settings 数组：这是一个多维数组，每个子数组代表一个费用规则，包含 product_id、amount (费用金额) 和 name (费用显示名称)。
2. 双重遍历：外层循环遍历购物车商品，内层循环遍历 $settings 数组中的每个费用规则。
3. 条件判断：if ( $setting['product_id'] == $product_id ) 判断购物车中的商品 ID 是否与当前费用规则中的产品 ID 匹配。
4. $cart->add_fee()：如果匹配，则使用该规则定义的 name 和 amount 将费用添加到购物车。这将导致每个匹配的费用都显示为一个独立的行。

注意事项与最佳实践

• 代码放置位置：建议将这些代码放置在您主题的 functions.php 文件中。更专业的做法是创建一个自定义插件来管理这些功能，以便在更换主题时功能不会丢失。
• is_admin() && ! defined( 'DOING_AJAX' )：这个条件判断非常重要。它确保了费用计算逻辑只在前端用户浏览购物车或结账页面时执行，避免在后台管理界面或 AJAX 请求中不必要的执行，从而提高性能和避免潜在冲突。
• 费用是否含税：$cart->add_fee() 方法的第三个参数是 taxable，默认为 true。如果您的附加费用不应计税，请务必将其设置为 false。
• 费用名称国际化：在 add_fee 中使用的费用名称，如 __( '附加费用', 'woocommerce' )，使用了 WooCommerce 的国际化函数 __()。这有助于您的网站支持多语言，如果您的网站是单语言，也可以直接使用字符串，例如 '附加费用'。
• 产品 ID 获取：确保您使用的产品 ID 是正确的。您可以在 WooCommerce 后台编辑产品页面，在 URL 或产品数据区域找到产品 ID。
• 避免冲突：如果您使用了其他插件来处理购物车费用，请测试以确保这些代码不会与现有功能冲突。如果出现问题，可能需要调整代码执行的优先级（add_action 的第四个参数）。
• 选择合适的方法：根据您的业务需求选择方法一（汇总显示）或方法二（单独显示）。如果客户需要清晰了解每项费用的来源，方法二更优；如果只需要一个总的附加费用，方法一更简洁。

总结

通过上述两种基于代码的解决方案，您可以在 WooCommerce 购物车中灵活地为不同商品添加差异化的附加费用，而无需依赖额外的插件。这不仅提供了高度的定制性，还能有效控制网站性能。选择哪种方法取决于您希望如何向客户展示这些费用：是作为一个总额，还是作为清晰的独立项目。遵循本教程的指导和最佳实践，您可以轻松地实现这一功能，提升您的 WooCommerce 商店的运营效率和用户体验。