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

心靈之曲
发布: 2025-09-19 13:25:22
原创
392人浏览过

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

本教程将指导您如何在WooCommerce购物车中为不同的商品动态添加不同的附加费,避免使用额外插件。我们将通过PHP代码和数组映射的方式,实现根据商品ID灵活设置附加费,并提供两种实现方案:一种是将所有附加费汇总显示,另一种是为每个匹配商品单独显示附加费,以提升用户体验和代码效率。

问题背景与现有代码局限性

在woocommerce中,商家经常需要根据特定商品收取额外的费用,例如服务费、包装费或处理费。然而,简单地为所有符合条件的商品添加一个统一的附加费,往往无法满足复杂业务需求。例如,如果希望产品a收取5元附加费,产品b收取10元附加费,而现有代码可能仅支持为多个产品id应用同一个附加费金额,这导致了灵活性不足。

原始代码示例:

add_action('woocommerce_cart_calculate_fees', 'add_fees_on_ids');
function add_fees_on_ids() {
   if (is_admin() && !defined('DOING_AJAX')) {return;}
   foreach( WC()->cart->get_cart() as $item_keys => $item ) {
     if( in_array( $item['product_id'], fee_ids() )) {
     WC()->cart->add_fee(__('ADDITIONAL FEE:'), 5);
     }
   }
}
function fee_ids() {
   return array( 2179 ); // 只能指定一个产品ID或一组产品ID,但费用是固定的
}
登录后复制

这段代码的局限性在于,WC()-youjiankuohaophpcncart->add_fee(__('ADDITIONAL FEE:'), 5); 中的 5 是一个固定值。即使 fee_ids() 返回多个产品ID,这些产品也只会应用相同的5元附加费。为了实现不同产品对应不同附加费的需求,我们需要一种更动态、更灵活的配置方式。

核心解决方案:基于数组的商品附加费映射

为了解决上述问题,最佳实践是利用PHP数组来建立商品ID与对应附加费的映射关系。这种方法避免了安装额外的插件,保持了网站的轻量级和高性能,并且易于管理和扩展。同时,我们应避免多次遍历购物车,以优化性能。

以下将介绍两种实现方案:

方案一:汇总显示所有匹配商品的附加费

此方案适用于当您希望将购物车中所有符合条件的商品的附加费加起来,并以一个总金额显示给客户的情况。

原理说明: 我们创建一个配置数组,其中键代表附加费金额,值代表对应的商品ID。然后,遍历购物车中的每个商品,如果商品ID在我们的配置数组中,就将其对应的附加费累加到一个总变量中。最后,如果总附加费大于零,则一次性添加到购物车中。

示例代码:

度加剪辑
度加剪辑

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

度加剪辑 63
查看详情 度加剪辑
/**
 * 为购物车中特定商品添加汇总的附加费。
 *
 * @param WC_Cart $cart WooCommerce 购物车对象。
 */
