本教程详细阐述了在WooCommerce中，如何在客户完成结账后发送自定义或内置的特定邮件通知。文章涵盖了代码的添加位置（`functions.php`或自定义插件）、`woocommerce_thankyou`钩子的使用、如何根据支付方式进行条件判断，并提供了两种邮件发送方案：使用`wp_mail`发送自定义内容邮件，以及如何手动触发WooCommerce内置的特定订单状态邮件（如“待处理订单”邮件），旨在帮助开发者实现灵活的邮件通知功能。
前言：WooCommerce结账后邮件通知的重要性
在WooCommerce商店中，标准的订单通知邮件已经能够满足大部分需求。然而，在某些特定场景下，我们可能需要更精细化的邮件通知机制。例如，当客户使用特定的支付方式完成结账后，我们可能需要发送一封额外的自定义邮件，或者在订单进入“待处理”状态时，除了系统默认邮件外，还需要进行额外的提醒。本教程将指导您如何利用WooCommerce的钩子系统，在结账完成后灵活地发送自定义或内置的邮件。
代码添加位置选择
在WooCommerce中添加自定义代码，通常有两种推荐的方式：
主题的 functions.php 文件：这是最直接简单的方式，适用于对代码量要求不高，且代码逻辑与当前主题紧密相关的情况。只需将代码添加到您当前活动主题的 functions.php 文件末尾即可。
优点： 快速实现，无需创建额外文件。缺点： 更换主题时代码会失效；主题更新时可能会被覆盖；不利于代码的模块化管理。最佳实践： 如果使用此方法，强烈建议使用子主题，以避免主题更新时代码丢失。创建自定义插件：对于更复杂、需要长期维护或希望在不同主题间复用的代码，创建自定义插件是最佳选择。
优点： 代码独立于主题，更换主题不受影响；易于管理和更新；代码结构清晰，便于团队协作。缺点： 需要创建插件文件和基本的插件结构。最佳实践： 推荐所有非主题特有的功能都通过自定义插件实现。无论选择哪种方式，核心代码逻辑是相同的。本教程将以在 functions.php 中添加代码为例进行说明，但请记住，将其封装在自定义插件中是更专业的做法。
核心实现：利用WooCommerce钩子发送邮件
WooCommerce提供了丰富的动作钩子（Action Hooks），允许我们在特定事件发生时执行自定义函数。对于结账完成后的操作，woocommerce_thankyou 是一个非常常用的钩子。
理解 woocommerce_thankyou 钩子
woocommerce_thankyou 钩子在客户完成订单并跳转到“感谢页面”（Thank You Page）时触发。它接收一个参数，即订单ID。通过这个订单ID，我们可以获取到完整的订单对象，进而获取订单的详细信息，包括支付方式、订单状态、客户信息等。
add_action( 'woocommerce_thankyou', 'your_custom_email_function_name', 10, 1 );登录后复制
其中，your_custom_email_function_name 是您自定义的函数名，10 是优先级，1 表示您的函数接受一个参数（订单ID）。
通义灵码 阿里云出品的一款基于通义大模型的智能编码辅助工具，提供代码智能生成、研发智能问答能力
31 查看详情 
方案一：发送自定义邮件（使用 wp_mail）
此方案适用于发送完全自定义内容的邮件，而不是WooCommerce内置的邮件模板。
<?phpfunction send_custom_email_after_checkout( $order_id ) { // 获取订单对象 $order = wc_get_order( $order_id ); // 检查订单是否存在且有效 if ( ! $order ) { return; } // 获取订单的支付方式 $payment_method = $order->get_payment_method(); // 假设我们只针对支付方式 "A"（例如 'cod' - 货到付款）发送邮件 if ( 'cod' === $payment_method ) { // 将 'cod' 替换为您要匹配的支付方式ID // 获取当前用户的邮箱（或从订单中获取客户邮箱） // 如果需要发送给下单用户，从订单获取更准确 $to = $order->get_billing_email(); // 邮件主题 $subject = '您的订单已提交 - 特别通知'; // 邮件内容 // 注意：HTML内容需要设置headers $body = ' <html> <head> <title>您的订单通知</title> </head> <body> <p>尊敬的客户，</p> <p>感谢您使用支付方式A完成了订单 <strong>#' . $order_id . '</strong>。</p> <p>您的订单详情：</p> <ul> <li>订单号: #' . $order->get_order_number() . '</li> <li>总金额: ' . $order->get_formatted_order_total() . '</li> <li>支付方式: ' . $order->get_payment_method_title() . '</li> </ul> <p>我们将尽快处理您的订单。</p> <p>此致，<br>您的商店名称</p> </body> </html> '; // 邮件头部信息，指定内容类型为HTML和发件人 $headers = array( 'Content-Type: text/html; charset=UTF-8', 'From: 您的商店名称 <noreply@yourdomain.com>' // 替换为您的发件人邮箱 ); // 使用 WordPress 的 wp_mail 函数发送邮件 wp_mail( $to, $subject, $body, $headers ); }}add_action( 'woocommerce_thankyou', 'send_custom_email_after_checkout', 10, 1 );?>登录后复制代码解析：
send_custom_email_after_checkout( $order_id )： 定义一个函数，接收订单ID作为参数。$order = wc_get_order( $order_id );： 通过订单ID获取 WC_Order 对象。这是操作订单的关键。$payment_method = $order->get_payment_method();： 获取订单使用的支付方式的ID。您可以通过查看WooCommerce设置或实际订单的支付方式来找到对应的ID（例如，货到付款是cod，银行转账是bacs）。if ( 'cod' === $payment_method )： 这是一个条件判断，确保只有当订单使用特定支付方式（这里是cod）时才发送邮件。您可以根据自己的需求修改此条件。$to = $order->get_billing_email();： 从订单对象中获取客户的账单邮箱地址作为收件人。$subject 和 $body： 定义邮件的主题和内容。邮件内容可以是纯文本，也可以是HTML格式。$headers： 定义邮件头部信息。Content-Type: text/html; charset=UTF-8 告知邮件客户端邮件内容是HTML格式。From: 指定发件人名称和邮箱。wp_mail( $to, $subject, $body, $headers );： WordPress内置的邮件发送函数，用于发送邮件。方案二：触发WooCommerce内置的特定邮件（如 WC_Email_Customer_On_Hold_Order）
如果您的目标是发送WooCommerce已经存在的特定订单状态邮件（例如，当订单进入“待处理”状态时发送给客户的邮件），通常有以下两种方式：
通过改变订单状态触发：这是最常见且推荐的方式。WooCommerce的邮件系统是与订单状态紧密绑定的。当订单状态从一个值变为另一个值时，如果WooCommerce配置了对应的邮件通知，它会自动发送。例如，如果订单状态变为“on-hold”，WC_Email_Customer_On_Hold_Order 邮件就会被发送。
<?phpfunction trigger_on_hold_email_after_checkout( $order_id ) { $order = wc_get_order( $order_id ); if ( ! $order ) { return; } $payment_method = $order->get_payment_method(); // 假设我们只针对支付方式 "A" 且当前订单状态不是“待处理”时，将其设置为“待处理” // 这样可以触发WooCommerce默认的“待处理订单”邮件 if ( 'cod' === $payment_method && ! $order->has_status( 'on-hold' ) ) { // 将订单状态设置为“on-hold” // 第二个参数是备注，会显示在订单历史中 $order->update_status( 'on-hold', '通过自定义逻辑，订单因支付方式A被设置为待处理状态。' ); // 注意：当订单状态改变时，WooCommerce会自动检查并发送相应的邮件。 // 因此，这里不需要额外调用 wp_mail 或手动触发 WC_Email_Customer_On_Hold_Order。 }}add_action( 'woocommerce_thankyou', 'trigger_on_hold_email_after_checkout', 10, 1 );?>登录后复制注意： 这种方法的前提是WooCommerce后台的“待处理订单”邮件通知是开启的。
手动实例化并触发邮件类：如果您需要在不改变订单状态的情况下，强制发送某个特定的WooCommerce内置邮件，可以手动获取邮件类的实例并调用其 trigger() 方法。
<?phpfunction manually_trigger_wc_email_after_checkout( $order_id ) { $order = wc_get_order( $order_id ); if ( ! $order ) { return; } $payment_method = $order->get_payment_method(); // 假设我们只针对支付方式 "A" 手动触发“待处理订单”邮件 if ( 'cod' === $payment_method ) { // 获取WooCommerce邮件系统实例 $mailer = WC()->mailer(); // 获取所有已注册的邮件类 $emails = $mailer->get_emails(); // 检查是否存在 WC_Email_Customer_On_Hold_Order 邮件类 if ( isset( $emails['WC_Email_Customer_On_Hold_Order'] ) ) { $on_hold_email = $emails['WC_Email_Customer_On_Hold_Order']; // 调用邮件类的 trigger 方法发送邮件 // trigger 方法通常接收订单ID作为参数 $on_hold_email->trigger( $order_id ); } }}add_action( 'woocommerce_thankyou', 'manually_trigger_wc_email_after_checkout', 10, 1 );?>登录后复制代码解析：
WC()->mailer()->get_emails();：获取WooCommerce邮件管理器中注册的所有邮件对象。$emails['WC_Email_Customer_On_Hold_Order']：通过邮件类的ID（通常是类名）获取特定的邮件对象。$on_hold_email->trigger( $order_id );：调用该邮件对象的 trigger 方法，传入订单ID，即可发送该邮件。注意事项
钩子选择的准确性： woocommerce_thankyou 钩子在订单处理完成后以上就是WooCommerce结账后发送特定邮件通知：实现自定义与内置邮件触发的详细内容，更多请关注php中文网其它相关文章！
