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

This private add-on connects the ROBOTSTXT SMTP plugin with Amazon Simple Email Service (SES).

== Description ==

SMTP (by ROBOTSTXT) Amazon SES extends the core ROBOTSTXT SMTP plugin with a first-class Amazon SES transport. Configure the IAM credentials and region once to deliver transactional email securely and reliably through your AWS account. The extension keeps the familiar SMTP plugin interface while enforcing WordPress security best practices, validating credentials, and handling mail routing transparently.

= Key features =

* Authenticate with IAM access and secret keys managed securely inside WordPress.
* Select from all supported Amazon SES regions with automatic discovery of newly available endpoints.
* Send mail using the AWS SDK while preserving the original message structure, headers, and attachments.
* Re-use the ROBOTSTXT SMTP logging tools to audit delivered messages.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/` directory or install the ZIP package via the WordPress admin.
2. Activate the plugin through the **Plugins** screen. The base **SMTP (by ROBOTSTXT)** plugin must remain active.
3. Navigate to **SMTP (by ROBOTSTXT) → Settings** and choose the Amazon SES integration.
4. Provide the IAM access key, secret key, and select your Amazon SES region. Save the settings to verify your credentials.
5. Send a test email from the SMTP settings page to confirm successful delivery.

== Frequently Asked Questions ==

= Do I need the base SMTP plugin? =

Yes. This add-on depends on the core **SMTP (by ROBOTSTXT)** plugin for the settings interface, logging, and overall mail routing logic. If the base plugin is missing or inactive, this add-on will show an admin notice and will not run.

= Are my credentials validated? =

The plugin validates Amazon SES credentials during saving to prevent misconfigurations. Only definitive authentication errors (invalid access key or secret) will block saving. If the IAM user lacks the `ses:GetAccount` permission or there is a network issue, the credentials are still saved and will be used for sending.

= Does the plugin support multisite? =

Yes. Network administrators can manage credentials centrally or allow individual sites to configure their own Amazon SES connection.

== Compatibility ==

* WordPress: 5.7 - 7.1
* PHP: 8.2 - 8.5

== Changelog ==

Only the 3 last versions. The full changelog will be at changelog.txt

= 2.1.6 =

_Release date: 2026-06-09_

**Added**

* Clear buttons for Access Key ID and Secret Access Key on the settings page. When a credential is stored, a "Clear access key" or "Clear secret key" button appears next to the field, allowing immediate removal of the stored value.

**Compatibility**

* WordPress: 5.7 - 7.1
* PHP: 8.2 - 8.5

**Tests**

* PHP_CodeSniffer: 3.13.5
* WordPress Coding Standards: 3.3.0
* PHPCompatibility: 9.3.5
* PHPStan: 2.2.2

= 2.1.5 =

_Release date: 2026-06-09_

**Added**

* Runtime check at initialization: if the parent SMTP (by ROBOTSTXT) plugin is missing or inactive, the plugin skips initialization and displays an admin notice instead of producing a fatal error.

**Fixed**

* Credentials never saving on first entry: credential validation now only blocks saving for definitive authentication failures. All other AWS errors allow saving.
* Reply-to email field cannot be cleared: submitting an empty value now explicitly removes the stored address.

**Compatibility**

* WordPress: 5.7 - 7.1
* PHP: 8.2 - 8.5

**Tests**

* PHP_CodeSniffer: 3.13.5
* WordPress Coding Standards: 3.3.0
* PHPCompatibility: 9.3.5
* PHPStan: 2.2.2

= 2.1.4 =

_Release date: 2026-06-09_

**Changed**

* Minimum WordPress version lowered from 6.5 to 5.7, reflecting the actual code minimum verified by static analysis.

**Compatibility**

* WordPress: 5.7 - 7.1
* PHP: 8.2 - 8.5

**Tests**

* PHP_CodeSniffer: 3.13.5
* WordPress Coding Standards: 3.3.0
* PHPCompatibility: 9.3.5
* PHPStan: 2.2.2

= Previous versions =

If you want to see the full changelog, visit the [changelog.txt](https://git.robotstxt.es/ROBOTSTXT/robotstxt-smtp-amazonses/raw/branch/main/changelog.txt) file.

== 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)
* [Plugin Check (PCP)](https://wordpress.org/plugins/plugin-check/)