在 WooCommerce 结账时为特定用户角色添加“配送到不同地址”费用

DDD
发布: 2025-11-01 10:47:10
原创
861人浏览过

在 WooCommerce 结账时为特定用户角色添加“配送到不同地址”费用

本教程详细介绍了如何在 woocommerce 结账流程中,为特定用户角色(如“team”和“team2”)设置一项条件性费用。当这些用户选择“配送到不同地址”时,系统将自动添加一笔固定费用。文章涵盖了前端 javascript 交互、后端 ajax 处理以及 woocommerce 购物车费用计算的 php 实现,确保了功能的准确性和专业性。

在 WooCommerce 电子商务平台中,有时我们需要根据用户的特定行为和身份来调整结账费用。例如,对于批发站点或拥有不同会员等级的商店,可能需要为某些特定用户角色在选择“配送到不同地址”时额外收取一笔费用。本教程将指导您如何实现这一功能,确保只有指定的用户角色在满足条件时才会被收取此费用。

核心实现原理

实现此功能需要前端和后端协同工作,主要包括以下三个部分:

  1. 前端 JavaScript (jQuery) 监听与 AJAX 请求:在结账页面,使用 JavaScript 监听“配送到不同地址”复选框的状态变化。当复选框被选中或取消选中时,通过 AJAX 请求将状态发送到后端。
  2. 后端 WordPress AJAX 处理:WordPress 后端接收前端发送的 AJAX 请求,并将复选框的状态存储在 WooCommerce 的会话 (session) 中,以便后续在服务器端进行费用计算时可以访问。
  3. WooCommerce 购物车费用计算:利用 WooCommerce 提供的钩子,在购物车费用计算时检查会话中存储的状态以及当前用户的角色。如果满足特定用户角色且“配送到不同地址”被选中,则添加相应的费用。

实施步骤

以下是详细的实现代码和说明,请将这些代码添加到您的主题的 functions.php 文件或一个自定义插件中。

1. 前端 JavaScript 交互与 AJAX 请求

这段代码负责在用户界面上检测“配送到不同地址”复选框的变化,并通知服务器。

/**
 * 前端 JavaScript:监听“配送到不同地址”复选框状态并发送 AJAX 请求
 */
function custom_ship_to_different_address_script() {
    // 仅在结账页面且用户已登录时执行
    if ( ! is_user_logged_in() || ! is_checkout() || is_wc_endpoint_url() ) {
        return;
    }

    // 在页面加载时清除自定义的 WooCommerce 会话变量
    // 这确保了页面刷新时,费用状态不会因旧的会话数据而错误显示
    if ( WC()->session->get( 'ship_different' ) ) {
        WC()->session->__unset( 'ship_different' );
    }
    ?>
    <script type="text/javascript">
        jQuery( function($) {
            // 确保 WooCommerce 结账参数已定义
            if ( typeof wc_checkout_params === 'undefined' ) {
                return false;
            }

            var checkboxSelector = '#ship-to-different-address-checkbox'; // “配送到不同地址”复选框的 ID
            var checkboxState = '';

            // 定义 AJAX 函数,用于发送复选框状态
            function triggerShipToDifferentAddress( value ) {
                $.ajax({
                    type: 'POST',
                    url: wc_checkout_params.ajax_url, // WordPress AJAX URL
                    data: {
                        'action': 'ship_different_address', // 定义的 AJAX 动作
                        'ship_different': value,           // 复选框状态 ('yes' 或 'no')
                    },
                    success: function (result) {
                        // 成功后触发结账页面更新,以便重新计算费用
                        $( 'body' ).trigger( 'update_checkout' );
                        // console.log( result ); // 用于测试,生产环境中应移除
                    }
                });
            }

            // 监听复选框的 'change' 事件
            $( checkboxSelector ).on( 'change', function() {
                checkboxState = $( this ).prop('checked') === true ? 'yes' : 'no';
                triggerShipToDifferentAddress( checkboxState );
            });
        });
    </script>
    <?php
}
add_action( 'wp_footer', 'custom_ship_to_different_address_script' );
登录后复制

代码说明

  • custom_ship_to_different_address_script 函数通过 wp_footer 钩子将 JavaScript 代码添加到页面底部。
  • 它首先检查当前是否在结账页面且用户已登录,以确保代码只在需要时运行。
  • 在页面加载时,会清除之前可能存在的 ship_different 会话变量,防止旧数据干扰。
  • JavaScript 代码监听 ID 为 ship-to-different-address-checkbox 的复选框(这是 WooCommerce 默认的“配送到不同地址”复选框 ID)的 change 事件。
  • 当复选框状态改变时,它会发送一个 AJAX 请求到 wc_checkout_params.ajax_url,并附带一个 action 参数 (ship_different_address) 和一个 ship_different 参数(值为 'yes' 或 'no')。
  • AJAX 请求成功后,会触发 $( 'body' ).trigger( 'update_checkout' );,强制 WooCommerce 重新计算结账总价,从而更新费用。

2. 后端 WordPress AJAX 处理

这段 PHP 代码负责接收前端发送的 AJAX 请求,并将复选框状态安全地存储到 WooCommerce 会话中。

AI角色脑洞生成器
AI角色脑洞生成器

一键打造完整角色设定,轻松创造专属小说漫画游戏角色背景故事

