为WooCommerce订阅续订订单设置配送方式

原代码失效原因 #

原代码无法实现需求主要是这几个问题：

• 未定义$renewal_order_id变量，完全没用到钩子传入的$order_id参数
• 选错了钩子：通用的woocommerce_new_order不适合订阅续订场景，Subscriptions有专属的精准触发钩子
• 仅更新_shipping_method元数据不完整：WooCommerce存储配送方式需要的是ID和实例ID，不是显示名称

修正后的可用代码 #

// 订阅续订订单专属钩子，只处理续订订单创建场景
add_action('woocommerce_subscription_renewal_order_created', 'sync_parent_shipping_to_renewal', 10, 2);

function sync_parent_shipping_to_renewal($renewal_order, $subscription) {
    // 从订阅对象直接获取父订单ID
    $parent_order_id = $subscription->get_parent_id();
    if (empty($parent_order_id)) return;

    $parent_order = wc_get_order($parent_order_id);
    // 校验父订单有效性及是否有配送方式
    if (!$parent_order || !$parent_order->get_shipping_method()) return;

    // 获取父订单的配送方式详情
    $parent_shipping = reset($parent_order->get_shipping_methods());
    if (!$parent_shipping) return;

    // 给续订订单设置匹配的配送方式ID和实例ID
    $renewal_order->set_shipping_method_id($parent_shipping->get_method_id());
    $renewal_order->set_shipping_method_instance_id($parent_shipping->get_instance_id());
    
    $renewal_order->save();
}

代码说明 #

• 用woocommerce_subscription_renewal_order_created钩子：该钩子在续订订单创建后触发，直接传入续订订单和订阅对象，无需额外查询关联关系
• 通过订阅对象拿父订单ID，避免错误关联
• 提取父订单配送方式的核心ID参数（method_id和instance_id），这是WooCommerce识别配送方式的关键数据
• 用WooCommerce内置的set_*方法设置数据，而非直接修改元数据，确保数据结构符合官方规范

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