You need to enable JavaScript to run this app. 如何基于不同配送方式修改WooCommerce自定义订单状态
优惠活动
大模型
产品
解决方案
定价
更多

如何基于不同配送方式修改WooCommerce自定义订单状态

WooCommerce 多配送方式对应自动分配订单状态实现

基础功能现状

目前已跑通基于 woocommerce_thankyou 钩子的状态自动更新逻辑:当用户选择自提配送方式时,系统会自动把订单状态切换为自定义状态 awaiting-pickup,原有可用代码如下:

add_action( 'woocommerce_thankyou', 'shipping_method_update_order_status', 10, 1 );
function shipping_method_update_order_status( $order_id ) {
    if ( ! $order_id ) return;

    $search = 'local_pickup'; // 配送方式ID中需检索的目标字符串

    // 获取WC_Order对象实例
    $order = wc_get_order( $order_id );

    // 获取WC_Order_Item_Shipping对象数据
    foreach($order->get_shipping_methods() as $shipping_item ){
        // 当使用「自提」配送方式时,将订单状态修改为「awaiting-pickup」
        if( strpos( $shipping_item->get_method_title(), $search ) !== false ){
            $order->update_status('awaiting-pickup');
            $order->save();
            break;
        }
    }
}

扩展需求

需要在现有逻辑上补充其他配送方式的状态规则,适配配送ID的生成规则:

  • 所有配送实例的ID结构为「方法类型:数字序号」,每次新增配送区域时,系统会自动在方法类型后追加递增的数字(比如 local_pickup:2、flat_rate:6、free_shipping:13 这类形式),不需要硬编码匹配完整ID
  • 完整匹配逻辑要求:
    • 如果配送方式包含 local_pickup 字符串,更新订单状态为 awaiting-pickup
    • 如果配送方式包含 flat_rate 或 free_shipping 字符串,更新订单状态为 awaiting-delivery

提示:原有代码存在匹配失效的bug:代码中写的匹配目标字符串是方法类型的英文标识 local_pickup,但实际用 get_method_title() 获取的是前台面向用户展示的配送名称,二者根本无法匹配。同时前台展示的配送名称是可由商家随时修改的可变内容,哪怕匹配逻辑写对了,后续调整个文案也会导致规则失效。更稳妥的匹配方式是读取配送方式的固定方法ID,而非可变的展示标题。

最终优化实现代码

add_action( 'woocommerce_thankyou', 'shipping_method_update_order_status', 10, 1 );
function shipping_method_update_order_status( $order_id ) {
    if ( ! $order_id ) return;

    // 获取订单实体对象
    $order = wc_get_order( $order_id );

    // 遍历订单关联的配送条目
    foreach ( $order->get_shipping_methods() as $shipping_item ) {
        // 获取配送方式的基础类型ID(不带后缀数字序号)
        $shipping_type = $shipping_item->get_method_id();

        // 匹配自提类型
        if ( strpos( $shipping_type, 'local_pickup' ) !== false ) {
            $order->update_status( 'awaiting-pickup' );
            break;
        }
        // 匹配固定运费、免运费类型
        elseif ( 
            strpos( $shipping_type, 'flat_rate' ) !== false 
            || strpos( $shipping_type, 'free_shipping' ) !== false 
        ) {
            $order->update_status( 'awaiting-delivery' );
            break;
        }
    }

    // 保存订单变更
    $order->save();
}

配置注意事项

  • 代码中使用 get_method_id() 取固定类型值做匹配,不会因为商家调整配送的前台展示名称而失效
  • 只匹配方法类型的基础字符串,可自动覆盖同类型下所有带不同数字后缀的配送实例,无需每次新增配送区域时修改代码
  • 自定义的 awaiting-pickup、awaiting-delivery 状态需要提前在WooCommerce的订单状态配置中完成注册,否则系统无法识别对应状态参数

内容的提问来源于stack exchange,提问作者beerismysavior

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 07:24:04