Email Marketing & Newsletter
Create controlled bulk-email campaigns from Letter Manager, select valid CRM contacts or leads, process delivery under the built-in 100-per-five-minute limit, continue through cron and review delivery and open evidence.
Email Marketing & Newsletter module overview
Email Marketing & Newsletter module overviewUnderstand the complete campaign, queue, history and read-receipt flow implemented by the module.
Open guide →GuideInstall and activate Email Marketing & Newsletter
Install and activate Email Marketing & NewsletterCreate the campaign and recipient tables and register the Letter Manager tab and cron hook.
Open guide →GuideOpen the Email Marketing & Newsletter tab
Open the Email Marketing & Newsletter tabUse the exact Letter Manager route on which the module injects its third tab.
Open guide →GuideUnderstand Email Marketing & Newsletter access
Understand Email Marketing & Newsletter accessApply the access behaviour actually enforced by the supplied controller.
Open guide →GuideVerify Letter Manager dependencies
Verify Letter Manager dependenciesConfirm the existing Letter Manager page, template selector and editor elements required by the injected newsletter workspace.
Open guide →GuideUnderstand newsletter routes and endpoints
Understand newsletter routes and endpointsMap the AJAX campaign endpoints and public tracking-pixel route without exposing them as ordinary menu pages.
Open guide →GuideUnderstand newsletter database records
Understand newsletter database recordsKnow which campaign, recipient, delivery and open metadata is retained.
Open guide →GuideUnderstand deactivation and removal limitations
Understand deactivation and removal limitationsAvoid assuming that the supplied release automatically removes its database tables or campaign data.
Open guide →GuideLoad active client contacts
Load active client contactsPopulate the recipient selector with active CRM contacts that have valid, non-empty email addresses.
Open guide →GuideLoad leads as newsletter recipients
Load leads as newsletter recipientsPopulate the selector with CRM leads that have valid email addresses.
Open guide →GuideSelect individual contacts for a newsletter
Select individual contacts for a newsletterChoose specific active customer contacts instead of sending to an entire group.
Open guide →GuideSelect individual leads for a newsletter
Select individual leads for a newsletterChoose specific leads with valid email addresses.
Open guide →GuideSelect client groups for a newsletter
Select client groups for a newsletterExpand one or more CRM customer groups into their eligible active contacts.
Open guide →GuideSelect lead-status groups for a newsletter
Select lead-status groups for a newsletterExpand one or more lead statuses into eligible lead email recipients.
Open guide →GuideUse recipient live search
Use recipient live searchFilter the visible recipient list before making individual or group selections.
Open guide →GuideSelect all visible or clear recipients
Select all visible or clear recipientsUse the bulk selector controls without unintentionally selecting hidden filtered entries.
Open guide →GuideUnderstand valid-email filtering
Understand valid-email filteringKnow why a contact or lead with a missing or malformed address is not offered as a recipient.
Open guide →GuideUnderstand recipient deduplication
Understand recipient deduplicationPrevent duplicate delivery where the same email address is represented by more than one selected CRM record.
Open guide →GuideUse a Letter Manager template in a newsletter
Use a Letter Manager template in a newsletterCopy the selected Letter Manager template subject and body into the newsletter composer.
Open guide →GuideUnderstand newsletter template HTML preparation
Understand newsletter template HTML preparationKnow how complete HTML templates are reduced to email-body content before editing and delivery.
Open guide →GuideWrite a newsletter subject
Write a newsletter subjectEnter the required subject used for the outgoing campaign and history record.
Open guide →GuideCompose the newsletter email body
Compose the newsletter email bodyCreate the HTML email body sent after the personalised greeting.
Open guide →GuideValidate newsletter subject, body and recipients
Validate newsletter subject, body and recipientsResolve every server-side condition checked before a campaign record is created.
Open guide →GuideCalculate newsletter batches and estimated time
Calculate newsletter batches and estimated timeInterpret the Selected, estimated batch and ETA values shown before sending.
Open guide →GuideConfirm and start a newsletter campaign
Confirm and start a newsletter campaignCreate the queued campaign after reviewing recipients, the 100-per-five-minute limit and ETA.
Open guide →GuideUnderstand campaign and recipient statuses
Understand campaign and recipient statusesInterpret every delivery state used by the supplied code.
Open guide →GuideProcess a newsletter in the browser
Process a newsletter in the browserAllow the campaign page to request immediate queue work in small chunks.
Open guide →GuideContinue newsletter delivery through cron
Continue newsletter delivery through cronUse the module after_cron_run hook so queued campaigns progress after the browser closes.
Open guide →GuideUnderstand the 100 emails per five minutes limit
Understand the 100 emails per five minutes limitApply the exact global rolling-window rule enforced by the queue.
Open guide →GuideUnderstand newsletter queue locking
Understand newsletter queue lockingPrevent browser and cron workers from processing the same queue simultaneously.
Open guide →GuideRecover stale processing recipients
Recover stale processing recipientsUnderstand the automatic recovery of rows left in processing by an interrupted worker.
Open guide →GuideUnderstand sender identity and personalised greeting
Understand sender identity and personalised greetingKnow the sender fallback and fresh CRM name lookup used for each outgoing message.
Open guide →GuideUnderstand newsletter send success and failure
Understand newsletter send success and failureReview how each SMTP attempt changes recipient and campaign evidence.
Open guide →GuideClose the newsletter page safely
Close the newsletter page safelyLeave the browser without cancelling the server-side campaign.
Open guide →GuideUnderstand oldest queued campaign selection
Understand oldest queued campaign selectionKnow which campaign autonomous processing chooses when no campaign ID is requested.
Open guide →GuideReview Newsletter History
Review Newsletter HistoryReview campaign date, subject, status and delivery totals.
Open guide →GuideSearch and page Newsletter History
Search and page Newsletter HistoryFilter campaigns by subject or status and use the server pagination limits.
Open guide →GuideOpen newsletter campaign details
Open newsletter campaign detailsInspect the stored body and recipient-level delivery/open evidence.
Open guide →GuideRead recipient delivery details
Read recipient delivery detailsInterpret recipient name, email, delivery status, sent time, error and tracking evidence.
Open guide →GuideUnderstand newsletter open tracking
Understand newsletter open trackingKnow how the appended one-pixel image records email-client image requests.
Open guide →GuideUnderstand email image-proxy opens
Understand email image-proxy opensInterpret Gmail/Google and Outlook/Microsoft proxy evidence correctly.
Open guide →GuideApply privacy controls to newsletter evidence
Apply privacy controls to newsletter evidenceHandle campaign content, recipient data, IP addresses and user agents under authorised privacy and retention rules.
Open guide →GuideTroubleshoot a missing newsletter tab
Troubleshoot a missing newsletter tabRestore the injected tab without changing unrelated Letter Manager pages.
Open guide →GuideTroubleshoot missing newsletter recipients
Troubleshoot missing newsletter recipientsResolve active-status, invalid-email, grouping or stale-directory causes.
Open guide →GuideTroubleshoot a newsletter SMTP failure
Troubleshoot a newsletter SMTP failureUse the stored recipient error and normal CRM SMTP configuration.
Open guide →GuideTroubleshoot a rate-limited newsletter
Troubleshoot a rate-limited newsletterWait for the rolling attempt window instead of bypassing the queue.
Open guide →GuideTroubleshoot a stuck newsletter campaign
Troubleshoot a stuck newsletter campaignSeparate cron, queue-lock, rate-limit, stale-processing and SMTP causes.
Open guide →GuideTroubleshoot missing predefined newsletter templates
Troubleshoot missing predefined newsletter templatesRestore the Letter Manager template source expected by the module.
Open guide →GuideUnderstand Email Marketing & Newsletter limitations
Understand Email Marketing & Newsletter limitationsUse only the functions present in module v1.0.0.
Open guide →