WooCommerce Custom Email Notifications

WooCommerce Custom Email Notifications

Create custom email notifications for specific WooCommerce events like low stock alerts, abandoned carts, or custom order statuses.

// Create custom email class
if (!class_exists('WC_Custom_Order_Email')) {
    class WC_Custom_Order_Email extends WC_Email {

        public function __construct() {
            $this->id             = 'custom_order_email';
            $this->title          = __('Custom Order Email', 'woocommerce');
            $this->description    = __('Custom email sent for special order conditions', 'woocommerce');
            $this->template_html  = 'emails/custom-order-email.php';
            $this->template_plain = 'emails/plain/custom-order-email.php';
            $this->template_base  = get_stylesheet_directory() . '/woocommerce/';
            $this->placeholders   = array(
                '{order_date}'   => '',
                '{order_number}' => '',
            );

            // Triggers for this email
            add_action('woocommerce_order_status_pending_to_processing_notification', array($this, 'trigger'), 10, 2);
            add_action('woocommerce_order_status_pending_to_completed_notification', array($this, 'trigger'), 10, 2);

            // Call parent constructor
            parent::__construct();

            // Other settings
            $this->recipient = $this->get_option('recipient', get_option('admin_email'));
        }

        /**
         * Get email subject.
         */
        public function get_default_subject() {
            return __('New order received - Order {order_number}', 'woocommerce');
        }

        /**
         * Get email heading.
         */
        public function get_default_heading() {
            return __('New Order: {order_number}', 'woocommerce');
        }

        /**
         * Trigger the sending of this email.
         */
        public function trigger($order_id, $order = false) {
            $this->setup_locale();

            if ($order_id && !is_a($order, 'WC_Order')) {
                $order = wc_get_order($order_id);
            }

            if (is_a($order, 'WC_Order')) {
                $this->object                         = $order;
                $this->placeholders['{order_date}']   = wc_format_datetime($this->object->get_date_created());
                $this->placeholders['{order_number}'] = $this->object->get_order_number();
            }

            if ($this->is_enabled() && $this->get_recipient()) {
                $this->send($this->get_recipient(), $this->get_subject(), $this->get_content(), $this->get_headers(), $this->get_attachments());
            }

            $this->restore_locale();
        }

        /**
         * Get content html.
         */
        public function get_content_html() {
            return wc_get_template_html(
                $this->template_html,
                array(
                    'order'              => $this->object,
                    'email_heading'      => $this->get_heading(),
                    'additional_content' => $this->get_additional_content(),
                    'sent_to_admin'      => false,
                    'plain_text'         => false,
                    'email'              => $this,
                ),
                '',
                $this->template_base
            );
        }

        /**
         * Get content plain.
         */
        public function get_content_plain() {
            return wc_get_template_html(
                $this->template_plain,
                array(
                    'order'              => $this->object,
                    'email_heading'      => $this->get_heading(),
                    'additional_content' => $this->get_additional_content(),
                    'sent_to_admin'      => false,
                    'plain_text'         => true,
                    'email'              => $this,
                ),
                '',
                $this->template_base
            );
        }

        /**
         * Initialize settings form fields.
         */
        public function init_form_fields() {
            $this->form_fields = array(
                'enabled'    => array(
                    'title'   => __('Enable/Disable', 'woocommerce'),
                    'type'    => 'checkbox',
                    'label'   => __('Enable this email notification', 'woocommerce'),
                    'default' => 'yes',
                ),
                'recipient'  => array(
                    'title'       => __('Recipient(s)', 'woocommerce'),
                    'type'        => 'text',
                    'description' => sprintf(__('Enter recipients (comma separated) for this email. Defaults to %s.', 'woocommerce'), '<code>' . esc_attr(get_option('admin_email')) . '</code>'),
                    'placeholder' => '',
                    'default'     => '',
                    'desc_tip'    => true,
                ),
                'subject'    => array(
                    'title'       => __('Subject', 'woocommerce'),
                    'type'        => 'text',
                    'desc_tip'    => true,
                    'description' => sprintf(__('Available placeholders: %s', 'woocommerce'), '<code>{order_date}, {order_number}</code>'),
                    'placeholder' => $this->get_default_subject(),
                    'default'     => '',
                ),
                'heading'    => array(
                    'title'       => __('Email heading', 'woocommerce'),
                    'type'        => 'text',
                    'desc_tip'    => true,
                    'description' => sprintf(__('Available placeholders: %s', 'woocommerce'), '<code>{order_date}, {order_number}</code>'),
                    'placeholder' => $this->get_default_heading(),
                    'default'     => '',
                ),
                'additional_content' => array(
                    'title'       => __('Additional content', 'woocommerce'),
                    'description' => __('Text to appear below the main email content.', 'woocommerce'),
                    'css'         => 'width:400px; height: 75px;',
                    'placeholder' => __('N/A', 'woocommerce'),
                    'type'        => 'textarea',
                    'default'     => '',
                    'desc_tip'    => true,
                ),
                'email_type' => array(
                    'title'       => __('Email type', 'woocommerce'),
                    'type'        => 'select',
                    'description' => __('Choose which format of email to send.', 'woocommerce'),
                    'default'     => 'html',
                    'class'       => 'email_type wc-enhanced-select',
                    'options'     => $this->get_email_type_options(),
                    'desc_tip'    => true,
                ),
            );
        }
    }
}

