首页 > 文章 > php教程

WooCommerce订单商品邮件触发设置优化

时间：2025-11-19 22:59:34 199浏览收藏

IT行业相对于一般传统行业，发展更新速度更快，一旦停止了学习，很快就会被行业所淘汰。所以我们需要踏踏实实的不断学习，精进自己的技术，尤其是初学者。今天golang学习网给大家整理了《优化WooCommerce订单商品邮件触发条件》，聊聊，我们一起来看看吧！

优化WooCommerce订单特定商品条件邮件触发机制

本文旨在解决WooCommerce中根据订单内特定商品ID及其元数据触发自定义邮件的常见问题。通过分析原始代码的逻辑缺陷，我们提出一种健壮的解决方案，确保即使订单中包含其他商品，也能准确识别目标商品并依据其元数据（如`meno`字段）发送相应的自定义邮件，从而避免邮件触发失败或错误发送的问题。

背景与问题分析

在WooCommerce店铺运营中，根据订单内容触发特定的自定义邮件是一种常见的需求。例如，当订单中包含某个特殊商品（如ID为2805的产品）时，我们可能需要根据该商品的特定元数据（如meno字段）是否为空来发送两种不同的邮件。

然而，在实际开发中，开发者常会遇到一个问题：当订单中仅包含目标商品时，邮件触发功能正常；但一旦订单中同时包含目标商品和其他商品，自定义邮件就无法触发。这通常是由于代码在遍历订单商品时，对关键变量的赋值和判断逻辑存在误区。

我们来看一个典型的错误代码模式：

add_action('woocommerce_order_status_completed', 'send_a_custom_email', 20, 2 );

function send_a_custom_email( $order_id, $order ) {
    global $woocommerce;
    $order = new WC_Order( $order_id );
    $mailer = $woocommerce->mailer();
    $product_ids = array( ); // 用于存储符合条件的商品ID
    $customer_email = $order->get_billing_email();
    $customer_name = $order->get_billing_first_name();

    // 遍历订单中的所有商品
    foreach ( $order->get_items() as $item ) {
        $meta_data  = $item->get_meta('meno'); // 获取 'meno' 元数据
        $venovanie = $item->get_meta('venovanie'); // 获取 'venovanie' 元数据
        $product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id(); // 获取当前商品ID

        if( empty($meta_data) ) {
            $product_ids[] = $item->get_variation_id() > 0 ? $item->get_variation_id() : $item->get_product_id();
        }
    } 

    // 问题所在：这里的 $product_id 仅代表循环中最后一个商品的ID
    if ( ! empty($product_ids) && $product_id == 2805 ) {
        // email 1
    } else if ( empty($product_ids) && $product_id == 2805 ) {
        // email 2
    }
}

代码缺陷分析：

上述代码的核心问题在于 $product_id 变量的使用。在 foreach 循环内部，$product_id 会被不断地赋值为当前遍历到的商品ID。当循环结束后，$product_id 最终会保留订单中最后一个商品的ID。

这意味着，在循环后的 if 和 else if 条件判断中，$product_id == 2805 实际上是在检查订单的最后一个商品是否为ID 2805。如果订单中包含多个商品，且商品ID 2805不是最后一个，或者根本没有商品ID 2805，那么即使订单中确实存在商品ID 2805并符合其他条件，邮件也无法正确触发，因为这个判断条件已经失效。

为了正确实现需求，我们需要确保：

准确地识别订单中是否存在目标商品（ID 2805）。
如果存在，则针对该特定商品的元数据进行判断，而不是基于循环中最后一个商品的数据。

解决方案：精准识别与条件判断

要解决上述问题，我们需要调整逻辑，在遍历订单商品时，不仅要检查是否存在目标商品，还要将其作为独立的对象进行处理，以便后续访问其特定的元数据。

以下是优化后的代码实现：

<?php

