Woocommerce前后端条款勾选框数据同步异常问题咨询

问题原因 #

你遇到的两个异常（编辑页不显示选中状态、更新订单字段丢失）由3个代码问题导致：

1. WooCommerce后台复选框组件woocommerce_wp_checkbox默认的勾选判定规则不匹配：该组件默认只有传入的value等于cbvalue参数值（默认是yes）时才会显示选中，而你前台提交的勾选存储值是1，两者不一致导致编辑页无法回显选中状态
2. 后台保存逻辑未做提交判断：复选框未勾选时不会在POST请求中提交该字段，你直接执行更新操作会把原有值覆盖为空，导致字段丢失
3. 后台详情页的状态展示不友好：直接输出存储的数值1，运营人员无法直观识别含义

修正后的完整代码 #

替换你当前functions.php里的对应代码即可：

<?php 
add_action('woocommerce_before_order_notes', 'wps_add_select_checkout_field');
function wps_add_select_checkout_field( $checkout ) {
    woocommerce_form_field( 'rem_terms', array(
        'type'          => 'checkbox',
        'class'         => array('form-row mycheckbox'), 
        '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'         => '我同意<a href="/privacy-policy" target="_blank" rel="noopener">隐私政策</a>和<a target="_blank" rel="noopener" href="/liability-release-and-express-assumption-of-risk">责任免除条款</a>中描述的所有条款和条件',
    ));
    $checkout->get_value( 'rem_terms' );
}

add_action('woocommerce_checkout_update_order_meta', 'wps_select_checkout_field_update_order_meta');
add_action( 'woocommerce_checkout_process', 'bt_add_checkout_checkbox_warning' );
/**
 * 未勾选复选框时的下单提示
 */ 
function bt_add_checkout_checkbox_warning() {
    if ( !isset( $_POST['rem_terms'] ) ) {
        wc_add_notice( __( '请先同意我们的条款和条件再提交订单' ), 'error' );
    }
}

function wps_select_checkout_field_update_order_meta( $order_id ) {
    $terms_val = isset( $_POST['rem_terms'] ) ? 1 : 0;
    update_post_meta( $order_id, 'rem_terms', $terms_val );
}

add_action( 'woocommerce_admin_order_data_after_order_details', 'misha_editable_order_meta_general' );
function misha_editable_order_meta_general( $order ){  ?>
    <br class="clear" />
    <h4>条款确认</h4>
    <?php 
        $rem_terms = get_post_meta( $order->get_id(), 'rem_terms', true );
        $terms_text = $rem_terms ? '已同意' : '未同意';
    ?>
    <div class="address">
        <p><strong>客户是否同意REM隐私政策中的条款和条件：</strong><?php echo $terms_text; ?></p>
    </div>
    <div class="edit_address"><?php
        woocommerce_wp_checkbox( array(
            'id' => 'rem_terms',
            'label' => '客户同意条款和条件',
            'value' => $rem_terms,
            'cbvalue' => 1, // 与存储值匹配，用于判定是否选中
            'wrapper_class' => 'form-field-wide'
        ) );
    ?></div>
<?php }

add_action( 'woocommerce_process_shop_order_meta', 'save_new_fields' );
function save_new_fields( $ord_id ){
    // 未提交时赋值为0，避免覆盖原有值
    $terms_val = isset( $_POST['rem_terms'] ) ? 1 : 0;
    update_post_meta( $ord_id, 'rem_terms', $terms_val );
}

function example_custom_order_fields( $fields, $order ) {
    $new_fields = array();
    $rem_terms = get_post_meta( $order->get_id(), 'rem_terms', true );
    $new_fields['rem_terms'] = array( 
        'label' => '客户同意条款',
        'value' => $rem_terms ? '是' : '否'
    );
    return array_merge( $fields, $new_fields );
}
add_filter( 'wcdn_order_info_fields', 'example_custom_order_fields', 10, 2 );

优化说明 #

• 前后台提示文字已统一替换为中文，可根据业务需要自行调整
• 统一了前后台存储规则，勾选存储为1，未勾选存储为0，避免字段为空的异常
• 所有状态展示位置都将数值转换为了可读的文本，降低运营使用成本

内容的提问来源于stack exchange，提问作者Adam Hoidahl