sarfraj85

Mail Doctor replaces WordPress’ default <code>wp_mail</code> stack with authenticated SMTP or provider APIs plus the operational tooling fast-moving stores need. It is written for merchants, agencies, and reliability teams that want hard proof their receipts, fulfillment notices, and alerts land every time.
<h4>Feature Highlights</h4>
<ul>
<li>Deliverability with guardrails – Route WooCommerce or all site email through your preferred SMTP/API provider, lock the From identity, and fail over gracefully when third-party endpoints go dark.</li>
<li>One-click diagnostics – Send live tests with TLS/auth badges, latency metrics, DNS posture (SPF/DKIM/DMARC), and actionable warnings the moment something drifts.</li>
<li>Reliable retries & queue control – Automatic exponential backoff, manual retry orchestration, Action Scheduler integration, and a “run queue now” control for urgent flushes.</li>
<li>Deep visibility – Searchable logs with <code>.eml</code> downloads, header/body inspection, filterable status views, and CSV exports for audits.</li>
<li>Email template workflow – Version history, diff previews, modal device switcher, and send-test flows for the WooCommerce template editor.</li>
<li>Automation surface – REST API endpoints and WP-CLI commands mirror UI actions so you can script smoke tests, tail logs, or trigger retries in CI/CD pipelines.</li>
<li>Privacy-first options – Hash or redact recipients, tune retention windows, and honour GDPR requests through the bundled exporters/erasers.</li>
<li>Operational alerts – Instant Slack/email failure alerts plus weekly digests summarising throughput, latency, retries, and queue health.</li>
</ul>
<h3>External Services</h3>
This plugin acts as a connector between your WordPress site and third-party email providers. When you configure an external service (SMTP or API), this plugin transmits email data to that provider for delivery.
Data Sent: 
* Sender and Recipient names and email addresses. 
* Email subject, body content (HTML/Text), and headers. 
* Timestamps and potentially the originating IP address.
When Payload is Sent: 
* Immediately whenever an email is triggered by WordPress, WooCommerce, or another plugin, if that specific provider is currently set as your active transport.
Purpose: 
* To reliably deliver transactional emails to user inboxes using the provider’s infrastructure.
Supported Services & Legal Links:
<ul>
<li>
Google / Gmail
<ul>
<li><a href="https://policies.google.com/terms" rel="nofollow ugc">Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Privacy Policy</a></li>
<li>Endpoints: <code>accounts.google.com</code>, <code>oauth2.googleapis.com</code></li>
</ul>
</li>
<li>
Microsoft / Outlook / Office 365
<ul>
<li><a href="https://www.microsoft.com/en-us/legal/terms-of-use" rel="nofollow ugc">Terms of Use</a></li>
<li><a href="https://privacy.microsoft.com/en-us/privacystatement" rel="nofollow ugc">Privacy Statement</a></li>
<li>Endpoints: <code>login.microsoftonline.com</code>, <code>outlook.office365.com</code></li>
</ul>
</li>
<li>
Twilio SendGrid
<ul>
<li>Links: <a href="https://www.twilio.com/en-us/legal/tos" rel="nofollow ugc">terms of service</a>, <a href="https://www.twilio.com/en-us/legal/privacy" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>api.sendgrid.com</code></li>
</ul>
</li>
<li>
Mailgun
<ul>
<li>Links: <a href="https://www.mailgun.com/legal/terms/" rel="nofollow ugc">terms of service</a>, <a href="https://www.mailgun.com/legal/privacy-policy/" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>api.mailgun.net</code>, <code>api.eu.mailgun.net</code> (and other region equivalents)</li>
<li>Domain validation: When you click “Verify Domain” in the plugin settings, the plugin queries <code>https://api.mailgun.net/v3/domains/{your-domain}</code> (or the EU equivalent) to check DNS records (SPF, DKIM, MX). Data sent: your Mailgun API key and the domain name. No email content is transmitted during this check.</li>
</ul>
</li>
<li>
Amazon SES
<ul>
<li>Links: <a href="https://aws.amazon.com/service-terms/" rel="nofollow ugc">terms of service</a>, <a href="https://aws.amazon.com/privacy/" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>email.us-east-1.amazonaws.com</code>, <code>email-smtp.us-east-1.amazonaws.com</code> (and other <code>*.amazonaws.com</code> region equivalents)</li>
</ul>
</li>
<li>
Postmark
<ul>
<li>Links: <a href="https://postmarkapp.com/terms" rel="nofollow ugc">terms of service</a>, <a href="https://postmarkapp.com/privacy" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>api.postmarkapp.com</code></li>
</ul>
</li>
<li>
SparkPost
<ul>
<li>Links: <a href="https://www.sparkpost.com/policies/tou/" rel="nofollow ugc">terms of service</a>, <a href="https://www.sparkpost.com/policies/privacy/" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>api.sparkpost.com</code></li>
</ul>
</li>
<li>
Brevo (formerly Sendinblue)
<ul>
<li>Links: <a href="https://www.brevo.com/legal/termsofuse/" rel="nofollow ugc">terms of service</a>, <a href="https://www.brevo.com/legal/privacypolicy/" rel="nofollow ugc">privacy policy</a></li>
<li>Endpoints: <code>smtp-relay.brevo.com</code> (SMTP relay); configurable SMTP host per your provider settings.</li>
<li>This plugin transmits the same email data (sender, recipients, subject, body) to Brevo’s SMTP relay servers when Brevo is configured as the active transport.</li>
</ul>
</li>
</ul>
OAuth Authentication Endpoints:
When you connect Google or Microsoft accounts using OAuth2, this plugin communicates with the following authentication endpoints to obtain and refresh access tokens:
<ul>
<li>
Google OAuth2
<ul>
<li>Authorization: <code>https://accounts.google.com/o/oauth2/v2/auth</code></li>
<li>Token exchange: <code>https://oauth2.googleapis.com/token</code></li>
<li>Data sent: Client ID, authorization code, and redirect URI</li>
<li><a href="https://developers.google.com/terms" rel="nofollow ugc">Google API Terms of Service</a></li>
<li><a href="https://policies.google.com/privacy" rel="nofollow ugc">Google Privacy Policy</a></li>
</ul>
</li>
<li>
Microsoft OAuth2 (Outlook/Office 365)
<ul>
<li>Authorization: <code>https://login.microsoftonline.com/{tenant}/oauth2/v2.0/authorize</code></li>
<li>Token exchange: <code>https://login.microsoftonline.com/{tenant}/oauth2/v2.0/token</code></li>
<li>Data sent: Client ID, client secret, authorization code, and redirect URI</li>
<li><a href="https://docs.microsoft.com/en-us/legal/microsoft-apis/terms-of-use" rel="nofollow ugc">Microsoft API Terms of Use</a></li>
<li><a href="https://privacy.microsoft.com/en-us/privacystatement" rel="nofollow ugc">Microsoft Privacy Statement</a></li>
</ul>
</li>
</ul>
<h4>Quick Start</h4>
<ol>
<li>Review the documentation link in the Documentation section for the full tour and terminology.</li>
<li>Configure SMTP/API credentials on WooCommerce → Mail Doctor → Settings.</li>
<li>Send a test email from the Status tab and verify DNS/auth posture.</li>
<li>Visit Logs to confirm entries are stored and retries are scheduled as expected.</li>
<li>Enable alerts and weekly digests so the team knows when to act.</li>
</ol>
<h4>Documentation</h4>
Documentation: https://wpdoctorpro.com/docs/mail-doctor/welcome-to-mail-doctor – guides, setup, troubleshooting, and support.
<h4>Privacy controls</h4>
Mail Doctor ships with built-in privacy tooling under Settings → Logging & Privacy:
<ul>
<li>Mask recipient emails: Hashes addresses before storing them in logs.</li>
<li>Redact headers and bodies: Keeps metadata only so sensitive content is not persisted.</li>
<li>Retention windows: Separate sliders for sent, failed, and payload data; shorten for stricter compliance.</li>
<li>GDPR exporter/eraser: WordPress privacy tools are wired to export or anonymise recipient rows on request.</li>
<li>Role-based access: Admin UI and AJAX endpoints are gated by <code>manage_woocommerce</code>/<code>manage_options</code>.</li>
</ul>
<h4>Troubleshooting</h4>
<ul>
<li>Red notices on the Status tab usually indicate DNS or authentication drift—re-run the onboarding checks and confirm credentials with your provider.</li>
<li>If the queue stalls, visit Settings → Retry & Queue and use Run queue now; check your cron runner or Action Scheduler if jobs remain pending.</li>
<li>Use the <code>.eml</code> download from each log entry when escalating to your SMTP provider—they can analyse the exact payload and SMTP transcript.</li>
<li>For privacy incidents, toggle Privacy Mode and shorten retention while you investigate; the GDPR exporter/eraser handles customer requests.</li>
</ul>
<h3>Support & Packaging</h3>
<ul>
<li>Requirements: WordPress 6.0+, WooCommerce (latest), PHP 8.1–8.3 with cURL/JSON; OpenSSL recommended for encrypted secret storage.</li>
<li>Included in download: <code>mail-doctor/</code> plugin folder, <code>Documentation/</code> offline HTML docs, <code>readme.txt</code>, <code>changelog.txt</code>, and <code>LICENSE</code>.</li>
<li>Support/Contact: See the Documentation section for guides and support links. When requesting help, include your WP/Woo versions, provider, and a recent log ID from Mail Doctor → Logs.</li>
</ul>

