WooCommerce购物车多产品附加费叠加计算教程

在woocommerce商店运营中，为特定产品或产品组添加附加费是一项常见需求。然而，当同一费用类别下的多个产品被添加到购物车时，如果附加费不能正确累加，则可能导致计算错误。本文将提供一个专业的解决方案，确保附加费能够根据购物车中相关产品的数量和类别进行准确汇总。

问题分析

许多开发者在尝试为一组产品添加附加费时，可能会错误地使用WordPress的__()函数来定义多个产品ID，例如__(123, 456, 789)。__()函数主要用于获取翻译字符串，与处理多个产品ID的功能无关。这种误用会导致系统无法正确识别产品组，从而使得当购物车中包含同一费用类别的多个产品时，附加费仅计算一次，而不是累加。

正确的做法是，将属于同一费用类别的所有产品ID作为一个数组进行管理，并在购物车计算过程中遍历这些产品，将对应的附加费进行累加。

解决方案概述

核心思路是创建一个包含所有费用设置的数组，每个设置项不仅包含产品ID（以数组形式）、金额和名称，还包含一个用于累加当前类别总费用的计数器（total_amount）。然后，通过两次循环实现费用计算：

1. 遍历购物车商品：检查每个商品是否属于某个费用类别，并根据商品数量累加该类别的总费用。
2. 遍历费用设置：将累加后的总费用作为新的附加费添加到购物车。

代码实现

以下是实现WooCommerce购物车多产品附加费累加功能的PHP代码：

function action_woocommerce_cart_calculate_fees( $cart ) {
    // 如果在后台或非AJAX请求中，则不执行此操作
    if ( is_admin() && ! defined( 'DOING_AJAX' ) )
        return;

    // 费用设置数组：可以根据需要添加或删除多个设置项
    $settings = array(
        array(
            'product_id'    => array( 30, 813, 815 ), // 产品ID数组
            'amount'        => 5,                    // 单个产品附加费金额
            'name'          => __( 'Additional service fee', 'woocommerce' ), // 费用名称
            'total_amount'  => 0,                    // 该类别总费用计数器，初始为0
        ),
        array(
            'product_id'    => array( 817, 819, 820 ),
            'amount'        => 25,
            'name'          => __( 'Packing fee', 'woocommerce' ),
            'total_amount'  => 0,
        ),
        array(
            'product_id'    => array( 825 ),
            'amount'        => 100,
            'name'          => __( 'Another fee', 'woocommerce' ),
            'total_amount'  => 0,
        ),
    );

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

        // 遍历费用设置数组，确定每个类别的总金额
        foreach ( $settings as $key => $setting ) {
            // 检查当前商品ID是否在当前费用设置的产品ID数组中
            if ( in_array( $product_id, $settings[$key]['product_id'] ) ) {
                // 将该商品的附加费累加到对应类别的 total_amount 中，并考虑商品数量
                $settings[$key]['total_amount'] += $setting['amount'] * $quantity;
            }
        }       
    }

    // 遍历费用设置数组，将累加后的总费用添加到购物车
    foreach ( $settings as $setting ) {
        // 只有当该类别的总费用大于0时才添加
        if ( $setting['total_amount'] > 0 ) {
            // 添加费用到购物车，'false' 表示该费用不可税
            $cart->add_fee( $setting['name'], $setting['total_amount'], false );    
        }
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees', 10, 1 );

代码详解

1. action_woocommerce_cart_calculate_fees( $cart ) 函数：

   • 这是一个WooCommerce钩子函数，用于在购物车计算费用时执行自定义逻辑。
   • if ( is_admin() && ! defined( 'DOING_AJAX' ) ) return;：此条件判断确保代码仅在前端购物车页面或AJAX请求时执行，避免在后台或不必要的情况下运行。

2. $settings 数组：

   

   度加剪辑

   度加剪辑（原度咔剪辑），百度旗下AI创作工具

   63

   查看详情
   • 这是一个核心配置数组，定义了所有附加费规则。
   • 'product_id' =youjiankuohaophpcn array( 30, 813, 815 )：关键点，这里使用一个数组来存储属于同一费用类别的所有产品ID。这是解决多产品累加问题的核心。
   • 'amount' => 5：单个符合条件的产品所产生的附加费金额。
   • 'name' => __( 'Additional service fee', 'woocommerce' )：在购物车中显示的费用名称。
   • 'total_amount' => 0：这是一个临时计数器，用于在遍历购物车时累加当前费用类别的总金额。注意：此字段在初始化时必须为0，且不应在外部修改，它仅用于内部累加。

3. 第一个 foreach ( $cart->get_cart_contents() as $cart_item ) 循环：

   • 此循环遍历购物车中的每一个商品。
   • $product_id = $cart_item['product_id']; 获取当前商品的ID。
   • $quantity = $cart_item['quantity']; 获取当前商品的数量。
   • 处理商品数量：如果您的附加费不依赖于商品数量，可以删除 $quantity = $cart_item['quantity']; 这一行，并将 $settings[$key]['total_amount'] += $setting['amount'] * $quantity; 修改为 $settings[$key]['total_amount'] += $setting['amount'];。

4. 嵌套的 foreach ( $settings as $key => $setting ) 循环：

   • 对于购物车中的每个商品，此循环会检查它是否属于任何一个定义的费用类别。
   • if ( in_array( $product_id, $settings[$key]['product_id'] ) )：使用 in_array() 函数判断当前商品ID是否存在于某个费用设置的 product_id 数组中。
   • $settings[$key]['total_amount'] += $setting['amount'] * $quantity;：如果商品匹配，则将该商品的附加费（金额乘以数量）累加到对应费用设置的 total_amount 计数器中。

5. 第二个 foreach ( $settings as $setting ) 循环：

   • 在所有购物车商品遍历完成后，此循环负责将最终计算出的附加费添加到购物车。
   • if ( $setting['total_amount'] > 0 )：只有当某个费用类别的总金额大于0时，才将其添加到购物车，避免显示0金额的费用。
   • $cart->add_fee( $setting['name'], $setting['total_amount'], false );：这是WooCommerce提供的添加费用函数。
     • $setting['name']：费用名称。
     • $setting['total_amount']：该类别的总附加费金额。
     • false：表示该费用不可税。如果需要征税，可以将其设置为 true。

注意事项与最佳实践

• 代码放置位置：将上述PHP代码添加到您的WordPress主题的 functions.php 文件中，或通过自定义插件引入。推荐使用自定义插件，以避免主题更新时代码丢失。
• total_amount 字段：务必理解 total_amount 的作用是一个累加器，它在 $settings 数组初始化时应始终为 0。它会在购物车计算过程中动态更新，但不会影响到下一个购物车会话的初始值。
• 商品数量考虑：根据您的业务需求，选择是否将商品数量纳入附加费计算。代码中默认是考虑数量的。
• 测试：在生产环境部署前，务必在开发或测试环境中进行充分测试，确保所有费用计算逻辑符合预期。测试不同组合的产品（同一类别多个、不同类别多个、单一产品等）。
• 费用名称：确保费用名称清晰明了，方便用户理解。__('...', 'woocommerce') 函数用于国际化，方便多语言支持。

总结

通过上述优化方案，您可以为WooCommerce商店中的特定产品组实现灵活且准确的附加费累加功能。此方法解决了传统实现中费用不累加的问题，并提供了对商品数量的考虑，极大地增强了购物车费用管理的灵活性和准确性，为您的客户提供了更清晰的费用明细。

以上就是WooCommerce购物车多产品附加费叠加计算教程的详细内容，更多请关注php中文网其它相关文章！