引言
在 woocommerce 商店中，有时我们需要在结账页面显示一个自定义的复选框（例如，隐私政策同意、特殊条款确认等），但这个复选框的显示逻辑可能并非一成不变。例如，当购物车中包含某些特定商品时，我们可能希望隐藏这个复选框，因为它对这些商品不适用或已被其他方式处理。本教程将指导您如何通过自定义代码实现这一高级功能，确保复选框的显示、验证和数据保存都能够根据购物车内容进行动态调整。
核心逻辑：判断购物车中是否存在特定商品
实现条件显示的第一步是创建一个辅助函数，用于检查购物车中是否存在一个或多个预定义的商品ID。这个函数将作为我们后续逻辑的基础。
/**
* 检查购物车中是否存在特定商品ID
*
* @return bool 如果购物车中存在任一目标商品，则返回 true；否则返回 false。
*/
function is_targeted_product_in_cart() {
// 定义一个包含目标商品ID的数组。您可以添加多个ID。
$targeted_ids = array( 32, 1234, 5678 ); // 将 32, 1234, 5678 替换为您希望隐藏复选框时购物车中存在的商品ID
// 标志，默认为购物车中不存在目标商品
$flag = false;
// 确保 WooCommerce 购物车对象不为空
if ( ! is_null( WC()->cart ) ) {
// 遍历购物车中的所有商品
foreach ( WC()->cart->get_cart() as $cart_item ) {
// 检查当前购物车商品ID是否在目标ID数组中
if ( in_array( $cart_item['product_id'], $targeted_ids ) ) {
// 如果找到目标商品，设置标志为 true
$flag = true;
// 找到后即可中断循环，提高效率
break;
}
}
}
return $flag;
}代码解释：
- $targeted_ids 数组：这是您需要根据其存在与否来控制复选框显示的目标商品ID列表。请务必根据您的实际需求修改这些ID。
- WC()->cart->get_cart()：获取购物车中所有商品的数组。
- in_array()：检查当前商品ID是否在 $targeted_ids 数组中。
- break：一旦找到任何一个目标商品，即可停止遍历，因为我们只需要知道是否存在即可。
条件显示自定义复选框
有了 is_targeted_product_in_cart() 辅助函数，我们就可以修改用于显示复选框的 WooCommerce 钩子，使其只在特定商品不在购物车中时才显示。
/**
* 在结账页面订单概览前添加自定义复选框
*/
function action_woocommerce_review_order_before_submit_conditional_checkbox() {
// 如果目标商品不在购物车中，则显示复选框
if ( ! is_targeted_product_in_cart() ) {
woocommerce_form_field( 'privacy_policy', array(
'type' => 'checkbox',
'class' => array( 'form-row privacy' ),
'label_class' => array( 'woocommerce-form__label woocommerce-form__label-for-checkbox checkbox' ),
'input_class' => array( 'woocommerce-form__input woocommerce-form__input-checkbox input-checkbox' ),
'required' => true,
'label' => '我已阅读并接受 隐私政策', // 请根据您的需求修改链接和文本
));
}
}
add_action( 'woocommerce_review_order_before_submit', 'action_woocommerce_review_order_before_submit_conditional_checkbox', 9 );代码解释：
- add_action( 'woocommerce_review_order_before_submit', ... , 9 )：这是一个 WooCommerce 钩子，允许您在结账页面订单概览（提交按钮之前）插入内容。优先级 9 确保它在其他默认内容之前显示。
- if ( ! is_targeted_product_in_cart() )：这是核心条件，只有当 is_targeted_product_in_cart() 返回 false（即目标商品不在购物车中）时，复选框才会被渲染。
- woocommerce_form_field()：WooCommerce 提供的函数，用于生成标准的表单字段。这里我们定义了一个类型为 checkbox 的字段，并设置了其标签、样式和 required 属性。
条件验证自定义复选框
当复选框被条件性地隐藏时，其验证逻辑也必须是条件性的。如果复选框没有显示，但系统仍然尝试验证它，就会导致用户无法完成订单。因此，我们必须确保只有在复选框显示时才执行验证。
/**
* 条件验证自定义复选框
*/
function action_woocommerce_checkout_process_conditional_validation() {
// 只有当目标商品不在购物车中时，才执行验证
if ( ! is_targeted_product_in_cart() ) {
// 如果复选框未被勾选（即 $_POST['privacy_policy'] 不存在）
if ( ! isset( $_POST['privacy_policy'] ) ) {
wc_add_notice( __( '请确认您已阅读并接受隐私政策', 'woocommerce' ), 'error' );
}
}
}
add_action( 'woocommerce_checkout_process', 'action_woocommerce_checkout_process_conditional_validation', 10, 0 );代码解释：
- add_action( 'woocommerce_checkout_process', ... , 10, 0 )：这个钩子在处理结账提交时触发，是执行自定义验证的理想位置。
- if ( ! is_targeted_product_in_cart() )：同样，验证逻辑只在目标商品不在购物车中（即复选框被显示）时才运行。
- ! isset( $_POST['privacy_policy'] )：检查用户是否勾选了复选框。如果未勾选，$_POST['privacy_policy'] 将不会被设置。
- wc_add_notice()：用于向用户显示错误消息。
保存复选框状态到订单（推荐）
虽然问题中没有明确要求，但通常情况下，您会希望将用户对复选框的选择保存到订单中，以便后续查询。这可以通过 woocommerce_checkout_create_order 钩子实现。
/**
* 将自定义复选框的状态保存到订单元数据
*
* @param WC_Order $order 订单对象。
* @param array $data 结账数据。
*/
function action_woocommerce_checkout_create_order_save_field( $order, $data ) {
// 如果复选框被勾选，则保存其值到订单元数据
if ( isset( $_POST['privacy_policy'] ) ) {
$order->update_meta_data( 'privacy_policy', sanitize_text_field( $_POST['privacy_policy'] ) );
}
}
add_action( 'woocommerce_checkout_create_order', 'action_woocommerce_checkout_create_order_save_field', 10, 2 );代码解释：
- add_action( 'woocommerce_checkout_create_order', ... , 10, 2 )：此钩子在创建订单时触发，并提供订单对象和结账数据，是保存自定义字段的理想时机。
- if ( isset( $_POST['privacy_policy'] ) )：检查复选框是否被勾选。
- $order->update_meta_data( 'privacy_policy', ... )：将复选框的值（通常是 '1' 或 'on'）保存为订单的元数据，键名为 privacy_policy。
- sanitize_text_field()：对用户输入进行安全清理，防止潜在的恶意代码。
代码集成与注意事项
代码放置位置： 将上述所有代码片段添加到您的 WordPress 主题的 functions.php 文件中，或者更推荐的方式是创建一个自定义插件来管理这些功能。使用自定义插件可以确保在主题更新时您的修改不会丢失。
修改目标商品ID： 请务必根据您的实际需求修改 is_targeted_product_in_cart() 函数中的 $targeted_ids 数组。您可以添加任意数量的商品ID。
调整复选框标签和链接： 在 action_woocommerce_review_order_before_submit_conditional_checkbox() 函数中，您可以修改 label 属性中的文本和 /privacy-policy 链接，以适应您的隐私政策或其他条款页面。
错误消息本地化： 在 action_woocommerce_checkout_process_conditional_validation() 函数中，__( '请确认您已阅读并接受隐私政策', 'woocommerce' ) 中的 'woocommerce' 是文本域。如果您在自定义插件中使用，可以将其替换为您的插件文本域，以便于翻译。
总结
通过本教程，您已经学会了如何利用 WooCommerce 的钩子和自定义 PHP 函数，实现结账页面复选框的动态显示、验证和数据保存。这种方法提高了结账流程的灵活性，使得您可以根据购物车中的特定商品，为用户提供更加定制化的体验。记住，始终在开发环境中测试您的代码，并在生产环境部署前进行充分验证。
