引言：为什么需要条件显示复选框？
在 WooCommerce 商店运营中，我们可能需要根据购物车内商品的具体情况，在结账页面动态地显示或隐藏某些信息或交互元素。例如，如果购物车中包含特定商品（如数字产品、限制级商品），商家可能需要用户勾选额外的条款、隐私政策或年龄确认复选框。如果这些特定商品不存在，则对应的复选框也应随之隐藏，以避免不必要的界面元素，简化结账流程。本文将提供一套完整的解决方案，实现基于购物车商品ID的自定义复选框条件显示、验证及数据保存功能。
核心逻辑：判断购物车中是否存在特定商品
实现条件显示的关键在于准确判断购物车中是否存在我们预设的特定商品。我们将创建一个辅助函数来完成这一任务。
is_product_in_cart() 函数详解
这个函数负责遍历当前购物车中的所有商品，并检查它们的ID是否包含在预定义的目标商品ID列表中。如果找到任何一个匹配的商品，函数将返回 true，否则返回 false。
/**
* 检查购物车中是否存在特定商品ID
*
* @param array $targeted_ids 目标商品ID数组
* @return bool 如果购物车中存在任一目标商品，则返回 true，否则返回 false。
*/
function is_product_in_cart( $targeted_ids = array() ) {
// 默认目标商品ID，可根据需要修改或通过参数传入
if ( empty( $targeted_ids ) ) {
$targeted_ids = array( 32, 1234, 5678 ); // 在此处添加您希望检查的商品ID
}
// 标志，默认为购物车中不存在目标商品
$flag = false;
// 确保购物车对象不为空
if ( ! is_null( WC()->cart ) ) {
// 遍历购物车中的每个商品项
foreach ( WC()->cart->get_cart() as $cart_item ) {
// 检查当前购物车商品ID是否在目标ID列表中
if ( in_array( $cart_item['product_id'], $targeted_ids ) ) {
$flag = true; // 找到目标商品
break; // 找到后即可跳出循环
}
}
}
return $flag;
}使用说明：
- $targeted_ids 数组应包含您希望触发复选框隐藏（或显示）逻辑的所有商品ID。
- 您可以直接在函数内部修改 $targeted_ids 的默认值，或者在调用 is_product_in_cart() 函数时作为参数传入。
条件显示自定义复选框
现在，我们将利用 is_product_in_cart() 函数来控制自定义复选框在结账页面的显示。我们使用 woocommerce_review_order_before_submit 钩子在提交订单按钮之前添加复选框。
action_woocommerce_review_order_before_submit() 函数详解
此函数会在结账页面订单总览区域的提交按钮之前执行。通过调用 is_product_in_cart() 并判断其结果，我们决定是否渲染自定义的“隐私政策”复选框。
/**
* 根据购物车内容条件显示自定义复选框
*/
function action_woocommerce_review_order_before_submit() {
// 只有当购物车中不存在指定商品时才显示复选框
// 您也可以反转逻辑，当存在指定商品时显示，只需移除 ! 即可
if ( ! is_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', 9 );注意事项：
- 'required' => true 表示此复选框是必选的。
- 'label' 字段可以自定义复选框旁边的文本和链接。
- 钩子的优先级 9 确保它在大多数其他元素之前显示。
确保条件验证的正确性
仅仅条件显示复选框是不够的，我们还需要确保其验证逻辑也是条件性的。如果复选框没有显示，那么就不应该对其进行验证。
action_woocommerce_checkout_process() 函数详解
此函数在结账表单提交时触发验证。我们再次使用 is_product_in_cart() 来确保只有当复选框实际显示时，才会检查用户是否已勾选。
/**
* 根据购物车内容条件验证自定义复选框
*/
function action_woocommerce_checkout_process() {
// 只有当购物车中不存在指定商品时，才执行复选框的验证
if ( ! is_product_in_cart() ) {
// 如果复选框未被勾选
if ( ! isset( $_POST['privacy_policy'] ) ) {
wc_add_notice( __( '请阅读并接受隐私政策', 'woocommerce' ), 'error' );
}
}
}
add_action( 'woocommerce_checkout_process', 'action_woocommerce_checkout_process', 10, 0 );注意事项：
- wc_add_notice() 用于在结账页面显示错误消息。
- 钩子的优先级 10 是验证的常见优先级。
保存复选框状态到订单
为了记录用户是否勾选了自定义复选框，我们可以将其状态保存到 WooCommerce 订单的元数据中。
action_woocommerce_checkout_create_order() 函数详解
此函数在订单创建时触发，允许我们将自定义字段的值保存为订单的元数据。
/**
* 将自定义复选框的状态保存到订单元数据
*
* @param WC_Order $order 订单对象。
* @param array $data 提交的结账数据。
*/
function action_woocommerce_checkout_create_order( $order, $data ) {
// 检查复选框是否被勾选（因为只有勾选了才会存在于 $_POST 中）
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', 10, 2 );注意事项：
- sanitize_text_field() 用于清理输入数据，提高安全性。
- 保存的元数据可以在 WooCommerce 后台订单详情页中查看。
整体代码放置与最佳实践
将上述所有代码片段整合到您的 WordPress 网站中。推荐的放置位置是：
- 子主题的 functions.php 文件： 这是最常见且推荐的做法，可以确保在主题更新时您的自定义代码不会丢失。
- 自定义插件： 如果您有多个自定义功能，或者希望将此功能打包为可重用的模块，创建并激活一个自定义插件是更专业的选择。
修改目标商品ID： 在 is_product_in_cart() 函数中，找到 $targeted_ids = array( 32, 1234, 5678 ); 这一行，将 32, 1234, 5678 替换为您实际需要检查的商品ID。
自定义复选框标签： 在 action_woocommerce_review_order_before_submit() 函数中，修改 'label' 键对应的值，即可自定义复选框的文本内容和链接。
总结
通过上述步骤，您已经成功地在 WooCommerce 结账页面实现了一个基于购物车商品ID的条件显示、验证和保存的自定义复选框。这种方法不仅提升了结账流程的灵活性和用户体验，也确保了网站功能的健壮性和专业性。您可以根据实际业务需求，灵活调整目标商品ID、复选框文本以及显示/隐藏的逻辑，以满足更多定制化场景。
