loader=$loader; $this->Repository=new EmailRepository($loader); } public static $TriggerManager; public static function Instance(){ if(self::$TriggerManager==null) self::$TriggerManager=new TriggerManager(RNADEM()->loader); return self::$TriggerManager; } public function InitializeHooks() { add_filter('woocommerce_order_status_changed',array($this,'OrderStatusChange'),10,3); add_action('woocommerce_checkout_order_processed',array($this,'OrderCreated'),10,1); add_action('woocommerce_store_api_checkout_order_processed',array($this,'BlocksOrderCreated'),10,1); $this->InitializeSendInsteadOfHooks(); $this->InitializeCartAbandonmentHooks(); } /** * Registers woocommerce_email_enabled_{id} filters for all standard WC email IDs. */ private function InitializeSendInsteadOfHooks() { foreach ($this->loader->WCEmailTemplateIds as $wcEmailId) { add_filter('woocommerce_email_enabled_' . $wcEmailId, array($this, 'MaybeIntercept'), 10, 3); } } /** * Intercepts a WooCommerce email. If a send_instead_of trigger matches, * sends the plugin's template instead and suppresses the WC email. * * WooCommerce filter signature: * apply_filters('woocommerce_email_enabled_' . $id, $enabled, $this->object, $this) * * @param bool $enabled Whether the email is enabled * @param mixed $order The order object (WC_Order) or null — this is WC_Email::$object * @param \WC_Email $wcEmail The WooCommerce email instance * @return bool */ public function MaybeIntercept($enabled, $order = null, $wcEmail = null) { if ($wcEmail === null) return $enabled; // In admin/settings context, $order may be null — allow the email through if ($order === null || !($order instanceof \WC_Order)) return $enabled; $wcEmailId = $wcEmail->id; LogManager::LogDebug("[Trigger] MaybeIntercept fired for WC email '$wcEmailId', order #{$order->get_id()}"); $triggers = $this->Repository->GetTriggersByType('send_instead_of'); $retriever = null; foreach ($triggers as $currentTrigger) { if (!isset($currentTrigger->Options->WCEmailIds) || !is_array($currentTrigger->Options->WCEmailIds)) continue; if (!in_array($wcEmailId, $currentTrigger->Options->WCEmailIds)) continue; LogManager::LogDebug("[Trigger] send_instead_of trigger matched for email template #{$currentTrigger->EmailId}"); if ($retriever === null) $retriever = new OrderRetriever($this->loader, $order); if ($this->ConditionIsValid($currentTrigger, $retriever)) { LogManager::LogDebug("[Trigger] Conditions passed, sending template #{$currentTrigger->EmailId} instead of WC email '$wcEmailId'"); RNADEM()->SendEmail($currentTrigger->EmailId, $order); return false; // Suppress the WooCommerce email } else { LogManager::LogDebug("[Trigger] Conditions NOT met for template #{$currentTrigger->EmailId}, allowing WC email '$wcEmailId'"); } } return $enabled; } public function BlocksOrderCreated($order) { $this->OrderCreated($order->get_id()); } public function OrderCreated($orderId) { LogManager::LogDebug("[Trigger] Order created hook fired for order #$orderId"); $trigger=$this->Repository->GetTriggersByType('order_created'); LogManager::LogDebug("[Trigger] Found ".count($trigger)." 'order_created' trigger(s)"); $retriever=null; foreach($trigger as $currentTrigger) { LogManager::LogDebug("[Trigger] Evaluating trigger for email template #{$currentTrigger->EmailId}"); if($retriever==null) { $order=wc_get_order($orderId); if($order==null) { LogManager::LogDebug("[Trigger] Order #$orderId could not be loaded, skipping"); continue; } $retriever=new OrderRetriever($this->loader,$order); } if($this->ConditionIsValid($currentTrigger,$retriever)) { if($this->MaybeSchedule($currentTrigger->EmailId,$orderId)) { LogManager::LogDebug("[Trigger] Email #{$currentTrigger->EmailId} was scheduled for later delivery, skipping immediate send"); return; } LogManager::LogDebug("[Trigger] Conditions passed, sending email #{$currentTrigger->EmailId} for order #$orderId"); RNADEM()->SendEmail($currentTrigger->EmailId,$order); } else { LogManager::LogDebug("[Trigger] Conditions NOT met for email #{$currentTrigger->EmailId}, skipping"); } } } public function OrderStatusChange($orderId,$oldStatus,$newStatus) { LogManager::LogDebug("[Trigger] Order status changed hook fired for order #$orderId: '$oldStatus' -> '$newStatus'"); $trigger=$this->Repository->GetTriggersByType('order_status_change'); LogManager::LogDebug("[Trigger] Found ".count($trigger)." 'order_status_change' trigger(s)"); $retriever=null; foreach($trigger as $currentTrigger) { $fromMatch = (in_array($oldStatus,$currentTrigger->Options->FromStatus)||count($currentTrigger->Options->FromStatus)==0); $toMatch = (in_array($newStatus,$currentTrigger->Options->ToStatus)||count($currentTrigger->Options->ToStatus)==0); LogManager::LogDebug("[Trigger] Evaluating trigger for email #{$currentTrigger->EmailId} - from match: ".($fromMatch?'YES':'NO').", to match: ".($toMatch?'YES':'NO')); if($fromMatch && $toMatch) { if($retriever==null) { $order=wc_get_order($orderId); if($order==null) { LogManager::LogDebug("[Trigger] Order #$orderId could not be loaded, skipping"); continue; } $retriever=new OrderRetriever($this->loader,$order); } if($this->ConditionIsValid($currentTrigger,$retriever)) { if($this->MaybeSchedule($currentTrigger->EmailId,$orderId)) { LogManager::LogDebug("[Trigger] Email #{$currentTrigger->EmailId} was scheduled for later delivery, skipping immediate send"); return; } LogManager::LogDebug("[Trigger] Conditions passed, sending email #{$currentTrigger->EmailId} for order #$orderId"); RNADEM()->SendEmail($currentTrigger->EmailId,$order); } else { LogManager::LogDebug("[Trigger] Conditions NOT met for email #{$currentTrigger->EmailId}, skipping"); } } } } private function MaybeSchedule($emailId,$orderId) { $repository=new EmailRepository($this->loader); $options=$repository->GetEmailOptions($emailId); if($options!=null&&$options->ContentOptions->Schedule!=null) { $scheduleManager=new ScheduleManager(); return $scheduleManager->ScheduleEmail($options,$orderId); } return false; } /** * @param $trigger TriggerBaseOptionsDTO * @return boolean */ public function ConditionIsValid($trigger,$retriever) { if(!$this->loader->IsPR()) { LogManager::LogDebug("[Condition] Free version, conditions always pass"); return true; } if($trigger->Options->Condition==null) { LogManager::LogDebug("[Condition] No condition configured for email #{$trigger->EmailId}, auto-pass"); return true; } $condition =(new ConditionBaseOptionsDTO())->Merge($trigger->Options->Condition); $manager=new ConditionManager($retriever); if ($condition == null) { LogManager::LogDebug("[Condition] Condition could not be parsed for email #{$trigger->EmailId}, auto-pass"); return true; } $result = $manager->ShouldProcess($condition); LogManager::LogDebug("[Condition] Condition evaluation for email #{$trigger->EmailId}: ".($result?'PASSED':'FAILED')); return $result; } // ========================================================================= // Cart Abandonment // ========================================================================= /** * Register hooks for cart abandonment tracking. * Hooks are cheap (just function references). The actual DB check for * whether triggers exist happens inside OnCartUpdated / guest enqueue. */ private function InitializeCartAbandonmentHooks() { // Cart tracking for logged-in users add_action('woocommerce_cart_updated', array($this, 'OnCartUpdated')); add_action('woocommerce_add_to_cart', array($this, 'OnCartUpdated')); add_action('woocommerce_cart_item_removed', array($this, 'OnCartUpdated')); // Cleanup on order completion add_action('woocommerce_checkout_order_processed', array($this, 'OnCartAbandonmentOrderCompleted'), 10, 1); // Cron for checking abandoned carts add_action('rnadem_check_abandoned_carts', array($this, 'CheckAbandonedCarts')); if (!wp_next_scheduled('rnadem_check_abandoned_carts')) { wp_schedule_event(time(), 'rnadem_15min', 'rnadem_check_abandoned_carts'); } // Custom cron interval add_filter('cron_schedules', function ($schedules) { $schedules['rnadem_15min'] = array('interval' => 900, 'display' => 'Every 15 minutes'); return $schedules; }); // Guest email capture — enqueue JS only on checkout if triggers exist add_action('wp_enqueue_scripts', array($this, 'MaybeEnqueueGuestCapture')); // Guest email capture AJAX (for logged-out users) add_action('wp_ajax_nopriv_rnadem_capture_guest_email', array($this, 'CaptureGuestEmail')); add_action('wp_ajax_rnadem_capture_guest_email', array($this, 'CaptureGuestEmail')); } /** * Enqueue guest email capture script on checkout page. * Only loads if: on checkout page, user is NOT logged in, and at least one cart_abandonment trigger exists. */ public function MaybeEnqueueGuestCapture() { if (!function_exists('is_checkout') || !is_checkout()) return; if (is_user_logged_in()) return; $triggers = $this->Repository->GetTriggersByType('cart_abandonment'); if (count($triggers) === 0) return; wp_enqueue_script( 'rnadem-cart-abandon-capture', plugins_url('js/cart-abandonment-capture.js', $this->loader->MainFilePath), array(), $this->loader->FILE_VERSION, true ); wp_localize_script('rnadem-cart-abandon-capture', 'rnadem_cart_abandon', array( 'ajaxurl' => admin_url('admin-ajax.php'), 'nonce' => wp_create_nonce('rnadem_cart_abandon'), 'action' => 'rnadem_capture_guest_email' )); } /** * AJAX handler for guest email capture from the checkout page. */ public function CaptureGuestEmail() { check_ajax_referer('rnadem_cart_abandon', '_nonce'); $email = isset($_POST['email']) ? sanitize_email($_POST['email']) : ''; if (empty($email) || !is_email($email)) wp_die(); // Get WC session ID for the guest if (!WC()->session) wp_die(); $sessionId = WC()->session->get_customer_id(); if (empty($sessionId)) wp_die(); // Get current cart data $cart = WC()->cart ? WC()->cart->get_cart() : array(); if (empty($cart)) wp_die(); global $wpdb; $table = $this->loader->CART_ABANDONMENT_TABLE; $cartContents = json_encode($cart); $cartTotal = WC()->cart->get_total(''); // Check if a record already exists for this session $existing = $wpdb->get_var($wpdb->prepare( "SELECT id FROM $table WHERE session_id = %s", $sessionId )); if ($existing) { $wpdb->update($table, array( 'email' => $email, 'cart_contents' => $cartContents, 'cart_total' => $cartTotal, 'date_updated' => current_time('mysql'), 'emails_sent' => 0 ), array('id' => $existing)); } else { $wpdb->insert($table, array( 'user_id' => 0, 'session_id' => $sessionId, 'email' => $email, 'cart_contents' => $cartContents, 'cart_total' => $cartTotal, 'date_updated' => current_time('mysql'), 'emails_sent' => 0 )); } wp_die(); } /** * Called on every cart change for logged-in users. * Checks if cart_abandonment triggers exist before doing any DB work. */ public function OnCartUpdated() { $userId = get_current_user_id(); if ($userId <= 0) return; // Guests handled by JS AJAX // Only save cart data if at least one cart_abandonment trigger exists $triggers = $this->Repository->GetTriggersByType('cart_abandonment'); if (count($triggers) === 0) return; global $wpdb; $table = $this->loader->CART_ABANDONMENT_TABLE; // If cart is empty, delete the row $cart = WC()->cart ? WC()->cart->get_cart() : array(); if (empty($cart)) { $wpdb->delete($table, array('user_id' => $userId)); return; } // Get user email — use account email (always available for logged-in users) $user = get_userdata($userId); $email = $user ? $user->user_email : ''; if (empty($email)) return; // Can't send an email, no point saving $cartContents = json_encode($cart); $cartTotal = WC()->cart->get_total(''); // Check if record exists for this user $existing = $wpdb->get_var($wpdb->prepare( "SELECT id FROM $table WHERE user_id = %d", $userId )); if ($existing) { $wpdb->update($table, array( 'email' => $email, 'cart_contents' => $cartContents, 'cart_total' => $cartTotal, 'date_updated' => current_time('mysql'), 'emails_sent' => 0 ), array('id' => $existing)); } else { $wpdb->insert($table, array( 'user_id' => $userId, 'session_id' => '', 'email' => $email, 'cart_contents' => $cartContents, 'cart_total' => $cartTotal, 'date_updated' => current_time('mysql'), 'emails_sent' => 0 )); } } /** * On order completion, remove the cart abandonment record. */ public function OnCartAbandonmentOrderCompleted($orderId) { global $wpdb; $table = $this->loader->CART_ABANDONMENT_TABLE; $order = wc_get_order($orderId); if (!$order) return; // Delete by user_id (logged-in) $userId = $order->get_customer_id(); if ($userId > 0) $wpdb->delete($table, array('user_id' => $userId)); // Delete by email (guest fallback) $email = $order->get_billing_email(); if (!empty($email)) $wpdb->delete($table, array('email' => $email, 'user_id' => 0)); } /** * Cron job: check for abandoned carts and send emails. */ public function CheckAbandonedCarts() { global $wpdb; $table = $this->loader->CART_ABANDONMENT_TABLE; // Cleanup records older than 30 days $wpdb->query("DELETE FROM $table WHERE date_updated < DATE_SUB(NOW(), INTERVAL 30 DAY)"); // Get all cart_abandonment triggers $triggers = $this->Repository->GetTriggersByType('cart_abandonment'); if (count($triggers) === 0) return; LogManager::LogDebug("[CartAbandonment] Cron fired, found " . count($triggers) . " trigger(s)"); foreach ($triggers as $currentTrigger) { $delayValue = isset($currentTrigger->Options->DelayValue) ? intval($currentTrigger->Options->DelayValue) : 1; $delayUnit = isset($currentTrigger->Options->DelayUnit) ? $currentTrigger->Options->DelayUnit : 'hours'; // Build SQL interval $intervalUnit = ($delayUnit === 'days') ? 'DAY' : 'HOUR'; // Query for abandoned carts that have been idle longer than the delay $records = $wpdb->get_results($wpdb->prepare( "SELECT * FROM $table WHERE date_updated < DATE_SUB(NOW(), INTERVAL %d $intervalUnit) AND emails_sent = 0 AND cart_contents IS NOT NULL AND email != ''", $delayValue )); LogManager::LogDebug("[CartAbandonment] Trigger #{$currentTrigger->EmailId}: delay={$delayValue} {$delayUnit}, found " . count($records) . " abandoned cart(s)"); foreach ($records as $record) { LogManager::LogDebug("[CartAbandonment] Processing cart #{$record->id} for email '{$record->email}'"); // Build in-memory order from cart data $cartOrder = CartOrderWrapper::FromCartRecord($record); $retriever = new OrderRetriever($this->loader, $cartOrder); // Check conditions (filters) if ($this->ConditionIsValid($currentTrigger, $retriever)) { LogManager::LogDebug("[CartAbandonment] Conditions passed, sending email #{$currentTrigger->EmailId} to '{$record->email}'"); RNADEM()->SendEmail($currentTrigger->EmailId, $cartOrder); // Mark as sent $wpdb->update($table, array( 'emails_sent' => $record->emails_sent + 1 ), array('id' => $record->id)); } else { LogManager::LogDebug("[CartAbandonment] Conditions NOT met for cart #{$record->id}, skipping"); } } } } }