=== GD Mail Queue === Contributors: GDragoN Donate link: https://plugins.dev4press.com/gd-mail-queue/ Version: 3.2 Tags: dev4press, mail, queue, email log, smtp, html email, bbpress, mail log, wp_mail Requires at least: 4.9 Tested up to: 5.2 Requires PHP: 7.0 Stable tag: trunk License: GPLv3 or later License URI: https://www.gnu.org/licenses/gpl-3.0.html Intercept emails sent with wp_mail and implements flexible mail queue system for sending emails, converting plain text emails to HTML with templates customization, email log and more. == Description == The plugin adds a mail queue system that can intercept all the emails sent through the `wp_mail` function, and depending on the predefined rules (number of recipients) sent the email into the queue, with each recipient getting own email. On top of that, the plugin can process all plain text emails and wrap them in the HTML, and send them as HTML, with options to customize the template and various other aspects. = How the plugin works = The main part of the plugin, called 'Mailer' controls the process. * Intercept every `wp_mail` call * If needed, wrap email in HTML * Determine the number of recipients * If eligible, add each recipient email into the queue Process of turning plain text into HTML emails, support all emails sent through wp_mail, even if they don't end in the queue. This can turn all WordPress system emails (registration, password reset...) into HTML emails. You can: * Choose between predefined HTML templates * Add your own custom HTML template * Define your custom header and footer for emails Queue works through the CRON, as a background job, and you can configure how many emails to send in a batch, with the timeout setting to prevent PHP timeout breaking the sending process. = Email Sending = Emails are sent using PHPMailer built into WordPress. But, the plugin has additional options to control the queue sending process and the wp_mail sending process. * Email sending engine based on PHPMailer class * PHPMailer options to use SMTP for sending emails * Customize email From for all emails passed through `wp_mail` * Customize email From, Reply and Sender for all emails sent through the queue = Email Logging = The plugin includes an advanced email log. * Custom database tables to store logs, made for performance * Store all relevant data for each email, including a list of attachments * Email log panel with filters for logged emails * Preview popup displaying all logged email details * Preview popup shows the full HTML email part preview = Other plugin features = * Options to pause wp_mail and queue operations * Dashboard: an overview of the queue (including the last run) statistics * Dashboard: an overview of the overall mailer statistics * Dashboard: additional boxes with various other information * Automatic cleanup of all successfully sent and/or failed emails * Logging of the errors for each email send through the queue * Developers friendly with various actions and filters for extra control * Support for intercepting bbPress subscription notifications emails * Support for the BuddyPress mail system (when using PHPMailer) * Track email types from emails sent by WordPress, bbPress and more * Tools to test sending of emails and adding to the queue = Upgrade to GD Mail Queue Pro = Pro version contains many more great features: * REST API based email sending engines * REST API Engine: SendGrid * REST API Engine: Mailgun (through free addon) * REST API Engine: Amazon Web Services SES (through free addon) * PHPMailer third-party SMTP services support * PHPMailer SMTP Service: Amazon Web Services SES * PHPMailer SMTP Service: Mailgun * PHPMailer SMTP Service: Mandrill * PHPMailer SMTP Service: SendGrid * PHPMailer SMTP Service: SendInBlue * PHPMailer SMTP Service: SendPulse * HTMLfy support for uploading logos * Improved dashboard with various control buttons * Improved log with the email role-based filtering * Tool to preview HTML template With more features on the roadmap exclusively for Pro version. * More information about [GD Mail Queue Pro](https://plugins.dev4press.com/gd-mail-queue/) * Compare [Free vs. Pro Plugin](https://plugins.dev4press.com/gd-mail-queue/articles/free-vs-pro-plugin/) = More Information and Support = * More information about [GD Mail Queue](https://plugins.dev4press.com/gd-mail-queue/) * Support and Knowledge Base for [GD Mail Queue](https://support.dev4press.com/kb/product/gd-mail-queue/) = Important = * The plugin only works with default WordPress `wp_mail` function that uses `PHPMailer` object. * The plugin doesn't replace `wp_mail` or PHPMailer and uses default function and class built into WordPress. * It is not advisable to use this plugin along with some other plugin that manipulates WordPress `PHPMailer` object. * Plugin doesn't support plugins that are replacing `wp_mail` function (Sendgrid, WP Offload SES and similar). == Installation == = General Requirements = * PHP: 7.0 or newer * mySQL: 5.1 or newer = PHP Notice = * Plugin doesn't work with PHP 5.6 or older versions. = WordPress Requirements = * WordPress: 4.9 or newer = WordPress Notice = * Plugin should work with WordPress 4.6 to 4.8 but these versions are no longer used for testing, and they are no longer supported. * Plugin doesn't work with WordPress 4.5 or older versions. = Basic Installation = * Plugin folder in the WordPress plugins folder must be `gd-mail-queue`. * Upload `gd-mail-queue` folder to the `/wp-content/plugins/` directory. * Activate the plugin through the 'Plugins' menu in WordPress. == Frequently Asked Questions == = Does plugin works with WordPress MultiSite installations? = Yes. Each website can be set up to use the mail queue. = Can I translate the plugin to my language? = Yes. The POT file is provided as a base for translation. Translation files should go into Languages directory. = How can I use emails log? = When the plugin is installed, email log is disabled. To enable it, open plugin Settings -> Log panel and enable it from there. = Where can I configure the plugin? = The plugin has own top-level item in the WordPress admin side menu: GD Mail Queue. This will open a panel with dashboard, settings and tools. = Does plugin supports other SMTP sending plugins? = No. But, the plugin has support for SMTP email sending, and you can add your SMTP server information for plugin to use for all emails and/or queue emails. = Can I specify SMPT server for sending queue emails? = Yes. == Upgrade Notice == = 3.2 = Few improvements to detection, email building and plugin information. == Changelog == = 3.2 - 2019.06.26 = * New: mail type detection: support for GD Topic Polls * New: phpmailer updated to use core email class for email building * Edit: various updates to readme and extra plugin information * Edit: d4pLib 2.7.3 = 3.1 - 2019.06.18 = * New: universal core email class for various operations * New: set reply to email and name globaly in wp_mail * New: htmlfy expanded with the website tagline tag * New: htmlfy expanded with the website link tag * Edit: queue function: sets char set and content type if missing * Edit: queue test now sets char set to UTF-8 * Edit: various minor tweaks and improvements * Edit: overall improved detection of the HTML emails * Edit: d4pLib 2.7.2 * Fix: email log: HTML tag displayed for non-HTML emails * Fix: queue function: not setting the content type for the email * Fix: dashboard: incorrect status for the mailer intercept * Fix: from name global: invalid check for changing From Name = 3.0.1 - 2019.06.15 = * Edit: fully updated about page for the version 3.0 * Edit: various updates to the settings labels and information * Fix: missing core engines registration action point * Fix: missing PHPMailer services registration action point = 3.0 - 2019.06.14 = * New: option to pause email sending through wp_mail * New: plugin dashboard completely reorganized * New: plugin dashboard: wp-mail status box * New: plugin dashboard: mail log status box * New: database tables for emails, log and email/log relationship * New: log emails send by wp_mail, queue or both * New: emails log panel with an overview of all logged emails * New: emails log panel with the option to delete from log * New: emails log panel with popup dialogue for email preview * New: daily maintenance with support for log cleanup * New: fake PHPMailer class now implements magic methods * New: mirror PHPMailer class captures more information * New: detect email type: support for WP error recovery mode email * New: email preheader tag: choose the value to generate * New: a filter that can be used to pause wp_mail sending * New: a filter that can be used to control queue decision * New: additional filters and actions for various things * Edit: additional information on the plugin dashboard * Edit: improved plugin settings organization * Edit: reset tool support for clearing the email log tables * Edit: d4pLib 2.7.1 * Fix: email preheader tag set to the wrong value = 2.1.2 - 2019.05.30 = * Fix: wrong links for the update and install notifications in network mode * Fix: wrong admin menu action used when in the network mode = 2.1.1 - 2019.05.26 = * Fix: wrong database table name for the queue cleanup process = 2.1 - 2019.05.22 = * New: option to use flexible limit when sending queued emails * New: action run after each email has been sent through the queue * New: a filter that can be used to pause the queue processing * New: option on advanced settings panel to pause the queue processing * New: export tool: select what to export: settings and/or statistics * Edit: export tool: improved import of settings from the file as a proper array * Edit: dashboard: improved display of the queue related information * Edit: improved the descriptions for various plugin settings * Edit: d4pLib 2.6.4 * Fix: export tool: statistics data problem caused by the JSON import * Fix: export tool: wrong file name for the plugin settings export JSON file = 2.0.1 - 2019.05.08 = * Edit: check if the template file exists before attempting to load * Fix: the display of the last queue timestamp conversion error * Fix: default option for the HTML template was wrong = 2.0 - 2019.05.06 = * New: support for queue email send engines * New: email send engine: phpmailer * New: phpmailer support for using SMTP for sending * New: set from email and name globally in wp_mail * New: additional information on the dashboard for queue * New: tools to test email sending and adding to the queue * New: detect email type for emails sent by BuddyPress * New: includes defuse encryption library * Edit: few changes in some of the filters and actions * Edit: better organization of the plugin settings panels * Edit: improvements to the function for adding to the queue * Edit: various loading and initialization improvements * Fix: few issues when preparing an email to send in queue * Fix: few problems with function for adding to the queue * Fix: plugin settings export not working = 1.0 - 2019.05.02 = * First plugin version == Screenshots == 1. Plugin Dashboard 2. Mail Log: Overview 3. Mail Log: Single Email basics 4. Mail Log: Single Email HTML 5. Email sending test tool 6. Email Example: Basic Template 7. Email Example: Basic Template with Header and Logo 8. Settings: HTML Template 9. Settings: Mailer Controls 10. Settings: Queue Controls 11. Settings: PHPMailer SMTP