WooCommerce后台产品编辑自定义复选框字段无法保存问题

嘿，我来帮你搞定这个复选框保存的问题！你的代码能正常显示复选框，但保存逻辑确实存在两个关键问题，和你怀疑的$post->ID有一定关系，还有未勾选时的处理缺失：

问题分析 #

1. 产品ID获取不可靠：在woocommerce_process_product_meta钩子中，依赖global $post获取产品ID并不稳妥——某些后台场景（比如批量编辑、快速编辑）下，$post可能指向的不是当前编辑的产品，导致保存到错误的ID或者根本没保存。
2. 未处理取消勾选的情况：当用户取消复选框时，$_POST['is_gift']不会出现在请求里，你的代码只处理了勾选的情况，没处理取消的场景，导致之前勾选的元数据不会被更新或删除，看起来像是没保存。

修复方案 #

方案1：修复旧钩子的逻辑 #

如果想继续用woocommerce_process_product_meta钩子，可以调整成下面的代码，确保正确获取产品ID并处理取消勾选的情况：

add_action( 'woocommerce_product_options_general_product_data', 'wc_custom_add_custom_fields' );
function wc_custom_add_custom_fields() {
    global $post;

    woocommerce_wp_checkbox(array(
        'id' => 'is_gift',
        'label' => __('Gift', 'woocommerce' ),
        'description' => __( 'Add gift label', 'woocommerce' ),
        'value' => get_post_meta($post->ID, 'is_gift', true)
    ));
}

add_action( 'woocommerce_process_product_meta', 'wc_custom_save_custom_fields' );
function wc_custom_save_custom_fields() {
    // 直接从POST请求中获取产品ID，比global $post更可靠
    $product_id = isset( $_POST['post_ID'] ) ? absint( $_POST['post_ID'] ) : 0;

    if ( $product_id ) {
        if ( isset( $_POST['is_gift'] ) ) {
            // 勾选时保存值
            update_post_meta( $product_id, 'is_gift', esc_attr( $_POST['is_gift'] ) );
        } else {
            // 取消勾选时删除元数据（或者设为'no'，根据你的需求选）
            delete_post_meta( $product_id, 'is_gift' );
            // 可选：update_post_meta( $product_id, 'is_gift', 'no' );
        }
    }
}

方案2：使用WooCommerce推荐的新钩子 #

WooCommerce现在更推荐使用woocommerce_admin_process_product_object钩子，它会直接传入产品对象，不需要手动处理ID，逻辑更简洁安全：

add_action( 'woocommerce_product_options_general_product_data', 'wc_custom_add_custom_fields' );
function wc_custom_add_custom_fields() {
    global $post;

    woocommerce_wp_checkbox(array(
        'id' => 'is_gift',
        'label' => __('Gift', 'woocommerce' ),
        'description' => __( 'Add gift label', 'woocommerce' ),
        'value' => get_post_meta($post->ID, 'is_gift', true)
    ));
}

// 使用新钩子，直接操作Product对象
add_action( 'woocommerce_admin_process_product_object', 'wc_custom_save_custom_fields' );
function wc_custom_save_custom_fields( $product ) {
    // 判断复选框状态，勾选设为'yes'，否则设为'no'
    $is_gift = isset( $_POST['is_gift'] ) ? 'yes' : 'no';
    // 更新产品元数据
    $product->update_meta_data( 'is_gift', $is_gift );
    // 保存元数据
    $product->save_meta_data();
}

两种方案都能解决你的问题，方案2更符合WooCommerce的现代开发规范，建议优先使用。

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