🔍 Email Flow Diagnostic Tool: Created test-email-flow.php - comprehensive diagnostic dashboard: - System status (notification mode, email channel, Action Scheduler) - Event configuration checker - Email queue status (wp_options) - Action Scheduler queue status - Recent email logs viewer - Test actions (queue test email, process queue, test order email) - Troubleshooting guide 📝 Enhanced Debug Logging: Added detailed logging to EmailManager: - Hook trigger logging - Order validation logging - Event enabled/disabled logging - Email rendering status - wp_mail() call result - Full email flow traceability 🎯 Usage: 1. Visit: /wp-content/plugins/woonoow/test-email-flow.php 2. Check all system status indicators 3. Use test buttons to trigger emails 4. Monitor debug logs for detailed flow 📋 Logs to Watch: [EmailManager] send_order_processing_email triggered [EmailManager] order_processing email is disabled/enabled [EmailManager] Sending order_processing email [EmailManager] Email rendered successfully [EmailManager] wp_mail called - Result: success/failed [WooNooW MailQueue] Queued email ID [WooNooW MailQueue] Processing email_id [WooNooW MailQueue] Sent and deleted email ID 🚀 Troubleshooting Steps: 1. Check notification system mode (woonoow vs woocommerce) 2. Check email channel enabled 3. Check event-specific email enabled 4. Check Action Scheduler for failures 5. Check debug logs for flow 6. Test with diagnostic tool
418 lines
11 KiB
PHP
418 lines
11 KiB
PHP
<?php
|
|
/**
|
|
* Email Manager
|
|
*
|
|
* Manages custom email notifications and disables WooCommerce default emails
|
|
*
|
|
* @package WooNooW\Core\Notifications
|
|
*/
|
|
|
|
namespace WooNooW\Core\Notifications;
|
|
|
|
class EmailManager {
|
|
|
|
/**
|
|
* Instance
|
|
*/
|
|
private static $instance = null;
|
|
|
|
/**
|
|
* Get instance
|
|
*/
|
|
public static function instance() {
|
|
if (null === self::$instance) {
|
|
self::$instance = new self();
|
|
}
|
|
return self::$instance;
|
|
}
|
|
|
|
/**
|
|
* Constructor
|
|
*/
|
|
private function __construct() {
|
|
$this->init_hooks();
|
|
}
|
|
|
|
/**
|
|
* Initialize hooks
|
|
*/
|
|
private function init_hooks() {
|
|
// Disable WooCommerce emails to prevent duplicates
|
|
add_action('woocommerce_email', [$this, 'disable_wc_emails'], 1);
|
|
|
|
// Hook into WooCommerce order status changes
|
|
add_action('woocommerce_order_status_pending_to_processing', [$this, 'send_order_processing_email'], 10, 2);
|
|
add_action('woocommerce_order_status_pending_to_completed', [$this, 'send_order_completed_email'], 10, 2);
|
|
add_action('woocommerce_order_status_processing_to_completed', [$this, 'send_order_completed_email'], 10, 2);
|
|
add_action('woocommerce_order_status_completed', [$this, 'send_order_completed_email'], 10, 2);
|
|
add_action('woocommerce_order_status_pending_to_on-hold', [$this, 'send_order_on_hold_email'], 10, 2);
|
|
add_action('woocommerce_order_status_failed_to_processing', [$this, 'send_order_processing_email'], 10, 2);
|
|
add_action('woocommerce_order_status_cancelled', [$this, 'send_order_cancelled_email'], 10, 2);
|
|
add_action('woocommerce_order_status_refunded', [$this, 'send_order_refunded_email'], 10, 2);
|
|
add_action('woocommerce_order_fully_refunded', [$this, 'send_order_refunded_email'], 10, 2);
|
|
|
|
// New order notification for admin
|
|
add_action('woocommerce_new_order', [$this, 'send_new_order_admin_email'], 10, 1);
|
|
|
|
// Customer note
|
|
add_action('woocommerce_new_customer_note', [$this, 'send_customer_note_email'], 10, 1);
|
|
|
|
// New customer account
|
|
add_action('woocommerce_created_customer', [$this, 'send_new_customer_email'], 10, 3);
|
|
|
|
// Low stock / Out of stock
|
|
add_action('woocommerce_low_stock', [$this, 'send_low_stock_email'], 10, 1);
|
|
add_action('woocommerce_no_stock', [$this, 'send_out_of_stock_email'], 10, 1);
|
|
add_action('woocommerce_product_set_stock', [$this, 'check_stock_levels'], 10, 1);
|
|
}
|
|
|
|
/**
|
|
* Check if WooNooW notification system is enabled
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function is_enabled() {
|
|
// Check global notification system mode
|
|
$system_mode = get_option('woonoow_notification_system_mode', 'woonoow');
|
|
return $system_mode === 'woonoow';
|
|
}
|
|
|
|
/**
|
|
* Disable WooCommerce default emails
|
|
*
|
|
* @param WC_Emails $email_class
|
|
*/
|
|
public function disable_wc_emails($email_class) {
|
|
// Only disable WC emails if WooNooW system is enabled
|
|
if (!self::is_enabled()) {
|
|
return; // Keep WC emails if WooNooW system disabled
|
|
}
|
|
|
|
// Disable all WooCommerce transactional emails
|
|
$emails_to_disable = [
|
|
'WC_Email_New_Order', // Admin: New order
|
|
'WC_Email_Cancelled_Order', // Admin: Cancelled order
|
|
'WC_Email_Failed_Order', // Admin: Failed order
|
|
'WC_Email_Customer_On_Hold_Order', // Customer: Order on-hold
|
|
'WC_Email_Customer_Processing_Order', // Customer: Processing order
|
|
'WC_Email_Customer_Completed_Order', // Customer: Completed order
|
|
'WC_Email_Customer_Refunded_Order', // Customer: Refunded order
|
|
'WC_Email_Customer_Invoice', // Customer: Invoice
|
|
'WC_Email_Customer_Note', // Customer: Note added
|
|
'WC_Email_Customer_Reset_Password', // Customer: Reset password
|
|
'WC_Email_Customer_New_Account', // Customer: New account
|
|
];
|
|
|
|
foreach ($emails_to_disable as $email_id) {
|
|
add_filter('woocommerce_email_enabled_' . strtolower(str_replace('WC_Email_', '', $email_id)), '__return_false');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Send order processing email
|
|
*
|
|
* @param int $order_id
|
|
* @param WC_Order $order
|
|
*/
|
|
public function send_order_processing_email($order_id, $order = null) {
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] send_order_processing_email triggered for order #' . $order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
$order = wc_get_order($order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] Order not found for ID: ' . $order_id);
|
|
}
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('order_processing', 'email', 'customer')) {
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] order_processing email is disabled in settings');
|
|
}
|
|
return;
|
|
}
|
|
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] Sending order_processing email for order #' . $order_id);
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('order_processing', 'customer', $order);
|
|
}
|
|
|
|
/**
|
|
* Send order completed email
|
|
*
|
|
* @param int $order_id
|
|
* @param WC_Order $order
|
|
*/
|
|
public function send_order_completed_email($order_id, $order = null) {
|
|
if (!$order) {
|
|
$order = wc_get_order($order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('order_completed', 'email', 'customer')) {
|
|
return;
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('order_completed', 'customer', $order);
|
|
}
|
|
|
|
/**
|
|
* Send order on-hold email
|
|
*
|
|
* @param int $order_id
|
|
* @param WC_Order $order
|
|
*/
|
|
public function send_order_on_hold_email($order_id, $order = null) {
|
|
if (!$order) {
|
|
$order = wc_get_order($order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('order_processing', 'email', 'customer')) {
|
|
return;
|
|
}
|
|
|
|
// Send email (use processing template for on-hold)
|
|
$this->send_email('order_processing', 'customer', $order);
|
|
}
|
|
|
|
/**
|
|
* Send order cancelled email
|
|
*
|
|
* @param int $order_id
|
|
* @param WC_Order $order
|
|
*/
|
|
public function send_order_cancelled_email($order_id, $order = null) {
|
|
if (!$order) {
|
|
$order = wc_get_order($order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Send to admin
|
|
if ($this->is_event_enabled('order_cancelled', 'email', 'staff')) {
|
|
$this->send_email('order_cancelled', 'staff', $order);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Send order refunded email
|
|
*
|
|
* @param int $order_id
|
|
* @param WC_Order $order
|
|
*/
|
|
public function send_order_refunded_email($order_id, $order = null) {
|
|
if (!$order) {
|
|
$order = wc_get_order($order_id);
|
|
}
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('order_refunded', 'email', 'customer')) {
|
|
return;
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('order_refunded', 'customer', $order);
|
|
}
|
|
|
|
/**
|
|
* Send new order admin email
|
|
*
|
|
* @param int $order_id
|
|
*/
|
|
public function send_new_order_admin_email($order_id) {
|
|
$order = wc_get_order($order_id);
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('order_placed', 'email', 'staff')) {
|
|
return;
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('order_placed', 'staff', $order);
|
|
}
|
|
|
|
/**
|
|
* Send customer note email
|
|
*
|
|
* @param array $args
|
|
*/
|
|
public function send_customer_note_email($args) {
|
|
$order = wc_get_order($args['order_id']);
|
|
|
|
if (!$order) {
|
|
return;
|
|
}
|
|
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('customer_note', 'email', 'customer')) {
|
|
return;
|
|
}
|
|
|
|
// Send email with note data
|
|
$this->send_email('customer_note', 'customer', $order, ['note' => $args['customer_note']]);
|
|
}
|
|
|
|
/**
|
|
* Send new customer email
|
|
*
|
|
* @param int $customer_id
|
|
* @param array $new_customer_data
|
|
* @param bool $password_generated
|
|
*/
|
|
public function send_new_customer_email($customer_id, $new_customer_data = [], $password_generated = false) {
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('new_customer', 'email', 'customer')) {
|
|
return;
|
|
}
|
|
|
|
$customer = new \WC_Customer($customer_id);
|
|
|
|
// Send email
|
|
$this->send_email('new_customer', 'customer', $customer, [
|
|
'password_generated' => $password_generated,
|
|
'user_login' => $new_customer_data['user_login'] ?? '',
|
|
'user_pass' => $new_customer_data['user_pass'] ?? '',
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* Send low stock email
|
|
*
|
|
* @param WC_Product $product
|
|
*/
|
|
public function send_low_stock_email($product) {
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('low_stock', 'email', 'staff')) {
|
|
return;
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('low_stock', 'staff', $product);
|
|
}
|
|
|
|
/**
|
|
* Send out of stock email
|
|
*
|
|
* @param WC_Product $product
|
|
*/
|
|
public function send_out_of_stock_email($product) {
|
|
// Check if event is enabled
|
|
if (!$this->is_event_enabled('out_of_stock', 'email', 'staff')) {
|
|
return;
|
|
}
|
|
|
|
// Send email
|
|
$this->send_email('out_of_stock', 'staff', $product);
|
|
}
|
|
|
|
/**
|
|
* Check stock levels when product stock is updated
|
|
*
|
|
* @param WC_Product $product
|
|
*/
|
|
public function check_stock_levels($product) {
|
|
$stock = $product->get_stock_quantity();
|
|
$low_stock_threshold = get_option('woocommerce_notify_low_stock_amount', 2);
|
|
|
|
if ($stock <= 0) {
|
|
$this->send_out_of_stock_email($product);
|
|
} elseif ($stock <= $low_stock_threshold) {
|
|
$this->send_low_stock_email($product);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Check if event is enabled
|
|
*
|
|
* @param string $event_id
|
|
* @param string $channel_id
|
|
* @param string $recipient_type
|
|
* @return bool
|
|
*/
|
|
private function is_event_enabled($event_id, $channel_id, $recipient_type) {
|
|
$settings = get_option('woonoow_notification_settings', []);
|
|
|
|
// Check if event exists and channel is enabled
|
|
if (isset($settings['events'][$event_id]['channels'][$channel_id])) {
|
|
return $settings['events'][$event_id]['channels'][$channel_id]['enabled'] ?? false;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Send email
|
|
*
|
|
* @param string $event_id
|
|
* @param string $recipient_type
|
|
* @param mixed $data
|
|
* @param array $extra_data
|
|
*/
|
|
private function send_email($event_id, $recipient_type, $data, $extra_data = []) {
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] send_email called - Event: ' . $event_id . ', Recipient: ' . $recipient_type);
|
|
}
|
|
|
|
// Get email renderer
|
|
$renderer = EmailRenderer::instance();
|
|
|
|
// Render email
|
|
$email = $renderer->render($event_id, $recipient_type, $data, $extra_data);
|
|
|
|
if (!$email) {
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] Email rendering failed for event: ' . $event_id);
|
|
}
|
|
return;
|
|
}
|
|
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] Email rendered successfully - To: ' . $email['to'] . ', Subject: ' . $email['subject']);
|
|
}
|
|
|
|
// Send email via wp_mail
|
|
$headers = [
|
|
'Content-Type: text/html; charset=UTF-8',
|
|
'From: ' . get_bloginfo('name') . ' <' . get_option('admin_email') . '>',
|
|
];
|
|
|
|
$sent = wp_mail($email['to'], $email['subject'], $email['body'], $headers);
|
|
|
|
if (defined('WP_DEBUG') && WP_DEBUG) {
|
|
error_log('[EmailManager] wp_mail called - Result: ' . ($sent ? 'success' : 'failed'));
|
|
}
|
|
|
|
// Log email sent
|
|
do_action('woonoow_email_sent', $event_id, $recipient_type, $email);
|
|
}
|
|
}
|