适配WooCommerce HPOS的后台自定义订单元数据更新问题求助

原代码的核心问题 #

1. PHP函数参数定义违反语法规范，钩子woocommerce_process_shop_order_meta的传入参数是订单ID，原函数的参数写法完全错误
2. 变量逻辑混乱：错误覆盖$order对象、使用未定义的变量（$post_id、$field_name、$manual_order_option）
3. 未正确调用订单元数据更新方法，还注释了关键的save()步骤，导致修改无法持久化
4. HTML复选框的checked状态判断错误，误用站点选项get_option()获取值，而非当前订单的元数据

修正后的完整代码 #

PHP处理逻辑（适配HPOS）

function update_manual_order( $order_id ) {
    // 获取订单对象（HPOS下wc_get_order依然兼容）
    $order = wc_get_order( $order_id );
    if ( ! $order ) return;

    // 获取提交的复选框值，未勾选时$_POST中不会存在该字段，所以默认设为0
    $manual_order_value = isset( $_POST['manual_order'] ) ? '1' : '0';

    // 更新订单元数据
    $order->update_meta_data( 'manual_order', $manual_order_value );
    // 保存订单（必须调用，否则修改不会生效）
    $order->save();
}
// 钩子优先级设为20即可，无需过高
add_action( 'woocommerce_process_shop_order_meta', 'update_manual_order', 20 );

复选框HTML代码（订单编辑页显示）

<?php
// 获取当前订单的manual_order元数据，默认值设为0
$manual_order_status = get_post_meta( $post->ID, 'manual_order', true );
$manual_order_status = empty( $manual_order_status ) ? '0' : $manual_order_status;
?>
<input type="checkbox" id="toggle" class="checkbox" name="manual_order" value="1" <?php checked( '1', $manual_order_status ); ?> />
<label for="toggle" class="switcher"></label>

关键说明 #

• HPOS启用后，订单不再作为post类型存储，但wc_get_order()和update_meta_data()方法依然有效，无需额外适配
• 复选框提交时，未勾选的情况下$_POST['manual_order']不会存在，所以用isset()判断状态
• 必须调用$order->save()才能将元数据的修改写入HPOS存储

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