WooCommerce购物车页面动态折扣:添加复选框实现固定金额优惠

碧海醫心
发布: 2025-10-04 11:13:38
原创
217人浏览过

WooCommerce购物车页面动态折扣:添加复选框实现固定金额优惠

本教程详细指导如何在WooCommerce购物车页面添加一个复选框,用户勾选后可动态应用固定金额折扣,取消勾选则移除折扣。文章涵盖前端复选框集成、JavaScript动态交互、后端PHP折扣逻辑以及会话管理,确保折扣信息在购物车、结算页、订单邮件和后台均正确显示和更新,实现无缝的用户体验。

1. 理解核心需求:动态折扣与全局更新

我们的目标是在woocommerce购物车页面添加一个复选框,当用户勾选此复选框时,购物车总价应立即应用一个固定的折扣金额;当用户取消勾选时,折扣应被移除。更重要的是,这个折扣状态需要持久化,并在woocommerce的各个环节(如迷你购物车、结算页面、订单详情、后台管理界面及订单邮件)中正确显示和更新。

实现这一功能需要结合前端的HTML/JavaScript和后端的PHP逻辑。前端负责展示复选框并处理用户交互,通过AJAX请求将状态发送到后端;后端则根据状态管理会话数据,并在购物车计算时应用或移除折扣。

2. 前端集成:添加复选框

首先,我们需要将复选框添加到购物车页面。woocommerce_cart_totals_before_shipping 钩子是一个合适的插入点,它位于购物车总计的运输信息之前。

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

/**
 * 在购物车总计前添加折扣复选框
 */
function custom_add_discount_checkbox_to_cart() {
    // 确保在购物车页面且购物车不为空时显示
    if ( is_cart() && ! WC()->cart->is_empty() ) {
        // 从会话中获取当前折扣状态,用于初始化复选框
        $is_discount_applied = WC()->session->get( 'apply_custom_discount', false );
        ?>
        <tr class="custom-discount-row">
            <th><?php esc_html_e( '应用特别折扣', 'your-text-domain' ); ?></th>
            <td data-title="<?php esc_attr_e( '应用特别折扣', 'your-text-domain' ); ?>">
                <label class="woocommerce-form__label woocommerce-form__label-for-checkbox checkbox">
                    <input type="checkbox" class="woocommerce-form__input woocommerce-form__input-checkbox input-checkbox" 
                           id="custom_apply_discount" 
                           name="custom_apply_discount" 
                           value="1" 
                           <?php checked( $is_discount_applied, true ); ?> />
                    <span><?php esc_html_e( '我想要享受固定折扣!', 'your-text-domain' ); ?></span>
                </label>
            </td>
        </tr>
        <?php
    }
}
add_action( 'woocommerce_cart_totals_before_shipping', 'custom_add_discount_checkbox_to_cart' );
登录后复制

代码说明:

  • custom_add_discount_checkbox_to_cart() 函数通过 woocommerce_cart_totals_before_shipping 钩子在购物车总计表格中添加一行。
  • 我们检查 is_cart() 和 ! WC()->cart->is_empty() 确保只在购物车页面且有商品时显示。
  • 复选框的 id 和 name 属性是 custom_apply_discount,这将用于JavaScript和后端识别。
  • checked( $is_discount_applied, true ); 用于根据会话中保存的状态初始化复选框的选中状态。

3. JavaScript交互:实现动态折扣

复选框的状态变化需要通过AJAX实时更新购物车总计。我们将监听复选框的 change 事件,并向后端发送一个AJAX请求。

将以下JavaScript代码添加到您的主题的JavaScript文件(通常是 theme.js 或 custom.js),或者通过 wp_enqueue_script 钩子将其内联或加载。

