WooCommerce自定义订单状态仅给子订单发邮件通知的问题

你的代码可能存在的3个问题 #

1. 钩子未匹配自定义状态的邮件
   自定义订单状态的邮件通知有独立的过滤钩子，而非复用默认状态（如processing）的钩子。如果你之前的代码用了默认状态的钩子，自然对自定义状态的邮件无效。比如自定义状态readytocollect对应的收件人钩子是woocommerce_email_recipient_customer_readytocollect_order，shipped则是woocommerce_email_recipient_customer_shipped_order。

2. 父订单判断逻辑颠倒/错误
   多数多供应商插件中，父订单的parent_id为0，子订单的parent_id指向父订单ID。如果你的代码是通过$order->get_parent_id() == 0来判断父订单并阻止邮件，这会逻辑颠倒——正确的判断应该是检查订单是否存在子订单，或者依赖多供应商插件的专属标识（比如子订单会带有供应商ID元字段，父订单没有）。

3. 未校验订单对象有效性
   如果钩子触发时传入的$order不是合法的WC_Order对象，后续的判断逻辑会直接失效，导致过滤不生效。

实现仅子订单发送自定义状态邮件的代码 #

以下代码适配多数多供应商插件（比如WC Vendors、Dokan），核心逻辑是判断订单是否为父订单（通过子订单数量判断），如果是则清空邮件收件人：

// 针对readytocollect状态，阻止父订单发邮件
add_filter( 'woocommerce_email_recipient_customer_readytocollect_order', 'block_parent_order_custom_status_emails', 10, 2 );
// 针对shipped状态，阻止父订单发邮件
add_filter( 'woocommerce_email_recipient_customer_shipped_order', 'block_parent_order_custom_status_emails', 10, 2 );

function block_parent_order_custom_status_emails( $recipient, $order ) {
    // 确保传入的是合法的WC_Order对象
    if ( ! is_a( $order, 'WC_Order' ) ) {
        return $recipient;
    }

    // 判断是否为父订单：检查当前订单是否存在子订单
    $has_child_orders = count( $order->get_children() ) > 0;

    // 如果是父订单，清空收件人（阻止发送）
    if ( $has_child_orders ) {
        $recipient = '';
    }

    return $recipient;
}

适配特定多供应商插件的调整 #

如果通过子订单数量判断不准确，可以替换为插件专属的判断逻辑：

• WC Vendors：子订单会带有_vendor_parent_order元字段，父订单没有。可以替换判断逻辑为：

  $is_parent_order = get_post_meta( $order->get_id(), '_vendor_parent_order', true );
  if ( empty( $is_parent_order ) ) { // 父订单没有该字段，子订单会存父订单ID
      $recipient = '';
  }
  

• Dokan：父订单的_dokan_is_parent_order元字段为yes，可以替换为：

  $is_parent_order = get_post_meta( $order->get_id(), '_dokan_is_parent_order', true );
  if ( $is_parent_order === 'yes' ) {
      $recipient = '';
  }
  

验证步骤 #

1. 确认自定义状态邮件的钩子名称：可以通过开启WP_DEBUG，或者在钩子中添加error_log( current_filter() );来输出当前触发的钩子名，确保代码中使用的钩子完全匹配。
2. 测试父子订单状态变更：修改父订单状态，检查是否不再发送邮件；修改子订单状态，确认邮件正常发送给买家。

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