在 WooCommerce 购物车中为不同商品添加差异化附加费用教程

心靈之曲
发布: 2025-09-19 10:22:01
原创
980人浏览过

在 WooCommerce 购物车中为不同商品添加差异化附加费用教程

本教程旨在指导您如何在 WooCommerce 购物车中为不同商品动态添加差异化的附加费用,避免使用额外插件或重复代码。我们将探讨两种基于代码的解决方案:一种是将所有相关商品的附加费用汇总显示,另一种是为每个商品单独显示其对应的附加费用,从而提升结账体验的灵活性和透明度。

前言:理解需求与挑战

在 woocommerce 中,商家经常需要根据特定商品收取额外的费用,例如包装费、服务费或特殊处理费。然而,直接使用 wc()-youjiankuohaophpcncart->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 表示该费用不含税。

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

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

度加剪辑
度加剪辑

度加剪辑(原度咔剪辑),百度旗下AI创作工具

度加剪辑63
查看详情 度加剪辑

实现原理

此方法使用一个多维数组来存储每个产品的附加费用信息,包括产品 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 商店的运营效率和用户体验。

以上就是在 WooCommerce 购物车中为不同商品添加差异化附加费用教程的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习
PHP中文网抖音号
发现有趣的

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号