Register Custom Email

// Add custom email to WooCommerce
add_filter('woocommerce_email_classes', 'register_custom_order_email');
function register_custom_order_email($email_classes) {
    // Include custom email class
    require_once 'class-wc-custom-order-email.php';

    // Add to WooCommerce email classes
    $email_classes['WC_Custom_Order_Email'] = new WC_Custom_Order_Email();

    return $email_classes;
}

Email Template (HTML)

Create file: woocommerce/emails/custom-order-email.php

<?php
/**
 * Custom Order Email (HTML)
 */

if (!defined('ABSPATH')) {
    exit;
}

do_action('woocommerce_email_header', $email_heading, $email); ?>

<p><?php printf(__('You have received a new order from %s.', 'woocommerce'), $order->get_formatted_billing_full_name()); ?></p>

<h2>
    <?php
    printf(
        __('Order #%1$s - %2$s', 'woocommerce'),
        $order->get_order_number(),
        wc_format_datetime($order->get_date_created())
    );
    ?>
</h2>

<?php do_action('woocommerce_email_order_details', $order, $sent_to_admin, $plain_text, $email); ?>

<?php do_action('woocommerce_email_order_meta', $order, $sent_to_admin, $plain_text, $email); ?>

<?php do_action('woocommerce_email_customer_details', $order, $sent_to_admin, $plain_text, $email); ?>

<?php
if ($additional_content) {
    echo wp_kses_post(wpautop(wptexturize($additional_content)));
}

do_action('woocommerce_email_footer', $email);

Low Stock Alert Email

