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请求，保存折扣状态到会话，并在购物车计算时应用或移除折扣。
将以下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生态系统中的全面显示。这种方法为用户提供了灵活的购物体验，同时也为商家提供了一种简便的折扣营销工具。
