WooCommerce结账后发送自定义邮件：基于钩子的实现指南-php教程-PHP中文网

WooCommerce结账后发送自定义邮件：基于钩子的实现指南

花韻仙語

发布： 2025-10-20 11:23:26

原创

428人浏览过

WooCommerce结账后发送自定义邮件：基于钩子的实现指南

本教程详细指导如何在woocommerce商店结账完成后，通过自定义代码发送特定邮件。文章介绍了将代码集成到 `functions.php` 或自定义插件的方法，并提供了使用 `wp_mail` 函数发送自定义邮件的核心代码示例。同时，探讨了如何选择合适的woocommerce钩子、添加条件判断以及代码维护的最佳实践，帮助开发者灵活实现个性化的邮件通知功能。

在WooCommerce结账后发送自定义邮件教程

一、需求背景

在WooCommerce运营中，商家可能需要根据特定的业务逻辑，在客户完成结账后发送定制化的邮件通知。例如，当客户选择某种特定支付方式（如“A”支付）但尚未完成支付（订单处于“待付款”状态）时，商家可能希望发送一封提醒邮件或特定说明邮件，以引导客户完成后续操作或提供额外信息。本教程将介绍如何通过代码实现这一需求，发送自定义邮件。

二、代码集成位置

要将自定义功能添加到WooCommerce中，通常有两种推荐的方式：

子主题的 functions.php 文件： 这是最常见且简便的方法。将代码添加到当前活动主题的子主题的 functions.php 文件中，可以确保在主题更新时您的自定义代码不会丢失。
创建自定义插件： 对于更复杂的功能或希望在多个站点间复用代码的情况，创建独立的WooCommerce插件是更专业的选择。这能更好地组织代码，提高可维护性。

无论选择哪种方式，核心代码逻辑是相同的。

硅基智能

基于Web3.0的元宇宙，去中心化的互联网，高质量、沉浸式元宇宙直播平台，用数字化重新定义直播

查看详情

三、核心代码实现：发送自定义邮件

以下代码示例展示了如何利用WooCommerce的钩子（Hook）在结账完成后发送一封自定义邮件。

<?php
/**
 * 在WooCommerce结账完成后发送自定义邮件
 */
function send_custom_email_after_checkout() {
    // 获取当前用户的邮箱地址
    // 注意：在woocommerce_thankyou钩子中，如果用户是访客，current_user可能不包含邮箱。
    // 更稳妥的方式是通过订单对象获取收件人邮箱，如下注释部分所示。
    global $current_user;
    $to = $current_user->user_email;

    // 如果需要获取订单相关信息，可以在此钩子中获取订单ID
    // woocommerce_thankyou 钩子会将订单ID作为参数传递
    // function send_custom_email_after_checkout($order_id) { ... }
    // $order = wc_get_order($order_id);
    // $to = $order->get_billing_email(); // 获取订单的账单邮箱，推荐用于确保准确性

    // 定义邮件主题和内容
    $subject = '您的订单已提交 - 感谢您的惠顾！';
    $body = '
        <html>
        <head>
            <title>您的订单已提交</title>
        </head>
        <body>
            <p>亲爱的客户，</p>
            <p>感谢您在我们的网站提交订单。我们已收到您的订单，并将尽快处理。</p>
            <p>订单详情请登录您的账户查看。</p>
            <p>此致，<br>您的网站名称</p>
        </body>
        </html>
    ';

    // 定义邮件头部信息，指定内容类型为HTML和发件人
    $headers = array(
        'Content-Type: text/html; charset=UTF-8',
        'From: 您的网站名称 <noreply@yourwebsite.com>' // 替换为您的网站名称和实际发件邮箱
    );

    // 使用WordPress的wp_mail函数发送邮件
    wp_mail( $to, $subject, $body, $headers );
}

// 将函数绑定到 'woocommerce_thankyou' 钩子
// 'woocommerce_thankyou' 钩子在客户完成订单（显示感谢页面）时触发
add_action('woocommerce_thankyou', 'send_custom_email_after_checkout');
?>

登录后复制

代码解析：

send_custom_email_after_checkout() 函数：
- 这是执行邮件发送逻辑的核心函数。
- 获取收件人邮箱： 示例中使用了 global $current_user; $to = $current_user->user_email; 来获取当前登录用户的邮箱。但更推荐在 woocommerce_thankyou 钩子中通过订单ID获取订单对象，然后使用 $order->get_billing_email() 来确保获取到正确的收件人邮箱，尤其是在访客结账的情况下。
- 定义邮件主题 ($subject) 和内容 ($body)： 您可以根据需求自定义邮件的主题和HTML格式的内容。HTML内容允许您使用更丰富的排版和样式。
- 定义邮件头部 ($headers)：
  - 'Content-Type: text/html; charset=UTF-8'：指定邮件内容为HTML格式，并使用UTF-8字符编码，以确保邮件内容正确显示。
  - 'From: 您的网站名称 <noreply@yourwebsite.com>'：定义发件人名称和邮箱地址。请务必将 noreply@yourwebsite.com 替换为您的实际发件邮箱，以避免邮件被识别为垃圾邮件。
- wp_mail( $to, $subject, $body, $headers );： 这是WordPress内置的邮件发送函数，用于发送电子邮件。它接受收件人、主题、内容和头部信息作为参数。
**`add_action('woocommerce_thankyou', '