如何在 WooCommerce 订阅首次付款时发送自定义欢迎邮件-php教程-PHP中文网

如何在 WooCommerce 订阅首次付款时发送自定义欢迎邮件

本文介绍如何在用户完成 woocommerce subscriptions 首次支付后，精准触发并发送一条定制化邮件（如账户设置指引），避免续订时重复发送，通过钩子判断订单状态与用户历史订单数实现逻辑控制。

本文介绍如何在用户完成 woocommerce subscriptions 首次支付后，精准触发并发送一条定制化邮件（如账户设置指引），避免续订时重复发送，通过钩子判断订单状态与用户历史订单数实现逻辑控制。

在 WooCommerce + WooCommerce Subscriptions 环境中，为新订阅用户自动发送专属引导邮件（例如“如何登录/设置账户”）是一项常见且高价值的需求。关键挑战在于：必须仅对用户的首次成功支付触发邮件，而跳过后续周期性续订（renewal）——否则会导致用户体验混乱和信息冗余。

✅ 正确的触发时机：使用订单状态钩子

WooCommerce Subscriptions 将首次订阅支付生成的订单视为常规订单（而非 renewal order），其状态通常为 processing 或 completed（取决于网关配置）。因此，应优先监听：

woocommerce_order_status_processing（推荐用于即时到账网关，如 Stripe、PayPal Standard）
或 woocommerce_order_status_completed（适用于需手动确认的场景）

⚠️ 注意：切勿使用 woocommerce_subscription_payment_complete ——该钩子会在每次续订成功时触发，无法区分首次与后续支付。

✅ 核心逻辑：识别“首次付费用户”

判断依据不是订阅本身，而是该用户是否此前从未下过任何 WooCommerce 订单（包括非订阅订单）。以下代码在 functions.php（建议置于子主题中）中实现：

add_action('woocommerce_order_status_processing', 'send_first_subscription_welcome_email', 10, 1);
function send_first_subscription_welcome_email($order_id) {
    $order = wc_get_order($order_id);
    if (!$order || !$order->get_user_id()) {
        return; // 跳过游客订单或无效订单
    }

    $user_id = $order->get_user_id();

    // 查询该用户所有已创建订单（排除草稿、取消等状态）
    $user_orders = wc_get_orders(array(
        'customer' => $user_id,
        'status'   => array('wc-completed', 'wc-processing', 'wc-on-hold'),
        'limit'    => 1, // 只需知道是否存在至少1笔历史订单
        'return'   => 'ids',
    ));

    // 若查询结果为空（即当前订单是该用户的第1笔有效订单），则发送邮件
    if (empty($user_orders)) {
        $to        = $order->get_billing_email();
        $first_name = $order->get_billing_first_name() ?: 'Valued Customer';
        $subject   = '? Welcome! Your Account Setup Guide';
        $message   = "Hello {$first_name},\n\nThank you for subscribing!\n\nTo get started:\n1. Visit our login page: " . wp_login_url() . "\n2. Use your email ({$to}) as username.\n3. Click 'Lost your password?' if needed.\n\nNeed help? Reply to this email or visit our support hub.\n\n— The Team";

        $headers = array('Content-Type: text/plain; charset=UTF-8');

        wp_mail($to, $subject, $message, $headers);
    }
}

? 进阶优化建议

发件人信息自定义：通过 wp_mail_from 和 wp_mail_from_name 过滤器统一设置品牌邮箱：

add_filter('wp_mail_from', function($email) {
    return 'support@yourstore.com';
});
add_filter('wp_mail_from_name', function($name) {
    return 'Your Store Team';
});

邮件模板升级：将纯文本邮件替换为 HTML 模板（需设置 Content-Type: text/html 头，并使用 wp_kses_post() 安全处理内容）。
日志与调试：在生产环境上线前，用 error_log("First-time user {$user_id} triggered welcome email"); 记录触发情况，便于验证逻辑。
兼容性注意：确保 WooCommerce 和 WooCommerce Subscriptions 插件均为最新稳定版；若使用缓存插件，请排除 /wp-admin/ 及订单回调路径。