=== Mass Email To Users ===
Contributors: nik00726
Tags: bulk email, mass email, send email to users, wordpress email marketing, newsletter
Donate link: https://www.i13websolution.com/donate_for_mass_email.php
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send bulk emails to your WordPress users directly from your dashboard — send to all, filter by role, personalise with placeholders. No third-party service needed.

== Description ==

**Mass Email To Users** lets you send HTML emails to your registered WordPress users straight from the WordPress admin. No Mailchimp account. No monthly fee. No external service required.

Send to everyone with one click using **Send Email To All Users**, filter recipients by role, search and select individual users, and personalise every email with placeholders like `[first_name]` and `[user_email]`.

**[⭐ Get the Pro Version — Tracking, Automation & WooCommerce, $19 one-time →](https://www.i13websolution.com/product/wordpress-bulk-email-pro-plugin/)**

---

= Free Version Features =

* **Send Email To All Users** — one click reaches every registered user, no manual selection needed
* **Filter by user role** — Administrators, Editors, Subscribers, Customers, etc.
* **Personalisation placeholders** — `[first_name]`, `[last_name]`, `[user_email]`, `[display_name]`, `[username]`
* **Working unsubscribe links** — `[unsubscribe_link_html]` / `[unsubscribe_link_plain]` placeholders generate one-click unsubscribe links with a branded confirmation page
* **Unsubscribers List** — view everyone who unsubscribed and re-subscribe them with one click
* Select individual users, search by email/username/name, with pagination for large user lists
* HTML email support — write rich formatted emails using the WordPress editor
* Add users to an email queue across multiple pages
* WordPress capabilities / roles support — control exactly who can send mass emails
* No advertising, no branding added to your emails
* WordPress multisite compatible

---

= 🚀 Pro Version — Everything in Free, Plus: =

**Tracking & Analytics**
* Open tracking — see who opened your email and when
* Click tracking — see which links were clicked
* Campaign Stats dashboard — open rates and click rates per campaign, visualised

**Audience Segmentation**
* WooCommerce segmentation — filter by purchase history, product bought, total spent, order status (supports WooCommerce HPOS)
* Simple Membership levels & BuddyPress profile fields
* CSV Import — upload external email lists and send to them alongside WordPress users

**Sending & Automation**
* Newsletter queue with cronjob — set your send rate and walk away
* Scheduled sending — pick a future date and time
* Email attachments — attach PDFs, images, documents
* Reply-To email field
* Full TinyMCE WYSIWYG email editor + saved email templates
* Welcome Email Automation — auto-send when new users register, with optional delay
* Bounce management — auto-unsubscribe after X failed sends

**[Get Pro for $19 — One-Time Payment, 30-Day Money-Back Guarantee →](https://www.i13websolution.com/product/wordpress-bulk-email-pro-plugin/)**

---

= Who Is This For? =

* **WordPress site owners** who need to message their users without a monthly Mailchimp bill
* **WooCommerce stores** reaching customers (upgrade to Pro for purchase-based segmentation)
* **Membership sites** communicating with members by role or level
* **Small businesses** wanting a simple, self-hosted email tool they fully own

= Quick Start =

1. Install and activate the plugin
2. Go to **Mass Email** in the WordPress admin sidebar (look for the envelope icon)
3. Fill in Subject, From Name, From Email, and your message
4. Click **Send Email To All Users** — or filter by role / search and select specific users, then click **Send Email To Selected Users**

= Personalisation Placeholders =

Add these anywhere in your subject line or email body — they're replaced automatically per recipient:

`[first_name]` `[last_name]` `[username]` `[user_email]` `[display_name]` `[nickname]` `[user_nicename]`

For unsubscribe links: `[unsubscribe_link_html]` (clickable link) or `[unsubscribe_link_plain]` (plain URL)

== Installation ==

1. Upload the `mass-email-to-users` folder to `/wp-content/plugins/`
2. Activate the plugin from **Dashboard → Plugins**
3. Go to **Mass Email** in the WordPress admin sidebar
4. Fill in your email details and send

== Frequently Asked Questions ==

= Does this require Mailchimp or any external service? =
No. Emails are sent directly from your WordPress site using your server's mail function (`wp_mail`). For best deliverability we recommend also installing a free SMTP plugin like WP Mail SMTP or FluentSMTP and configuring DKIM/SPF for your domain.

= Can I send to all users at once without selecting them one by one? =
Yes. Click **Send Email To All Users** — it reaches every registered user regardless of how many you have, no manual selection required.

= Can I filter which users receive the email? =
Yes. Use the role filter dropdown (Administrators, Subscribers, Customers, etc.) or the search box to narrow down recipients before sending. The Pro version adds WooCommerce purchase history filters, membership levels, BuddyPress fields, and CSV import for external contacts.

= Can I personalise emails with each user's name? =
Yes. Use `[first_name]`, `[last_name]`, `[display_name]`, `[user_email]`, and `[username]` in your subject and email body — each is automatically replaced with that recipient's real information.

= How does unsubscribe work? =
Add `[unsubscribe_link_html]` or `[unsubscribe_link_plain]` to your email. When a recipient clicks it, they're shown a confirmation page and added to your Unsubscribers List (under Mass Email). They're automatically excluded from all future sends. You can re-subscribe anyone from the Unsubscribers List page at any time.

= Is there a limit on how many emails I can send? =
The plugin itself has no hard limit, but your hosting provider may limit how many emails your server can send per hour. For large lists we recommend the Pro version, which includes a cronjob queue with a configurable send rate so large campaigns send reliably over time.

= Is the plugin GDPR friendly? =
The plugin only emails existing registered users of your site and includes a working unsubscribe mechanism. You remain responsible for ensuring you have an appropriate legal basis to email your users under GDPR, CAN-SPAM, and other applicable laws.

= What's the difference between Free and Pro? =
Free covers everything you need to send and manage one-off bulk emails: send to all/selected/filtered users, placeholders, and unsubscribe management. Pro adds tracking (opens/clicks), WooCommerce segmentation, scheduled sending, automation (welcome emails, bounce handling), CSV import, attachments, and email templates — see the comparison above.

== Screenshots ==

1. Mass Email — user list with role filter, search, and Send to All button
2. Send Email form — subject, from, personalisation placeholders, HTML editor
3. Unsubscribers List — view and re-subscribe unsubscribed users
4. Pro: Send Newsletter with WooCommerce filter, scheduling, and CSV groups
5. Pro Campaign Stats
6. Pro: Csv Import
7. Pro: Welcome Email
8. Pro: Bounce Email unsubscribe users

== Changelog ==

= 1.2 =
* Added: "Send Email To All Users" button — reach everyone with one click, no selection needed
* Added: Role filter dropdown — filter users by WordPress role before sending
* Added: Personalisation placeholders [first_name], [last_name], [user_email], [display_name]
* Added: Working unsubscribe links — [unsubscribe_link_html] / [unsubscribe_link_plain] with branded confirmation page
* Added: Unsubscribers List page — view and re-subscribe unsubscribed users
* Added: Locked Pro feature previews (Campaign Stats, Welcome Email, CSV Import) showing what's available in Pro
* Added: Menu icon (dashicons-email-alt) in WordPress admin sidebar
* Improved: Replaced third-party ad boxes with a clean Pro upgrade panel
* Fixed: TinyMCE content now syncs correctly on submit (HTML formatting preserved)
* Fixed: All typos in description and readme
* Updated: Tested with WordPress 7.0

= 1.1.5 =
* Fixed vulnerabilities
* Tested with WordPress 6.2

= 1.1.4 =
* Fixed character set problem

= 1.1.3 =
* Fixed nl2br problem
* Tested with WordPress 5.4

= 1.1.2 =
* Added WordPress content editor for email body
* Tested with WordPress 5.2

= 1.1.1 =
* Added WordPress capabilities feature
* Tested with WordPress 5.1

= 1.1 =
* Added search functionality
* Improved admin UI
* Tested with WordPress 5.0

= 1.0 =
* Stable 1.0 first release

== Upgrade Notice ==

= 1.2 =
Major update: Send To All Users, role filtering, personalisation placeholders, working unsubscribe links, and an Unsubscribers List. Recommended for all users.

== License ==

This plugin is free for everyone. Released under the GPL, you can use it free of charge on your personal or commercial site.
