Manage saved email templates from a new Templates submenu (create\/edit\/rename\/duplicate\/delete).<\/p>","2.4.1":"
SMTP Test tool added in Settings.<\/p>","2.4.0":"
Built-in SMTP settings (smtp.hostinger.com compatible) and improved Settings guidance for Hostinger sending limits.<\/p>","2.3.3":"
Optional file logging + safer queue processing (locking\/claiming) for troubleshooting large sends.<\/p>","2.3.2":"
Plugin Check fixes: improved filesystem\/CSV export\/SQL prepare handling.<\/p>","2.2.0":"
List management + suppression UI, plus import preview and merge rules.<\/p>","2.1.0":"
Mailing list import is now available (CSV\/TXT, simple XLSX, or paste). You can now send campaigns to imported subscribers as a new recipient source.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"3"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3470678,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3470678,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3501085,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3501085,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.0.7","0.0.8","0.0.9","0.1.0","0.1.1","0.1.2","0.1.3","1.0.0","1.0.1","2.0.2","2.6.1"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Campaign composer screen","2":"Settings screen","3":"Campaign progress table","4":"Mailing List screen (import + subscriber table)"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[264,1021,5825,455,6696],"plugin_category":[42],"plugin_contributors":[88496],"plugin_business_model":[],"class_list":["post-27948","plugin","type-plugin","status-publish","hentry","plugin_tags-email-marketing","plugin_tags-email-newsletter","plugin_tags-mailing-list","plugin_tags-newsletter","plugin_tags-smtp","plugin_category-contact-forms","plugin_contributors-georgijevic","plugin_committers-georgijevic"],"banners":{"banner":"https:\/\/ps.w.org\/my-newsletter\/assets\/banner-772x250.png?rev=3501085","banner_2x":"https:\/\/ps.w.org\/my-newsletter\/assets\/banner-1544x500.png?rev=3501085","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/my-newsletter\/assets\/icon-128x128.png?rev=3470678","icon_2x":"https:\/\/ps.w.org\/my-newsletter\/assets\/icon-256x256.png?rev=3470678","generated":false},"screenshots":[],"raw_content":"\n
My Newsletter is a lightweight WordPress newsletter plugin focused on a practical use case many site owners need immediately:<\/p>\n\n
This plugin is intentionally simple and WordPress-native:<\/p>\n\n
wp_mail()<\/code> (https:\/\/developer.wordpress.org\/reference\/functions\/wp_mail\/).<\/li>\n- Background processing uses WP-Cron (https:\/\/developer.wordpress.org\/plugins\/cron\/).<\/li>\n
- File uploads in the admin import flow use
wp_handle_upload()<\/code> (https:\/\/developer.wordpress.org\/reference\/functions\/wp_handle_upload\/).<\/li>\n<\/ul>\n\nMailing list import & management (v2.3.0)<\/h4>\n\n
My Newsletter lets you import and manage your own subscriber list:<\/p>\n\n
\n- Import subscribers via CSV\/TXT upload, simple XLSX upload, or copy\/paste.<\/li>\n
- Preview the first rows before writing to the database.<\/li>\n
- Choose merge behavior: Update existing or Skip existing.<\/li>\n
- Built-in list tools: search, export CSV, delete selected, delete all matching search, and delete by domain.<\/li>\n
- Suppression list (unsubscribed): view\/export and remove suppression (admin-only).<\/li>\n<\/ul>\n\n
Important: You are responsible for ensuring you have a lawful basis\/consent to email imported contacts, and every campaign must include a working unsubscribe option.<\/p>\n\n
Then, when composing a campaign, choose Mailing list (imported)<\/strong> as the recipient source.<\/p>\n\nCore functionality<\/h4>\n\n\nCampaign composer (admin screen)<\/strong><\/p>\n\n\n- Create a newsletter subject and HTML content.<\/li>\n
- Use the WordPress editor for message body content.<\/li>\n
- Choose recipient source:<\/li>\n
- Users + Commenters<\/li>\n
- Users only<\/li>\n
- Commenters only<\/li>\n
- Commenters on a specific post<\/li>\n
- Mailing list (imported)<\/li>\n<\/ul><\/li>\n
Background queue processing<\/strong><\/p>\n\n\n- Recipients are queued in custom plugin tables.<\/li>\n
- Sending runs in batches through WP-Cron (instead of trying to send everything in one browser request).<\/li>\n
- Reduces the risk of timeouts and broken sends on slower hosting.<\/li>\n<\/ul><\/li>\n
Test email before full campaign<\/strong><\/p>\n\n\n- Send a test message to any email address from the composer screen.<\/li>\n
- Uses the same rendering path and unsubscribe footer logic as real sends.<\/li>\n<\/ul><\/li>\n
Secure unsubscribe links<\/strong><\/p>\n\n\n- Every email includes an unsubscribe URL.<\/li>\n
- Unsubscribe tokens use an HMAC-based signature (derived from WordPress salts; see
wp_salt()<\/code> https:\/\/developer.wordpress.org\/reference\/functions\/wp_salt\/).<\/li>\n- Unsubscribed addresses are stored and skipped in future campaigns.<\/li>\n<\/ul><\/li>\n
Email templates (save\/load) (v2.5.0)<\/strong><\/p>\n\n\n- Save the current subject + content as a template.<\/li>\n
- Load a saved template into the composer to reuse it for a new campaign.<\/li>\n
- Templates are stored locally on your site (not sent anywhere).<\/li>\n<\/ul><\/li>\n
Template variables (placeholders)<\/strong><\/p>\n\n\n{{site_name}}<\/code><\/li>\n{{site_url}}<\/code><\/li>\n{{recipient_name}}<\/code><\/li>\n{{recipient_email}}<\/code><\/li>\n{{unsubscribe_url}}<\/code><\/li>\n<\/ul><\/li>\nSettings screen<\/strong><\/p>\n\n\n- From name<\/li>\n
- From email<\/li>\n
- Reply-To (optional)<\/li>\n
- Max emails per cron run (batch size)<\/li>\n
- Footer HTML (appended to outgoing emails)<\/li>\n
- Logging (optional)<\/li>\n<\/ul><\/li>\n
Optional log file (v2.3.3)<\/strong><\/p>\n\n\n- Enable logging in Settings \u2192 Logging.<\/li>\n
- View, download, and clear logs in My Newsletter \u2192 Logs<\/strong>.<\/li>\n
- Logs are stored in
wp-content\/uploads\/my-newsletter\/wpnl.log<\/code>.<\/li>\n<\/ul><\/li>\nBasic campaign tracking<\/strong><\/p>\n\n\n- Shows recent campaigns in admin.<\/li>\n
- Displays queue progress (total \/ sent \/ failed \/ queued).<\/li>\n<\/ul><\/li>\n<\/ul>\n\n
User Guide (v2.3.3)<\/h3>\n\n1) Quick start (5\u201310 minutes)<\/h4>\n\n\n- Install and activate the plugin.<\/li>\n
- Go to My Newsletter \u2192 Settings<\/strong> and set:\n\n
\n- From name<\/li>\n
- From email (prefer an address on your domain)<\/li>\n<\/ul><\/li>\n
- Go to My Newsletter<\/strong> (campaign composer) and send a Test email<\/strong> to your own address first.<\/li>\n
- Create a campaign:\n\n
\n- Enter Subject<\/li>\n
- Enter Message (HTML supported via the editor)<\/li>\n
- Choose recipients (Users \/ Commenters \/ Mailing list)<\/li>\n
- Click Queue & Start Sending<\/strong> (wording may vary by screen)<\/li>\n<\/ul><\/li>\n<\/ol>\n\n
If you don\u2019t see progress, read the \u201cWP\u2011Cron\u201d section below.<\/p>\n\n
1B) Email templates (Save \/ Load) (v2.5.0)<\/h4>\n\n
On the My Newsletter<\/strong> campaign screen you can reuse content without retyping:<\/p>\n\n\n- Write your Subject and Content (or load an existing template).<\/li>\n
- To save: enter a template name and click Save Email Template<\/strong>.<\/li>\n
- To load: choose a template from the dropdown and click Load Email Template<\/strong>.<\/li>\n<\/ol>\n\n
Tip: keep templates generic (e.g. \u201cWelcome email\u201d, \u201cPromo template\u201d), then adjust the final message before queuing.<\/p>\n\n
1C) Manage Templates (v2.6.0)<\/h4>\n\n
Use My Newsletter \u2192 Templates<\/strong> to manage your saved templates:<\/p>\n\n\n- Add New<\/strong> to create a template from scratch.<\/li>\n
- Edit<\/strong> to update the template name (rename), subject, or body.<\/li>\n
- Duplicate<\/strong> to quickly create a variation.<\/li>\n
- Delete<\/strong> to remove a template you no longer need.<\/li>\n<\/ul>\n\n
Templates are local to your site and can be loaded into the campaign composer using Load Email Template<\/strong>.<\/p>\n\n2) Settings explained (My Newsletter \u2192 Settings)<\/h4>\n\n\nFrom name \/ From email<\/strong>
\nUsed as the sender identity in outgoing messages. WordPress email is sent via wp_mail()<\/code> and your mail transport decides the final headers (https:\/\/developer.wordpress.org\/reference\/functions\/wp_mail\/).<\/p><\/li>\nReply\u2011To (optional)<\/strong>
\nIf you want replies to go to a different inbox than \u201cFrom\u201d.<\/p><\/li>\nMax emails per cron run (batch size)<\/strong>
\nLimits how many emails each WP\u2011Cron run tries to send. Smaller batches reduce timeouts on shared hosting.
\nWP\u2011Cron is traffic-driven by default (https:\/\/developer.wordpress.org\/plugins\/cron\/).<\/p><\/li>\nFooter HTML<\/strong>
\nAppended to every message. Best practice is to include:<\/p>\n\n\n- your site name,<\/li>\n
- a short reason why the recipient is receiving the email,<\/li>\n
- and an unsubscribe link (the plugin can insert
{{unsubscribe_url}}<\/code>).<\/li>\n<\/ul><\/li>\nLogging (optional, v2.3.3)<\/strong>\nEnable logging when troubleshooting unexpected queue behavior or mail failures.<\/p>\n\n\n- Go to My Newsletter \u2192 Settings \u2192 Logging<\/strong> and enable the log file.<\/li>\n
- Re-run sending (WP-Cron or \u201cRun queue now\u201d).<\/li>\n
- Open My Newsletter \u2192 Logs<\/strong> to view, download, or clear the log.<\/li>\n<\/ol>\n\n
Logs are stored in wp-content\/uploads\/my-newsletter\/wpnl.log<\/code>.<\/p><\/li>\n<\/ul>\n\n3) Creating a campaign (My Newsletter \u2192 Campaigns)<\/h4>\n\n\n- Subject<\/strong>: what recipients will see.<\/li>\n
- Message body<\/strong>: use the editor; HTML is allowed.<\/li>\n
- Placeholders<\/strong>: you can personalize using:\n\n
\n{{recipient_name}}<\/code>, {{recipient_email}}<\/code><\/li>\n<\/ul><\/li>\n- Recipients<\/strong>: choose one:\n\n
\n- Users (WP users)<\/li>\n
- Commenters (emails from approved comments)<\/li>\n
- Commenters for a specific post<\/li>\n
- Mailing list (imported)<\/li>\n<\/ul><\/li>\n<\/ol>\n\n
Then click the action button to queue recipients and start sending.<\/p>\n\n
4) Recipient sources: what exactly is included<\/h4>\n\n\nUsers<\/strong>
\nUses WordPress user emails (typically wp_users.user_email<\/code>). WordPress user data is stored in core tables (https:\/\/developer.wordpress.org\/apis\/wpdb\/).<\/p><\/li>\nCommenters<\/strong>
\nUses emails from comment records (typically wp_comments.comment_author_email<\/code>) and only approved comments are considered in typical implementations (WordPress comment basics: https:\/\/developer.wordpress.org\/reference\/functions\/get_comments\/).<\/p><\/li>\nCommenters on a specific post<\/strong>
\nSame as Commenters, but filtered by post ID.<\/p><\/li>\nMailing list (imported)<\/strong>
\nUses subscribers stored by this plugin in its own table. This list is independent from WP users\/comments.<\/p><\/li>\n<\/ul>\n\n5) Mailing list import (My Newsletter \u2192 Mailing List)<\/h4>\n\n
You have two import methods: Upload file<\/strong> or Paste<\/strong>.<\/p>\n\n5A) Upload (CSV\/TXT)<\/h3>\n\n
Best and most reliable method.<\/p>\n\n
Recommended columns<\/strong>\n* email<\/code> (required)\n* name<\/code> (optional)<\/p>\n\nCSV example<\/strong>\nemail,name\nana@example.com,Ana\nmarko@example.com,Marko<\/p>\n\nThe plugin will:\n* accept comma\/semicolon\/tab-delimited CSV (delimiter auto-detected),\n* accept a header row if it contains email<\/code>,\n* validate emails with WordPress helpers like sanitize_email()<\/code> and is_email()<\/code> (https:\/\/developer.wordpress.org\/reference\/functions\/sanitize_email\/ and https:\/\/developer.wordpress.org\/reference\/functions\/is_email\/),\n* deduplicate by email during the import batch,\n* skip emails that are already unsubscribed.<\/p>\n\nExport from Excel \/ Google Sheets<\/strong>\n* Export to CSV. XLSX support exists, but CSV is safer for complex sheets.<\/p>\n\n5B) Upload (XLSX)<\/h3>\n\n
XLSX support is intentionally minimal to keep the plugin lightweight.<\/p>\n\n
Requirements:\n* First worksheet (sheet1)\n* Column A = email\n* Column B = name (optional)\n* If cell A1 contains \u201cemail\u201d, that row is treated as header and skipped<\/p>\n\n
If your XLSX is more complex, export to CSV first.<\/p>\n\n
5C) Paste emails (copy\/paste)<\/h3>\n\n
Paste supports:\n* one email per line,\n* comma\/semicolon separated emails,\n* Name <email@example.com><\/code>,\n* 2-column lines: email,name<\/code> or name,email<\/code> (comma\/tab\/semicolon).<\/p>\n\nExamples:\nana@example.com\nmarko@example.com,Marko\nAna Example ana@example.com<\/a>\nMarko Example marko@example.com<\/a><\/p>\n\nAfter import, the screen shows:\n* imported count,\n* invalid count,\n* duplicate count,\n* skipped unsubscribed count.<\/p>\n\n
5D) Import workflow (Preview + merge rules)<\/h3>\n\n\n- Go to My Newsletter \u2192 Mailing List<\/strong>.<\/li>\n
- Upload a file (CSV\/TXT\/XLSX) or paste emails.<\/li>\n
- Click Preview import<\/strong>.<\/li>\n
- Confirm you have lawful basis\/consent (required).<\/li>\n
- Choose merge behavior:\n\n
\n- Update existing (recommended):<\/strong> update name\/source\/updated_at for existing emails.<\/li>\n
- Skip existing:<\/strong> only add new emails.<\/li>\n<\/ul><\/li>\n
- Click Import now<\/strong>.<\/li>\n<\/ol>\n\n
After import, you can export and clean the list using:\n* Export subscribers CSV,\n* Delete selected (bulk),\n* Delete all matching search,\n* Delete by domain (e.g. example.com<\/code>).<\/p>\n\n6) Viewing and managing the list<\/h4>\n\n
In My Newsletter \u2192 Mailing List<\/strong>, you can:\n* see the total subscriber count,\n* search by email or name,\n* browse paginated results,\n* export subscribers as CSV,\n* delete selected subscribers (bulk),\n* delete all subscribers matching the current search (with confirmation),\n* delete by domain (e.g. example.com<\/code>) for quick cleanup.<\/p>\n\nIn Mailing List \u2192 Suppression list<\/strong>, you can:\n* view unsubscribed emails (suppressed),\n* export suppression list as CSV,\n* remove suppression (admin-only) if you need to re-subscribe someone manually.<\/p>\n\n7) WP\u2011Cron and reliable background sending<\/h4>\n\n
This plugin uses WP\u2011Cron to send queued emails in batches. WP\u2011Cron runs on site visits (traffic).\nOn low\u2011traffic sites, campaigns may send slowly (https:\/\/developer.wordpress.org\/plugins\/cron\/).<\/p>\n\n
For reliable sending on production:\n* Configure a real server cron to hit wp-cron.php<\/code> at a fixed interval.\n WordPress explains this approach here: https:\/\/developer.wordpress.org\/plugins\/cron\/#what-is-wp-cron.<\/p>\n\nAdmin tools:\n* In My Newsletter \u2192 Settings<\/strong>, use Run queue now<\/strong> (admin-only) to process one batch immediately for testing\/troubleshooting.\n* The Settings screen includes ready-to-copy cron examples (curl\/wget) for common hosting setups.<\/p>\n\n8) Deliverability (what matters most)<\/h4>\n\n
This plugin hands off email to WordPress via wp_mail()<\/code> (https:\/\/developer.wordpress.org\/reference\/functions\/wp_mail\/).
\nDeliverability depends on your mail transport and DNS.<\/p>\n\nIf you care about inbox placement:\n* Use an SMTP provider (or transactional email service).\n* Use a sender on your own domain.\n* Configure SPF\/DKIM\/DMARC (vendor-specific docs).<\/p>\n\n
9) Compliance and consent (your responsibility)<\/h4>\n\n
The plugin provides unsubscribe links, but it does not enforce consent or double opt\u2011in.
\nYou must only email people you have a lawful basis to contact and you must honor opt\u2011outs.<\/p>\n\n
\n- FTC CAN\u2011SPAM overview: https:\/\/www.ftc.gov\/business-guidance\/resources\/can-spam-act-compliance-guide-business<\/li>\n
- EU GDPR overview (lawful basis, consent, etc.): https:\/\/commission.europa.eu\/law\/law-topic\/data-protection\/reform\/what-does-general-data-protection-regulation-gdpr-govern_en<\/li>\n<\/ul>\n\n\n
Standard WordPress upload (ZIP)<\/h4>\n\n\n- In WordPress admin, go to Plugins \u2192 Add New \u2192 Upload Plugin<\/strong>.<\/li>\n
- Upload the plugin ZIP package.<\/li>\n
- Activate My Newsletter<\/strong>.<\/li>\n
- Go to My Newsletter \u2192 Settings<\/strong> and configure sender details.<\/li>\n
- Create your first campaign in My Newsletter<\/strong> and send a test email first.<\/li>\n<\/ol>\n\n
Manual installation<\/h4>\n\n\n- Upload the
my-newsletter<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\n- Activate the plugin in Plugins<\/strong>.<\/li>\n
- Configure settings and send a test email first.<\/li>\n<\/ol>\n\n\n
\nDoes this plugin use double opt-in?<\/h3><\/dt>\nNot yet. Version 2.1.0 focuses on admin-triggered newsletter sending, background queue processing, secure unsubscribe handling, and list importing.<\/p><\/dd>\n
Why is my campaign sending slowly?<\/h3><\/dt>\nBecause WP-Cron is traffic based (https:\/\/developer.wordpress.org\/plugins\/cron\/). If your site has little traffic, cron jobs run less frequently. Configure a real cron job for more reliable processing.<\/p><\/dd>\n
Can I send to only commenters from one post?<\/h3><\/dt>\nYes. Choose Commenters on a specific post<\/strong> and select the post in the composer screen.<\/p><\/dd>\nDoes it track opens\/clicks?<\/h3><\/dt>\nNo. This plugin tracks send queue progress only (queued \/ sent \/ failed). It does not include analytics pixels or click tracking.<\/p><\/dd>\n
Will unsubscribed addresses receive future campaigns?<\/h3><\/dt>\nNo. The plugin checks its unsubscribe table before queuing recipients.<\/p><\/dd>\n
What if `wp_mail()` fails?<\/h3><\/dt>\nFailed sends are marked as failed in the queue. For more reliable sending, configure SMTP and verify the sender domain (see wp_mail()<\/code> docs: https:\/\/developer.wordpress.org\/reference\/functions\/wp_mail\/).<\/p><\/dd>\nWhat file should I upload for mailing list import?<\/h3><\/dt>\nCSV is best. XLSX works only for simple two-column sheets (A=email, B=name). Paste import is good for quick lists.<\/p><\/dd>\n
How do I import my mailing list?<\/h3><\/dt>\nGo to My Newsletter \u2192 Mailing List<\/strong>. Upload CSV\/TXT\/XLSX or paste emails, then