84 lines
4.5 KiB
Text
84 lines
4.5 KiB
Text
=== 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.
|