=== SMTP (by ROBOTSTXT) ===
Contributors: javiercasares
Tags: smtp, email, mail
Requires at least: 5.9
Tested up to: 7.1
Stable tag: 2.2.3
Requires PHP: 8.0
Version: 2.2.3
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Send every site email through a fully configurable SMTP server managed from the WordPress dashboard.

== Description ==

SMTP (by ROBOTSTXT) replaces WordPress' native mail delivery with a secure SMTP connection and detailed guidance. The plugin is built for marketing teams, agencies, and technical departments that need a clear, complete solution ready for multisite installations.

= Guided PHPMailer configuration =

* Routes `wp_mail()` through PHPMailer in SMTP mode with support for credentials, custom ports, and the `None`, `SSL`, or `TLS` encryption methods.
* Adds inline help text with practical examples in every field: host, port, username, password, sender email, and sender name.
* Automatically changes the port when it matches the default value for the selected encryption type (25, 465, or 587).
* Lets you set default sender information for the site to keep a consistent identity across outgoing messages.

= Tools for support and marketing teams =

* **Settings → SMTP → Test** screen for sending manual test emails and confirming the connection to the server.
* **Tools** panel packed with diagnostics: automatic MX lookup, SPF/DKIM/DMARC checks, extended SMTP server diagnostics, and DNS reputation monitoring.
* Caches results from each tool for 24 hours (with a manual refresh option) to streamline recurring tasks for your team.

= Comprehensive delivery logs =

* Saves the subject, recipients, headers, content, and attachments for every email sent.
* Browse logs from **Settings → SMTP → Logs** with pagination and access to the details of each delivery.
* Configure automatic cleanup by maximum entries or age in days, plus an instant "Clear all" button to wipe the history.

= Multisite-ready configuration =

* Choose whether the configuration applies to the entire network or individually per site.
* Dedicated forms in both the network dashboard and each site to edit, test, and share credentials securely.

== Installation ==

1. Upload the plugin folder to `wp-content/plugins/`.
2. Activate **SMTP (by ROBOTSTXT)** from the **Plugins** menu in the WordPress dashboard.
3. Open **Settings → SMTP** (or **Network Settings → SMTP** in multisite) to enter your connection details.

== Frequently Asked Questions ==

= Do I need credentials to send email? =

Enter a username and password only if your provider requires them. If the server accepts unauthenticated delivery, leave the fields blank and the plugin will send without credentials.

= Which encryption should I use? =

Select `None`, `SSL`, or `TLS` according to your provider's documentation. When you switch encryption, the plugin will automatically suggest the recommended port if you are using one of the standard values.

= How can I review the emails that were sent? =

Enable logging on the settings page and visit **Settings → SMTP → Logs** to open the paginated table of saved emails. From there you can inspect each entry, download attachments, and delete records.

= Does it work on a multisite network? =

Yes. From the network dashboard you can decide whether the configuration is global or site-specific. You can also run the tools and send test emails from the network or from each individual site.

== Compatibility ==

* WordPress: 5.9 - 7.1
* PHP: 8.0 - 8.5

== Changelog ==

= 2.2.3 =

_Release date: 2026-06-09_

**Fixed**

* Fixed the DKIM "Try selector" form submitting to a non-existent page in Network Admin. The form was building the page slug as `robotstxt-smtp-network-tools` instead of the correct `robotstxt-smtp-tools` (which is shared between site and network contexts).

**Compatibility**

* WordPress: 5.9 - 7.1
* PHP: 8.0 - 8.5

= 2.2.2 =

_Release date: 2026-06-09_

**Fixed**

* Fixed From Email and Reply-To Email not clearing when submitted empty.
* Fixed "Clear password" button having no effect due to `sanitize_option` callback re-applying the old password.
* Fixed "Clear password" submitting to `options.php` instead of the correct handler (nested form issue).
* Fixed DKIM "Try selector" button doing nothing (`wp_kses_post()` stripped the form elements).
* Fixed Spamhaus ZEN reporting a false "Listed" result for `127.255.255.254` (open-resolver error code, not a real listing).

**Added**

* DKIM selector auto-detection from MX records (Google Workspace, Microsoft 365, Zoho, ProtonMail, iCloud, Aruba, Mailchimp).
* "Try a specific selector" input in Tools → Authentication.
* Password field placeholder now reflects whether a password is stored.

**Compatibility**

* WordPress: 5.9 - 7.1
* PHP: 8.0 - 8.5

= 2.2.1 =

_Release date: 2026-06-09_

**Fixed**

* Fixed the statistics chart not rendering. Chart.js initialization now uses `wp_add_inline_script()` to guarantee correct script load order.
* Chart.js is now bundled locally — no external CDN requests.

**Compatibility**

* WordPress: 5.9 - 7.1
* PHP: 8.0 - 8.5

= 2.2.0 =

_Release date: 2026-06-09_

**Fixed**

* Fixed passwords with special characters (`<`, `>`, newlines) being silently corrupted on save.
* Fixed credential mask displaying literal text instead of bullet characters in the test email panel.
* Fixed decrypted credentials being stored in temporary transients.
* Fixed DMARC tool: implements RFC 7489 §6.6.3 organizational domain fallback.
* Fixed rate-limit enforcement now short-circuits `wp_mail()` immediately.
* Fixed DKIM/DMARC DNS lookups use the timeout-protected wrapper.
* Fixed rate-limit transients removed on uninstall.

**Compatibility**

* WordPress: 5.9 - 7.1
* PHP: 8.0 - 8.5

= 2.1.0 =

_Release date: 2026-02-09_

**Added**

* Data management option to control whether plugin data is deleted on uninstall (disabled by default).
* Reset plugin data functionality with site-level and network-level support.

**Compatibility**

* WordPress: 6.5 - 6.9
* PHP: 8.2 - 8.4

= Previous versions =

For the full changelog visit [changelog.txt](https://git.robotstxt.es/ROBOTSTXT/robotstxt-smtp/raw/branch/main/changelog.txt).

== Compliance ==

This plugin adheres to the following security measures and review protocols for each version:

* [WordPress Plugin Handbook](https://developer.wordpress.org/plugins/)
* [WordPress Plugin Security](https://developer.wordpress.org/plugins/wordpress-org/plugin-security/)
* [WordPress APIs Security](https://developer.wordpress.org/apis/security/)
* [WordPress Coding Standards](https://github.com/WordPress/WordPress-Coding-Standards)