jQuery(function($) {
    // 监听自定义折扣复选框的改变事件
    $(document.body).on('change', '#custom_apply_discount', function() {
        var is_checked = $(this).is(':checked');

        // 发送AJAX请求到后端
        $.ajax({
            type: 'POST',
            url: woocommerce_params.ajax_url, // WooCommerce提供的AJAX URL
            data: {
                action: 'custom_update_discount_status', // 后端将处理的AJAX动作
                security: woocommerce_params.update_order_review_nonce, // 安全 nonce
                apply_discount: is_checked ? 1 : 0
            },
            success: function(response) {
                if (response.success) {
                    // AJAX成功后,触发购物车/结算页的更新
                    // 对于购物车页面,触发 'updated_wc_div' 事件
                    // 对于结算页面,触发 'update_checkout' 事件
                    if ( $('body').hasClass('woocommerce-cart') ) {
                        $(document.body).trigger('updated_wc_div'); 
                    } else if ( $('body').hasClass('woocommerce-checkout') ) {
                        $(document.body).trigger('update_checkout');
                    }
                } else {
                    console.error('更新折扣状态失败:', response.data);
                }
            },
            error: function(jqXHR, textStatus, errorThrown) {
                console.error('AJAX请求错误:', textStatus, errorThrown);
            }
        });
    });
});
登录后复制

代码说明:

  • 我们使用 jQuery(function($){...}) 确保DOM加载完成后执行代码。
  • $(document.body).on('change', '#custom_apply_discount', ...) 监听复选框的 change 事件。
  • woocommerce_params.ajax_url 和 woocommerce_params.update_order_review_nonce 是WooCommerce提供的全局JS变量,用于AJAX请求。
  • action: 'custom_update_discount_status' 定义了后端将处理的AJAX动作。
  • 成功响应后,根据当前页面是购物车 (woocommerce-cart) 还是结算页 (woocommerce-checkout),触发相应的事件 (updated_wc_div 或 update_checkout),这将强制WooCommerce重新计算并刷新显示。

4. 后端逻辑:处理折扣与会话

后端需要处理AJAX请求,保存折扣状态到会话,并在购物车计算时应用或移除折扣。

稿定AI
稿定AI

拥有线稿上色优化、图片重绘、人物姿势检测、涂鸦完善等功能

稿定AI 25
查看详情 稿定AI

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

/**
 * 1. AJAX处理函数:保存折扣状态到会话
 */
function custom_ajax_update_discount_status() {
    // 检查安全 nonce
    if ( ! isset( $_POST['security'] ) || ! wp_verify_nonce( $_POST['security'], 'woocommerce-cart' ) && ! wp_verify_nonce( $_POST['security'], 'update-order-review' ) ) {
        wp_send_json_error( 'Nonce verification failed.' );
    }

    $apply_discount = isset( $_POST['apply_discount'] ) && (int) $_POST['apply_discount'] === 1;

    // 确保WooCommerce会话已启动
    if ( ! WC()->session->has_session() ) {
        WC()->session->set_customer_session_cookie( true );
    }

    // 将折扣状态保存到WooCommerce会话
    WC()->session->set( 'apply_custom_discount', $apply_discount );

    wp_send_json_success( 'Discount status updated.' );
}
add_action( 'wp_ajax_custom_update_discount_status', 'custom_ajax_update_discount_status' );
add_action( 'wp_ajax_nopriv_custom_update_discount_status', 'custom_ajax_update_discount_status' ); // 允许未登录用户使用

/**
 * 2. 应用折扣:使用 woocommerce_cart_calculate_fees 钩子
 */
function custom_apply_fixed_discount_fee( $cart ) {
    // 避免在AJAX请求中重复计算
    if ( is_admin() && ! defined( 'DOING_AJAX' ) ) {
        return;
    }

    // 确保会话已启动
    if ( ! WC()->session->has_session() ) {
        return;
    }

    // 获取折扣状态和折扣金额
    $is_discount_applied = WC()->session->get( 'apply_custom_discount', false );
    $fixed_discount_amount = 10.00; // 设置您的固定折扣金额

    if ( $is_discount_applied && $cart->get_subtotal() > 0 ) {
        // 添加一个负的费用作为折扣
        $cart->add_fee( __( '特别折扣', 'your-text-domain' ), -$fixed_discount_amount, true, 'standard' );
    }
}
add_action( 'woocommerce_cart_calculate_fees', 'custom_apply_fixed_discount_fee', 10, 1 );

/**
 * 3. 确保WooCommerce会话在所有页面都可用
 *    此步骤通常不是必需的,因为WooCommerce默认会启动会话。
 *    但如果遇到会话问题,可以尝试。
 */
