禁用含特定商品标签的WooCommerce订单完成邮件问题排查

你的代码失效主要有两个核心问题：

• 原代码用wc_get_product_term_ids拿到的是商品标签的ID，但你定义的$disabled_tags是标签的slug，类型不匹配导致array_intersect永远找不到匹配项。
• 没有判断订单状态是否是从「处理中」变为「已完成」，可能会误拦截其他场景触发的完成邮件。

以下是修正后的代码，完全匹配你的需求：

add_filter( 'woocommerce_email_recipient_customer_completed_order', 'product_tag_avoid_completed_email_notification', 10, 2 );

function product_tag_avoid_completed_email_notification( $recipient, $order ) {
    // 后台操作时不拦截邮件
    if ( is_admin() ) {
        return $recipient;
    }

    // 只处理从processing状态变为completed的订单
    $previous_status = $order->get_meta('_previous_status');
    if ( $previous_status !== 'processing' || $order->get_status() !== 'completed' ) {
        return $recipient;
    }

    // 指定要拦截的商品标签slug
    $disabled_tags = array( 'special-promo', 'regular' );

    // 遍历订单商品
    foreach ( $order->get_items() as $item ) {
        $product = $item->get_product();
        if ( !$product ) continue;

        // 获取商品的父ID（变体商品取父商品）
        $product_id = $product->is_type('variation') ? $product->get_parent_id() : $product->get_id();
        
        // 获取商品的标签slug数组
        $product_tags = get_the_terms( $product_id, 'product_tag' );
        if ( !$product_tags || is_wp_error( $product_tags ) ) continue;

        $tag_slugs = wp_list_pluck( $product_tags, 'slug' );

        // 检查是否存在禁用标签
        if ( array_intersect( $disabled_tags, $tag_slugs ) ) {
            return ''; // 找到匹配标签，返回空收件人以阻止邮件发送
        }
    }
    
    return $recipient;
}

关键改动说明 #

• 改用get_the_terms获取标签对象后，通过wp_list_pluck提取slug，确保和你定义的$disabled_tags类型一致，解决匹配失效问题。
• 新增订单状态变化判断：通过_previous_status元数据确认订单是从processing转为completed，精准匹配你要求的触发条件。
• 增加了$product和标签获取的错误判断，避免因无效商品或标签导致的逻辑中断。

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