修复WooCommerce自定义订单状态pre-ordered的支付日期重置问题

问题背景 #

所有产品均为预售，使用Bright预售插件与WPRuby的「Betaal later（稍后支付）」自定义支付插件，创建了自定义订单状态「Pre Ordered」，设置该支付方式的订单自动转为该状态。但客户使用该支付方式下单时，订单会错误将创建日期设为支付日期（实际未付款）。尝试通过woocommerce_order_status_changed钩子重置支付日期，但添加「pre-ordered」状态后出现严重错误，原有代码如下：

add_action( 'woocommerce_order_status_changed', 'reset_order_paid_date', 20, 4 );
function reset_order_paid_date( $order_id, $old_status, $new_status, $order ){
    if ( in_array( $old_status, array('on-hold', 'processing', 'completed', 'pending') ) && $new_status == 'pre-ordered') {
        $order->set_date_paid(null);
        $order->save();
    }
}

问题分析 #

原有代码存在两个核心问题：

1. 钩子触发范围过广，woocommerce_order_status_changed会监听所有订单状态变更，容易与其他插件的状态逻辑冲突
2. 仅通过状态切换判断，未绑定特定支付方式，可能误处理其他场景下的「pre-ordered」状态变更

修复方案 #

方案1：针对「pre-ordered」状态切换+支付方式判断 #

改用精准的状态切换钩子，仅在订单转为「pre-ordered」时触发，同时增加支付方式校验，避免误操作：

add_action( 'woocommerce_order_status_pre-ordered', 'reset_pre_order_paid_date', 10, 2 );
function reset_pre_order_paid_date( $order_id, $order ) {
    // 替换为Betaal later支付方式的实际slug（可通过订单详情或数据库_meta表查看）
    $target_payment_method = 'betaal_later';
    
    if ( $order->get_payment_method() === $target_payment_method ) {
        // 重置支付日期为null
        $order->set_date_paid( null );
        // 明确标记订单为未付款
        $order->set_paid( false );
        $order->save();
    }
}

方案2：订单创建时直接处理 #

如果支付插件在订单创建后自动设置状态，可在订单生成阶段直接处理，避免状态切换冲突：

add_action( 'woocommerce_checkout_order_processed', 'reset_betaal_later_paid_date_on_create', 20, 3 );
function reset_betaal_later_paid_date_on_create( $order_id, $posted_data, $order ) {
    $target_payment_method = 'betaal_later';
    
    if ( $order->get_payment_method() === $target_payment_method ) {
        $order->set_date_paid( null );
        $order->set_paid( false );
        // 若需自动设置为pre-ordered状态，可取消下方注释
        // $order->update_status( 'pre-ordered' );
        $order->save();
    }
}

关键注意事项 #

1. 确认支付方式slug：必须替换betaal_later为该支付方式实际的slug，可通过以下方式查看：
   • 查看订单详情页的「支付方式」字段，或在后台订单编辑页查看隐藏的_payment_method元值
   • 访问数据库wp_postmeta表，找到对应订单的_payment_method记录
2. 测试前备份：修改代码前请备份网站文件与数据库，避免出现不可恢复的错误
3. 调试错误：若仍有问题，开启WordPress调试模式（wp-config.php中设置WP_DEBUG=true），查看具体错误日志定位问题

内容的提问来源于stack exchange，提问作者Joost van Ginneken