/**
 * 根据订单中特定商品的ID及其元数据触发自定义邮件。
 *
 * 当订单状态变为“已完成”时，此函数会被调用。
 * 它会检查订单中是否存在ID为2805的商品，并根据该商品的'meno'元数据
 * 是否为空来触发不同的自定义邮件。
 *
 * @param int      $order_id 订单ID。
 * @param WC_Order $order    WC_Order 对象。
 */
add_action('woocommerce_order_status_completed', 'send_custom_email_for_specific_product', 20, 2 );

function send_custom_email_for_specific_product( $order_id, $order ) {
    // 确保我们有一个有效的WC_Order对象
    if ( ! is_a( $order, 'WC_Order' ) ) {
        $order = wc_get_order( $order_id );
    }

    // 如果订单不存在，则直接返回
    if ( ! $order ) {
        error_log("订单 #{$order_id} 未找到，无法发送自定义邮件。");
        return;
    }

    $target_product_id = 2805; // 我们要检查的特定商品ID
    $found_target_product_item = null; // 用于存储找到的目标商品项目

    // 遍历订单中的所有商品，查找目标商品
    foreach ( $order->get_items() as $item_id => $item ) {
        // 获取当前订单项的商品ID（考虑变体）
        $product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id();

        // 如果找到了目标商品
        if ( $product_id == $target_product_id ) {
            $found_target_product_item = $item; // 存储该商品项目
            break; // 找到后立即退出循环，提高效率
        }
    }

    // 如果订单中存在目标商品 (ID 2805)
    if ( $found_target_product_item ) {
        // 获取该特定商品项目的 'meno' 元数据
        $meno_meta_data = $found_target_product_item->get_meta('meno');
        // 获取该特定商品项目的 'venovanie' 元数据 (如果需要)
        $venovanie_meta_data = $found_target_product_item->get_meta('venovanie');

        $mailer = WC()->mailer(); // 获取WooCommerce邮件发送器实例

        // 根据 'meno' 元数据是否为空来触发不同的邮件
        if ( empty($meno_meta_data) ) {
            // 触发邮件 1 的逻辑
            // 示例：
            // $subject = '订单 #'.$order_id.' - 特定商品空元数据通知';
            // $message = '<p>尊敬的客户，您的订单 #'.$order_id.' 中包含特殊商品，且其“meno”元数据为空。我们将为您提供相应服务。</p>';
            // $mailer->send($order->get_billing_email(), $subject, $message);
            error_log("订单 #{$order_id}：目标商品 {$target_product_id} 的 'meno' 元数据为空，触发邮件 1。");
            // 在此处添加您的邮件 1 发送代码，例如调用自定义邮件类或使用 $mailer->send()
            // 例如：WC()->mailer()->get_emails()['WC_Email_Custom_Email_1']->trigger( $order_id );

        } else {
            // 触发邮件 2 的逻辑
            // 示例：
            // $subject = '订单 #'.$order_id.' - 特定商品非空元数据通知';
            // $message = '<p>尊敬的客户，您的订单 #'.$order_id.' 中包含特殊商品，且其“meno”元数据为：'.$meno_meta_data.'。我们将为您提供相应服务。</p>';
            // $mailer->send($order->get_billing_email(), $subject, $message);
            error_log("订单 #{$order_id}：目标商品 {$target_product_id} 的 'meno' 元数据为 '{$meno_meta_data}'，触发邮件 2。");
            // 在此处添加您的邮件 2 发送代码
            // 例如：WC()->mailer()->get_emails()['WC_Email_Custom_Email_2']->trigger( $order_id );
        }
    } else {
        // 订单中未找到目标商品，不触发任何自定义邮件
        error_log("订单 #{$order_id} 中未找到目标商品 {$target_product_id}。未触发自定义邮件。");
    }
}

代码详解