Mail Doctor

Deliver WooCommerce emails with confidence using authenticated SMTP transports, visual diagnostics, and automated retries.

Acato

Email Essentials vastly reduces the chances of your emails being marked as spam or being rejected. Originally a debugging tool, it has grown into a full-fledged email enhancement plugin.
Please note that this plugin is not a “we support any type of transport” Email plugin. For other protocols than SMTP, but rather to enhance the email sending capabilities of WordPress. 
If you need to send emails with other protocols than SMTP, this plugin is not for you. You might want to look at plugins like Post SMTP (not affiliated).
And since version 6.0.0, after more than 10 years of development and internal use, this plugin is now a FOSS plugin, meaning it is free to use, modify and distribute under the GPLv2 license.
In return, we ask you to support the development of this plugin by contributing to the codebase, reporting bugs, and helping others in the community.
Responsible disclosure: 
If you find a vulnerability, please email us at <a href="mailto:responsibledisclosure@acato.nl" rel="nofollow ugc">responsibledisclosure@acato.nl</a>.
<h3>Features</h3>
<ul>
<li>Set a good From name and email address, automatically correcting it if needed. For example, a contact form is sent from the visitors email address, resulting in an invalid Sender address. This plugin will correct it to a valid email address. This plugin automatically corrects it.</li>
<li>Correct envelope-from address; often forgotten, but important for deliverability.</li>
<li>Reformat as HTML with plain text alternative; will detect the use of HTML ensures that emails are sent as HTML with a plain text alternative.</li>
<li>Process shortcodes in your email content.</li>
<li>UTF8 recoding, to ensure that special characters are correctly encoded in the email.</li>
<li>Email Essentials allows for adding CSS, header, footer, and body template using filters, see below.</li>
<li>Convert CSS to inline styles for better support in email clients</li>
<li>SMTP configuration</li>
<li>Send emails to multiple addressees as separate emails</li>
<li>S/MIME signing, using a supplied certificate, to ensure the authenticity of the email.</li>
<li>DKIM signing, and providing all information needed to set up DKIM signing for your domain.</li>
<li>Allow redirecting emails sent to the administrator to other email addresses based on the email subject.</li>
<li>Allow redirecting emails sent to the moderators (e.g., for comments).</li>
<li>Keep a history of outgoing emails (debugging, cleared on deactivation)</li>
<li>Email receipt tracking (for investigative purposes only, see GDPR note)</li>
<li>Re-send button for failed emails</li>
<li>Allow sending emails delayed, to prevent sending too many emails at once. (Beta feature)</li>
</ul>
<h3>Important Note</h3>
This tool is for users who understand email delivery. If unsure, ask for help.
Under GDPR, storing and tracking emails is prohibited. The history feature is for investigative purposes only!
<h3>External services</h3>
Email Essentials uses one external service by default, two if you create and define your own IP services.
<ol>
<li>CloudFlare DNS over HTTPS (DoH). This is used to resolve domain names to IP addresses when (for example) checking SPF or DKIM records. In theory, it is possible to use PHPs own <code>dns_get_record</code> function, but in practice this often fails due to server DNS-resolve misconfiguration. Using CloudFlare’s DoH service ensures reliable DNS resolution. We only send the hostname (the domain part) to CloudFlare, no other data. Explicitly, we do NOT send any other information.</li>
<li>The plugin can use an IP-address relay service to accurately determine the sender’s IP address. This is required to accurately check that the sender’s IP address is authorized to send email for the domain (SPF check). To use this, you will need to set up your own service, see documentation on filter <code>acato_email_essentials_ip_services</code>. Without this service, IP detection can be inaccurate because it will use the website itself as a relay. Use of a reverse proxy, load balancer etc. can lead to incorrect IP detection.</li>
</ol>
<h3>WordPress Filters</h3>
<ul>
<li><code>acato_email_essentials_settings</code> — Filter plugin settings.</li>
<li><code>acato_email_essentials_defaults</code> — Filter default settings.</li>
<li><code>acato_email_essentials_subject</code> — Filter email subject.</li>
<li><code>acato_email_essentials_body</code> — Filter HTML body of the email.</li>
<li><code>acato_email_essentials_head</code> — Filter HEAD section of HTML email.</li>
<li><code>acato_email_essentials_css</code> — Filter CSS for the email.</li>
<li><code>acato_email_essentials_minify_css</code> — Filter CSS minification.</li>
<li><code>acato_email_essentials_mail_is_throttled</code> — Check if mail should be throttled.</li>
<li><code>acato_email_essentials_mail_throttle_time_window</code> — Set mail throttle time window.</li>
<li><code>acato_email_essentials_mail_throttle_max_count_per_time_window</code> — Set max emails per time window.</li>
<li><code>acato_email_essentials_mail_throttle_batch_size</code> — Set mail batch size.</li>
<li><code>acato_email_essentials_ip_services</code> — Define custom IP services for accurately determining the sender’s IP address.</li>
<li><code>acato_email_essentials_ip_service</code> — Filter individual IP service URLs.</li>
<li><code>acato_email_essentials_website_root_path</code> — Filter to supply the correct website root path in case of non-standard setups.</li>
<li><code>acato_email_essentials_development_tlds</code> — Filter development/local TLDs.</li>
</ul>
<h3>WordPress Filters in detail</h3>
Plugin Settings
<pre><code>acato_email_essentials_settings
</code></pre>
Parameters: 
– (array) <code>$settings</code> The current settings of the plugin.
Expected return: 
– (array) The new settings of the plugin.
<pre><code>acato_email_essentials_defaults
</code></pre>
Parameters: 
– (array) <code>$defaults</code> The current default settings of the plugin.
Expected return: 
– (array) The new default settings of the plugin.
Email Content
<pre><code>acato_email_essentials_subject
</code></pre>
Parameters: 
– (string) <code>$the_subject</code> Subject for the email. 
– (PHPMailer) <code>$mailer</code> The PHPMailer object (by reference).
Expected return: 
– (string) The (altered) Subject.
<pre><code>acato_email_essentials_body
</code></pre>
Parameters: 
– (string) <code>$should_be_html</code> A text that should be html, but might not yet be, your job to make a nice HTML body. 
– (PHPMailer) <code>$mailer</code> The PHPMailer object (by reference).
Expected return: 
– (string) A text that should be html.
<pre><code>acato_email_essentials_head
</code></pre>
Parameters: 
– (string) <code>$the_head_section</code> HTML that is the HEAD section of the HTML email. 
– (PHPMailer) <code>$mailer</code> The PHPMailer object (by reference).
Expected return: 
– (string) The altered HEAD section of the HTML email.
<pre><code>acato_email_essentials_css
</code></pre>
Parameters: 
– (string) <code>$the_css</code> CSS for the email (empty by default). 
– (PHPMailer) <code>$mailer</code> The PHPMailer object (by reference).
Expected return: 
– (string) The (altered) CSS.
<pre><code>acato_email_essentials_minify_css
</code></pre>
Parameters: 
– (string) <code>$css</code> CSS to be minified.
Expected return: 
– (string) The minified CSS.
Mail Throttling
<pre><code>acato_email_essentials_mail_is_throttled
</code></pre>
Parameters: 
– (bool) <code>$is_throttled</code> Whether the mail is currently throttled. 
– (string) <code>$ip</code> The sender’s IP address. 
– (int) <code>$mails_recently_sent</code> Number of mails recently sent from this IP.
Expected return: 
– (bool) Whether the mail should be throttled.
<pre><code>acato_email_essentials_mail_throttle_time_window
</code></pre>
Parameters: 
– (int) <code>$time_window</code> Time window in seconds for counting sent emails.
Expected return: 
– (int) The (altered) time window in seconds.
<pre><code>acato_email_essentials_mail_throttle_max_count_per_time_window
</code></pre>
Parameters: 
– (int) <code>$count</code> Maximum number of emails allowed per time window.
Expected return: 
– (int) The (altered) maximum count.
<pre><code>acato_email_essentials_mail_throttle_batch_size
</code></pre>
Parameters: 
– (int) <code>$size</code> Number of emails to send in a single batch.
Expected return: 
– (int) The (altered) batch size.
IP Detection
<pre><code>acato_email_essentials_ip_services
</code></pre>
Parameters: 
– (array) <code>$services</code> The current list of IP services used to determine the sender’s IP address.
Expected return: 
– (array) The (altered) list of IP services.
The services must be keyed with <code>ipv4</code>, <code>ipv6</code> and <code>dual-stack</code>. The values must be URLs that return the IP address in plain text. 
The dual-stack service should return an IPv6 address if available, otherwise an IPv4 address, never both.
You can set-up your own service like this;
<ul>
<li>You will need a webserver that can run PHP, and you need a DNS service that allows you to manually add records.</li>
<li>You will need three webspaces, for example; ipv4.myservice.com, ipv6.myservice.com and dual-stack.myservice.com.
<ul>
<li>You could use the same webspace for all three, but you will still need three subdomains on the service.</li>
</ul>
</li>
<li>For the ipv4 subdomain, ONLY register an A record, pointing to the webserver’s IP address.</li>
<li>For the ipv6 subdomain, ONLY register an AAAA record, pointing to the webserver’s IPv6 address.</li>
<li>For the dual-stack subdomain, register both an A and an AAAA record, pointing to the webserver’s IP addresses.</li>
<li>
Create a file called <code>index.php</code> in each of the webspaces with the following content:
<code>php 
<?php 
header('Content-Type: text/plain'); 
print $_SERVER['REMOTE_ADDR'];</code>
</li>
</ul>
That’s it. You can now use these services in the plugin settings like this;
<pre><code>`php
</code></pre>
add_filter(‘acato_email_essentials_ip_services’, ‘my_custom_ip_services’); 
function my_custom_ip_services($services) { 
 // Add your custom services here 
 $services[‘ipv4’] = ‘https://ipv4.myservice.com’; 
 $services[‘ipv6’] = ‘https://ipv6.myservice.com’; 
 $services[‘dual-stack’] = ‘https://dual-stack.myservice.com’; 
 return $services; 
} 
 `
