如何基于不同配送方式修改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
相关产品推荐
相关产品推荐