AI角色脑洞生成器176
查看详情 AI角色脑洞生成器
/**
 * 后端 PHP:处理 AJAX 请求并将会话数据存储到 WooCommerce
 */
function custom_get_ajax_ship_different_address() {
    if ( isset( $_POST['ship_different'] ) ) {
        // 将前端发送的复选框状态存储到 WooCommerce 会话中
        WC()->session->set( 'ship_different', sanitize_text_field( $_POST['ship_different'] ) );
        echo sanitize_text_field( $_POST['ship_different'] ); // 返回状态给前端(可选)
    }
    // 终止 AJAX 请求的执行
    wp_die();
}
add_action( 'wp_ajax_ship_different_address', 'custom_get_ajax_ship_different_address' );
add_action( 'wp_ajax_nopriv_ship_different_address', 'custom_get_ajax_ship_different_address' );
登录后复制

代码说明

  • custom_get_ajax_ship_different_address 函数通过 wp_ajax_ 和 wp_ajax_nopriv_ 钩子注册为 AJAX 处理器。wp_ajax_ 用于已登录用户,wp_ajax_nopriv_ 用于未登录用户。
  • 它检查 $_POST 数据中是否存在 ship_different 参数。
  • 如果存在,它将使用 WC()->session->set() 方法将会话变量 ship_different 设置为接收到的值。sanitize_text_field() 用于数据清理,提高安全性。
  • wp_die() 函数是 WordPress AJAX 请求的惯例,用于终止请求并返回响应。

3. 条件性添加费用

这段 PHP 代码是核心逻辑,它在购物车费用计算时检查用户角色和会话状态,然后决定是否添加费用。

/**
 * WooCommerce 费用计算:根据用户角色和“配送到不同地址”状态添加费用
 */
function custom_add_remove_ship_to_different_address_fee( $cart ) {
    // 确保仅在结账页面且不是在后台或购物车页面时执行
    if ( ( is_admin() && ! defined( 'DOING_AJAX' ) ) || is_cart() ) {
        return;
    }

    // 确保用户已登录
    if ( ! is_user_logged_in() ) {
        return;
    }

    // 获取当前用户对象
    $user = wp_get_current_user();

    // 定义需要收取费用的用户角色,请根据您的实际情况修改
    $target_roles = array( 'team', 'team2' ); 

    // 获取当前用户的所有角色
    $user_roles = ( array ) $user->roles;

    // 检查用户是否拥有任何一个目标角色
    // array_intersect 返回两个数组的交集,如果结果不为空,则表示用户拥有至少一个目标角色
    $common_roles = array_intersect( $user_roles, $target_roles );

    // 如果用户拥有至少一个目标角色
    if ( ! empty( $common_roles ) ) {
        $fee_amount = 5.00; // 定义费用金额,请根据您的需求修改

        // 如果 WooCommerce 会话中 'ship_different' 变量为 'yes' (即“配送到不同地址”被选中)
        if ( WC()->session->get( 'ship_different' ) == 'yes' ) {
            // 添加自定义费用
            $cart->add_fee( __( '配送费用', 'woocommerce'), $fee_amount );
        }
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'custom_add_remove_ship_to_different_address_fee', 10, 1 );
登录后复制

代码说明

  • custom_add_remove_ship_to_different_address_fee 函数通过 woocommerce_cart_calculate_fees 钩子在购物车费用计算时被调用。
  • 它首先进行多项检查:是否在结账页面、是否为管理员操作、以及用户是否已登录。
  • 接着,它获取当前用户的角色 ($user->roles)。
  • $target_roles 数组定义了哪些用户角色在满足条件时需要收取费用。您可以根据实际需求修改此数组。
  • array_intersect( $user_roles, $target_roles ) 用于找出用户所拥有的角色与目标角色列表的交集。如果交集不为空 (! empty( $common_roles )),则表示当前用户拥有至少一个目标角色。
  • 如果用户角色匹配,并且通过 WC()->session->get( 'ship_different' ) == 'yes' 检查到“配送到不同地址”复选框被选中,则使用 $cart->add_fee() 方法添加一笔自定义费用。
  • __( '配送费用', 'woocommerce') 是费用的名称,可以根据需要进行本地化。
  • $fee_amount 是费用的具体金额,请根据您的业务需求进行调整。

注意事项与总结

  1. 代码位置:所有 PHP 代码应放置在您的主题的 functions.php 文件中,或者更推荐的方式是创建一个自定义插件来管理这些功能。
  2. 用户角色:请务必将 $target_roles 数组中的用户角色修改为您的网站实际使用的角色名称。例如,如果您的角色是 wholesale_customer,则应将其添加到数组中。
  3. 费用金额:$fee_amount 变量控制着收取的具体费用,您可以根据需要调整其值。
  4. 调试:如果在实现过程中遇到问题,可以取消注释 JavaScript 代码中的 console.log( result ); 来查看 AJAX 响应,并在 PHP 代码中使用 error_log() 来记录变量值进行调试。
  5. 缓存:如果您的网站使用了页面缓存插件,请确保在测试此功能时清除缓存,或在开发环境中禁用缓存,以避免旧的页面内容干扰。
  6. 安全性:在处理用户输入时,始终使用 sanitize_text_field() 或其他适当的 WordPress 过滤函数来清理数据,以防止安全漏洞。

通过上述步骤,您可以在 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号