<pre><code>acato_email_essentials_ip_service
</code></pre>
Parameters: 
– (string) <code>$service</code> The URL of the IP service for the given type. 
– (string) <code>$type</code> The type of IP service (‘ipv4’, ‘ipv6’, or ‘dual-stack’).
Expected return: 
– (string) The (altered) IP service URL.
Filter to modify individual IP service URLs based on type.
<pre><code>acato_email_essentials_website_root_path
</code></pre>
Parameters: 
– (string) <code>$path</code> The current website root path.
Expected return: 
– (string) The (possibly altered) website root path.
Filter to supply the correct website root path in case of non-standard setups.
<pre><code>acato_email_essentials_development_tlds
</code></pre>
Parameters: 
– (array) <code>$tlds</code> Array of top-level domains considered as development environments.
Expected return: 
– (array) The (altered) array of development TLDs.
Filter to modify which TLDs are treated as development/local environments. Default values are ‘local’ and ‘test’.
<h3>Scripts/styles</h3>
In the <code>public/scripts</code> and <code>public/styles</code> folder you find the JS and CSS files used in the plugin admin area. 
These files are processed with Webpack, just so it works in all recent browsers. Script is nearly identical to the source.
You can find the source files in the <code>src/scripts</code> and <code>src/styles</code> folders.
If you feel the need to modify these files, you can change them there, and run <code>npm install ; npm run build</code> to create the production files.
<h3>Translation files</h3>
You can use <code>npm run i18n</code> to generate the POT file for translation, update the PO files in the <code>languages</code> folder, and compile to MO/php files. 
This is a one-task-does-all; run it, change the translations, run it again. Done. 
See package.json for more details or individual commands.
<h3>Tools</h3>
In the <code>tools</code> folder you will find a script to generate DKIM keys, should you want to use DKIM signing. 
rename to remove the .txt extension and run it in a shell.
Tools are provided as-is, without support. Use at your own risk. Read the scripts before using them.
You DO NOT HAVE TO USE these scripts, you can generate DKIM keys with any tool you like.
<h3>Arbitrary section</h3>
For advanced configuration and custom IP services, see the plugin documentation or source code.

Email Essentials

A plugin to make WordPress outgoing emails better and less likely to be marked as spam.

Mail Doctor vs Email Essentials