function custom_start_wc_session() {
    if ( ! is_admin() && ! WC()->session->has_session() ) {
        WC()->session->set_customer_session_cookie( true );
    }
}
add_action( 'init', 'custom_start_wc_session' );
登录后复制

代码说明:

  • AJAX处理函数 (custom_ajax_update_discount_status)

    • 通过 wp_ajax_ 和 wp_ajax_nopriv_ 钩子注册AJAX处理函数,使其对登录和未登录用户都可用。
    • wp_verify_nonce() 进行安全验证,防止CSRF攻击。
    • 从 $_POST 获取 apply_discount 状态。
    • WC()->session->set() 将布尔值保存到WooCommerce会话中,键为 apply_custom_discount。
    • wp_send_json_success() 或 wp_send_json_error() 返回JSON响应给前端。
  • 应用折扣函数 (custom_apply_fixed_discount_fee)

    • woocommerce_cart_calculate_fees 钩子在购物车总计计算时触发,是添加自定义费用或折扣的理想位置。
    • 我们从会话中检索 apply_custom_discount 的状态。
    • $fixed_discount_amount 定义了您希望应用的固定折扣金额。
    • 如果折扣被应用且购物车总金额大于0,我们使用 $cart->add_fee() 方法添加一个负数费用。负数费用在WooCommerce中被视为折扣。
      • 第一个参数是折扣名称(会显示在购物车和订单中)。
      • 第二个参数是折扣金额(负数表示折扣)。
      • 第三个参数 true 表示该费用是可税的。
      • 第四个参数 'standard' 表示税率类别。
  • 会话启动 (custom_start_wc_session)

    • 虽然WooCommerce通常会自行处理会话,但为了确保万无一失,特别是当您在早期钩子中访问会话时,可以显式地调用 WC()->session->set_customer_session_cookie( true );。此函数在 init 钩子中执行,确保会话在页面加载早期启动。

5. 确保折扣持久化与全局显示

通过上述步骤,折扣状态已存储在WooCommerce会话中,并在每次购物车计算时被应用。这意味着:

  • 购物车页面: 每次刷新或AJAX更新后,复选框的选中状态和折扣金额都会正确显示。
  • 迷你购物车: 由于迷你购物车也会根据会话重新计算,折扣将正确反映。
  • 结算页面: 结算页面同样依赖于购物车会话数据进行总计计算,折扣会正确显示。
  • 订单创建: 当用户完成订单时,购物车中的折扣会被记录为订单费用的一部分。
  • 订单邮件和后台管理: 由于折扣是作为订单费用存储的,它将自动显示在订单详情页(后台)和发送给客户的订单邮件中。

6. 高级考量与注意事项

  • 安全性: 在AJAX请求中始终使用 wp_verify_nonce() 进行安全验证,以防止跨站请求伪造(CSRF)。
  • 折扣类型: 本教程实现的是固定金额折扣。如果需要百分比折扣,您需要修改 custom_apply_fixed_discount_fee 函数中的计算逻辑,例如:$discount_amount = $cart->get_subtotal() * 0.10; (10% 折扣)。
  • 后台订单管理: 由于折扣是以负费用形式添加到订单的,管理员可以在WooCommerce后台的订单详情页看到这个“特别折扣”项。如果需要更复杂的后台控制(例如,在订单创建后手动移除此折扣),可能需要为订单添加自定义元数据,并在订单编辑界面开发一个自定义元框。
  • 兼容性: 确保您的代码与当前使用的WooCommerce版本兼容。在更新WooCommerce或主题后,请进行测试。
  • 文本域: 在 __('...', 'your-text-domain') 中,请将 'your-text-domain' 替换为您的主题或插件的实际文本域,以便进行国际化。
  • 样式: 您可能需要为复选框及其标签添加自定义CSS样式,以使其与您网站的设计风格保持一致。

总结

通过上述分步教程,我们成功地在WooCommerce购物车页面集成了一个动态折扣复选框。这个解决方案不仅实现了前端的交互性,还通过后端PHP逻辑确保了折扣的正确应用、持久化以及在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号