add_action('woocommerce_order_status_completed', ...):
- 这个钩子确保我们的函数在订单状态变为“已完成”时执行。这是触发售后邮件的常见时机。
- 优先级 20 确保它在其他默认的订单处理之后运行，2 表示函数接收两个参数：$order_id 和 $order 对象。
$target_product_id = 2805;:
- 明确定义了我们关注的特定商品ID，方便修改和维护。
$found_target_product_item = null;:
- 引入一个新变量，用于在遍历订单项时，存储找到的那个特定商品（WC_Order_Item_Product 对象）。初始化为 null，表示尚未找到。
遍历订单项并查找目标商品:
```
foreach ( $order->get_items() as $item_id => $item ) {
    $product_id = $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id();
    if ( $product_id == $target_product_id ) {
        $found_target_product_item = $item;
        break; // 找到后立即停止循环
    }
}
```
- 这段代码遍历订单中的每一个商品项。
- $item->get_variation_id() ? $item->get_variation_id() : $item->get_product_id() 用于获取商品的正确ID，无论是简单商品还是变体商品。
- 一旦找到与 $target_product_id 匹配的商品，就将其完整的 WC_Order_Item_Product 对象赋值给 $found_target_product_item，并使用 break 语句立即退出循环。这样可以避免不必要的遍历，提高效率。
基于目标商品进行条件判断:
```
if ( $found_target_product_item ) {
    $meno_meta_data = $found_target_product_item->get_meta('meno');
    // ... 邮件触发逻辑
} else {
    // ... 未找到目标商品的逻辑
}
```
- 在循环结束后，我们检查 $found_target_product_item 是否为 null。如果不是 null，说明订单中包含了目标商品。
- 此时，我们可以安全地通过 $found_target_product_item->get_meta('meno') 来获取该特定商品的 meno 元数据，从而进行准确的条件判断。
- 根据 meno_meta_data 是否为空，触发不同的邮件发送逻辑（邮件1或邮件2）。
- 如果 $found_target_product_item 仍然是 null，表示订单中没有目标商品，则不触发任何自定义邮件。
邮件发送占位符:
- 代码中使用了 error_log() 作为邮件触发的占位符，在实际应用中，您需要替换为真正的邮件发送逻辑。这可能包括：
  - 调用 WooCommerce 现有的邮件类：WC()->mailer()->get_emails()['WC_Email_Your_Custom_Email_Class_ID']->trigger( $order_id );
  - 使用 WC()->mailer()->send() 方法发送通用邮件。
  - 或者您自定义的邮件发送函数。

注意事项与最佳实践

代码位置: 将此代码放置在您主题的 functions.php 文件中，或者更推荐的方式是创建一个自定义插件。
错误日志: 在开发和调试阶段，error_log() 是一个非常有用的工具，可以帮助您跟踪代码执行情况。在生产环境中，可以考虑将其替换为更完善的日志记录系统。
邮件内容定制: 示例代码中的邮件发送逻辑是占位符。在实际应用中，您需要根据业务需求，创建完整的邮件主题、内容和收件人信息。
性能考量: 对于非常大的订单（包含数百个商品项），虽然 break 语句可以优化性能，但如果您的逻辑变得更复杂，可能需要进一步考虑数据库查询优化。
元数据键名: 确保 get_meta('meno') 中的 meno 是您商品元数据的正确键名。
兼容性: 确保您的代码与当前 WooCommerce 版本兼容。WC_Order 和 WC_Order_Item_Product 类的方法在不同版本间可能略有差异，但上述基本操作在大多数现代 WooCommerce 版本中是稳定的。

总结

通过引入一个中间变量来存储找到的特定商品项，并基于该商品项的元数据进行条件判断，我们成功解决了WooCommerce中自定义邮件触发逻辑的常见陷阱。这种方法确保了即使订单中包含多个商品，也能精准地识别目标商品并根据其特有属性触发正确的业务流程。遵循这种结构，您的WooCommerce自定义功能将更加健壮和可靠。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~