// Send email when product stock is low
add_action('woocommerce_low_stock', 'custom_low_stock_email');
function custom_low_stock_email($product) {
    $to = get_option('admin_email');
    $subject = sprintf(__('Low Stock Alert: %s', 'woocommerce'), $product->get_name());

    $message = sprintf(
        __('Product "%1$s" (ID: %2$s) is running low on stock. Current stock: %3$s', 'woocommerce'),
        $product->get_name(),
        $product->get_id(),
        $product->get_stock_quantity()
    );

    $headers = array(
        'Content-Type: text/html; charset=UTF-8',
        'From: ' . get_bloginfo('name') . ' <' . get_option('admin_email') . '>'
    );

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

Customer Review Request Email

// Send review request email 7 days after order completion
add_action('woocommerce_order_status_completed', 'schedule_review_request_email');
function schedule_review_request_email($order_id) {
    // Schedule email for 7 days later
    wp_schedule_single_event(
        time() + (7 * DAY_IN_SECONDS),
        'send_review_request_email',
        array($order_id)
    );
}

add_action('send_review_request_email', 'send_review_request_email_callback');
function send_review_request_email_callback($order_id) {
    $order = wc_get_order($order_id);

    if (!$order) {
        return;
    }

    $to = $order->get_billing_email();
    $subject = __('How was your recent purchase?', 'woocommerce');

    $message = '
    <html>
    <head>
        <title>' . $subject . '</title>
    </head>
    <body>
        <h2>Hi ' . $order->get_billing_first_name() . ',</h2>
        <p>Thank you for your recent purchase from ' . get_bloginfo('name') . '!</p>
        <p>We hope you\'re enjoying your products. We\'d love to hear your feedback!</p>
        <p><a href="' . get_permalink(wc_get_page_id('shop')) . '" style="background: #0073aa; color: white; padding: 10px 20px; text-decoration: none; border-radius: 5px;">Leave a Review</a></p>
        <p>Your feedback helps us improve and helps other customers make informed decisions.</p>
        <p>Thank you,<br>' . get_bloginfo('name') . '</p>
    </body>
    </html>
    ';

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

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

Abandoned Cart Email

// Track abandoned carts
add_action('woocommerce_cart_updated', 'track_abandoned_cart');
function track_abandoned_cart() {
    if (!is_user_logged_in() || WC()->cart->is_empty()) {
        return;
    }

    $user_id = get_current_user_id();
    $cart_data = array(
        'cart_contents' => WC()->cart->get_cart(),
        'cart_total'    => WC()->cart->get_cart_contents_total(),
        'timestamp'     => time(),
    );

    update_user_meta($user_id, '_abandoned_cart', $cart_data);
}

// Send abandoned cart email after 1 hour
add_action('init', 'schedule_abandoned_cart_emails');
function schedule_abandoned_cart_emails() {
    if (!wp_next_scheduled('send_abandoned_cart_emails')) {
        wp_schedule_event(time(), 'hourly', 'send_abandoned_cart_emails');
    }
}

add_action('send_abandoned_cart_emails', 'send_abandoned_cart_emails_callback');
function send_abandoned_cart_emails_callback() {
    $users = get_users(array('meta_key' => '_abandoned_cart'));

    foreach ($users as $user) {
        $cart_data = get_user_meta($user->ID, '_abandoned_cart', true);

        // Check if cart was abandoned more than 1 hour ago
        if (empty($cart_data) || (time() - $cart_data['timestamp']) < 3600) {
            continue;
        }

        // Check if email was already sent
        if (get_user_meta($user->ID, '_abandoned_cart_email_sent', true)) {
            continue;
        }

        $to = $user->user_email;
        $subject = __('You left items in your cart!', 'woocommerce');

        $message = '
        <h2>Hi ' . $user->display_name . ',</h2>
        <p>We noticed you left some items in your cart.</p>
        <p>Total: ' . wc_price($cart_data['cart_total']) . '</p>
        <p><a href="' . wc_get_cart_url() . '">Complete your purchase</a></p>
        ';

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

        if (wp_mail($to, $subject, $message, $headers)) {
            update_user_meta($user->ID, '_abandoned_cart_email_sent', true);
        }
    }
}

Send Email on Custom Event

// Send email when custom action occurs
add_action('custom_woocommerce_action', 'send_custom_notification_email', 10, 2);
function send_custom_notification_email($order_id, $custom_data) {
    $order = wc_get_order($order_id);

    $to = $order->get_billing_email();
    $subject = __('Custom Notification', 'woocommerce');

    $message = sprintf(
        __('Hello %s, this is a custom notification about your order #%s.', 'woocommerce'),
        $order->get_billing_first_name(),
        $order->get_order_number()
    );

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

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

Features

• Custom Email Classes: Fully integrated with WooCommerce email system
• Admin Settings: Configurable via WooCommerce > Settings > Emails
• Template Support: Uses WooCommerce email templates
• Multiple Triggers: Low stock, abandoned cart, review requests, custom events
• Scheduled Emails: Time-delayed emails using WP Cron
• HTML & Plain Text: Supports both email formats
• Placeholders: Dynamic content with placeholders
• Customizable: Full control over subject, heading, and content
• Professional: Uses WooCommerce email styling