=== SMTP (by ROBOTSTXT) ===
Contributors: robotstxt
Tags: smtp, email, mail
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 1.2.0
License: GPLv3 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.

== Changelog ==

= 1.2.0 =

* Logged failed email deliveries with status and error details in the log list and detail views.
* Captured the SMTP debug conversation for each email and surfaced it inside the log detail view.

= 1.1.0 =

* Added Amazon SES credential fields, regional selection, and live validation helpers that appear when the Amazon SES add-on is active.
* Introduced the `robotstxt_smtp_sanitized_options` filter so add-ons can adjust sanitized settings before they are stored.
* Routed SMTP test messages and regular WordPress emails through Amazon SES whenever the add-on supplies valid credentials.

= 1.0.0 =

* Contextual help guidance in every SMTP configuration field.
* Automatic port updates when selecting an encryption method with standard values.
* Advanced tools: MX analysis, SPF/DKIM/DMARC validation, extended SMTP diagnostics, and blacklist monitoring.
* Enhanced logging with automatic cleanup by limit or age.
* Updated documentation for the 1.0.0 release with WordPress 6.7 and PHP 8.2 support.