本教程详细阐述了在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）。
方案一：发送自定义邮件（使用 wp_mail）
此方案适用于发送完全自定义内容的邮件，而不是WooCommerce内置的邮件模板。
get_payment_method(); // 假设我们只针对支付方式 "A"（例如 'cod' - 货到付款）发送邮件 if ( 'cod' === $payment_method ) { // 将 'cod' 替换为您要匹配的支付方式ID // 获取当前用户的邮箱（或从订单中获取客户邮箱） // 如果需要发送给下单用户，从订单获取更准确 $to = $order->get_billing_email(); // 邮件主题 $subject = '您的订单已提交 - 特别通知'; // 邮件内容 // 注意：HTML内容需要设置headers $body = ' 您的订单通知 尊敬的客户，
感谢您使用支付方式A完成了订单 #' . $order_id . '。
您的订单详情：
- 订单号: #' . $order->get_order_number() . '
- 总金额: ' . $order->get_formatted_order_total() . '
- 支付方式: ' . $order->get_payment_method_title() . '
我们将尽快处理您的订单。
此致，
您的商店名称
代码解析：
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 邮件就会被发送。
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() 方法。
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'] ) ) { /** @var WC_Email_Customer_On_Hold_Order $on_hold_email */ $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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1325733.html
微信扫一扫 
支付宝扫一扫 
