WooCommerce结账后发送特定邮件通知：实现自定义与内置邮件触发-php教程-PHP中文网

woocommerce结账后发送特定邮件通知：实现自定义与内置邮件触发

本教程详细阐述了在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内置的邮件模板。

<?php
/**
 * 在WooCommerce结账后发送自定义邮件
 *
 * @param int $order_id 订单ID
 */
function 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 邮件就会被发送。

<?php
/**
 * 在WooCommerce结账后，根据条件将订单设置为“待处理”并触发相应邮件
 *
 * @param int $order_id 订单ID
 */
function 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() 方法。

<?php
/**
 * 在WooCommerce结账后，根据条件手动触发内置的“待处理订单”邮件
 *
 * @param int $order_id 订单ID
 */
function 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'] ) ) {
            /** @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 );
?>

登录后复制

代码解析：