function action_woocommerce_cart_calculate_fees_summed( $cart ) {
    // 确保只在前台和非 AJAX 请求时执行
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 配置附加费与商品ID的映射关系。
    // 格式为:附加费金额 => 商品ID
    $settings = array(
        10  => 1234, // 产品ID 1234 对应 10 单位的附加费
        20  => 5678, // 产品ID 5678 对应 20 单位的附加费
        5   => 30,   // 产品ID 30 对应 5 单位的附加费
        2   => 815,  // 产品ID 815 对应 2 单位的附加费
    );

    // 初始化总附加费
    $additional_fee_total = 0;

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

        // 在 $settings 数组中查找当前商品的ID。
        // 如果找到,array_search 会返回对应的键(即附加费金额)。
        if ( false !== $fee_amount = array_search( $product_id, $settings ) ) {
            $additional_fee_total += $fee_amount; // 累加附加费
        }
    }

    // 如果总附加费大于 0,则将其添加到购物车中
    if ( $additional_fee_total > 0 ) {
        // 第三个参数为 false 表示该费用不含税
        $cart->add_fee( __( '附加费用', 'woocommerce' ), $additional_fee_total, false );
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_summed', 10, 1 );
登录后复制

代码解析:

  • action_woocommerce_cart_calculate_fees_summed($cart) 函数通过 woocommerce_cart_calculate_fees 钩子在计算购物车费用时执行。
  • is_admin() && ! defined( 'DOING_AJAX' ) 确保代码只在用户浏览前台购物车页面时运行,避免在后台或AJAX请求中不必要的执行。
  • $settings 数组是核心配置,您可以在此定义商品ID及其对应的附加费。
  • foreach ( $cart->get_cart_contents() as $cart_item ) 循环遍历购物车中的所有商品。
  • array_search( $product_id, $settings ) 用于查找商品ID在 $settings 数组中的位置。如果找到,它会返回对应的键(即我们定义的附加费金额)。
  • $additional_fee_total += $fee_amount; 将找到的附加费累加起来。
  • $cart->add_fee( __( '附加费用', 'woocommerce' ), $additional_fee_total, false ); 将累加后的总附加费添加到购物车。__('附加费用', 'woocommerce') 确保了费用名称是可翻译的。

方案二:为每个匹配商品单独显示附加费(推荐)

此方案更具灵活性和用户友好性,因为它允许为每个符合条件的商品显示独立的附加费条目,让客户清楚地知道每笔额外费用来自何处。

原理说明: 我们使用一个多维数组来存储更详细的费用信息,包括 product_id、amount(金额)和 name(费用名称)。遍历购物车商品时,再嵌套循环遍历这个配置数组,如果商品ID匹配,则直接将该商品的附加费及其名称添加到购物车中。

示例代码:

/**
 * 为购物车中每个特定商品添加单独的附加费。
 *
 * @param WC_Cart $cart WooCommerce 购物车对象。
 */
function action_woocommerce_cart_calculate_fees_individual( $cart ) {
    // 确保只在前台和非 AJAX 请求时执行
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 配置:包含商品ID、金额和名称的多维数组
    $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' ),
        ),
        // 您可以根据需要添加更多配置
        array(
            'product_id' => 1234,
            'amount'     => 7.5,
            'name'       => __( '特殊处理费', 'woocommerce' ),
        ),
    );

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

        // 遍历设置数组,查找匹配的商品ID
        foreach ( $settings as $setting ) {
            if ( $setting['product_id'] == $product_id ) {
                // 如果找到匹配项,则添加对应的费用
                // 第三个参数为 false 表示该费用不含税
                $cart->add_fee( $setting['name'], $setting['amount'], false );
                // 如果一个产品只需要一种附加费,可以在这里添加 break; 语句
                // break;
            }
        }
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'action_woocommerce_cart_calculate_fees_individual', 10, 1 );
登录后复制

代码解析:

  • 此方案同样使用 woocommerce_cart_calculate_fees 钩子和 is_admin() 检查。
  • $settings 数组现在是一个多维数组,每个子数组包含 product_id、amount 和 name 三个键值对,提供了更详细的费用描述。
  • 外层循环遍历购物车商品,内层循环遍历 $settings 数组。
  • 当 product_id 匹配时,直接使用 add_fee( $setting['name'], $setting['amount'], false ) 将带有特定名称和金额的附加费添加到购物车。
  • 这种方法使得每笔附加费在购物车总览中都有清晰的名称,提高了透明度。

注意事项与最佳实践

  1. 代码放置位置:

    • 将上述代码片段添加到您的WordPress子主题的 functions.php 文件中。强烈建议使用子主题,以避免主题更新时代码被覆盖。
    • 或者,创建一个自定义插件来管理这些功能,这对于更复杂的定制更为推荐。
  2. 性能考量:

    • 上述两种方案都只对购物车内容进行了一次或两次遍历,效率较高。避免在循环内部执行数据库查询或耗时操作。
    • is_admin() && ! defined( 'DOING_AJAX' ) 检查是优化性能的关键,它阻止了在不必要的情况下执行代码。
  3. 可翻译性:

    • 在 add_fee 函数中,费用名称使用了 __( '费用名称', 'woocommerce' ) 格式。这是WordPress和WooCommerce中实现文本国际化(即翻译)的标准方法,确保您的网站在多语言环境下也能正常显示。
  4. 调试与测试:

    • 在将代码部署到生产环境之前,务必在开发或测试环境中进行充分测试。检查不同商品组合、数量变化以及购物车更新时的附加费计算是否准确无误。
  5. 税费处理:

    • 在 add_fee 方法中,第三个参数 false 表示该费用不含税。如果您的附加费需要包含税费,请将其设置为 true。请根据您的具体税务设置和法律要求进行调整。

总结

通过本文介绍的基于数组的PHP代码解决方案,您可以灵活且高效地在WooCommerce购物车中为不同的商品设置差异化的附加费。无论是选择汇总显示还是单独显示每笔费用,这些方法都比安装额外插件更轻量级,并能提供更好的性能和定制能力。正确地实施这些代码,将有助于您更好地管理WooCommerce商店的定价策略和用户体验。

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

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

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

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

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