=== SMTP (by ROBOTSTXT) Amazon SES ===
Contributors: javiercasares
Tags: amazon-ses, smtp, email, mail
Requires at least: 6.5
Tested up to: 6.9
Stable tag: 2.1.2
Requires PHP: 8.2
Version: 2.1.2
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.

= Are my credentials validated? =

The plugin validates Amazon SES credentials during saving to prevent misconfigurations. Errors appear directly on the SMTP settings page if authentication fails.

= Does the plugin support multisite? =

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

== Changelog ==

= 2.1.2 =
* Fixed charset encoding issue that caused "expected parameter value, got null" error when sending emails through Amazon SES.
* Added robust charset validation in header parsing to prevent empty or invalid charset values.
* Enhanced charset handling with fallback to UTF-8 when no valid charset is provided.

= 2.1.1 =
* Added comprehensive Amazon SES debug context to test email error reports.
* Debug information now includes: AWS region, masked access key, SDK version, endpoint URL, and UTC timestamp.
* Enhanced AWS error reporting with request IDs, HTTP status codes, and error codes for easier troubleshooting.
* Improved security by masking access keys in error output (shows only first 4 and last 4 characters).

= 2.1.0 =
* Changed uninstall behavior: plugin no longer performs cleanup on uninstall, all data cleanup is now handled by the core SMTP plugin.
* This ensures Amazon SES credentials are preserved when only the add-on is removed, and properly cleaned when the core plugin is uninstalled.

= 2.0.1 =
* Version bump for maintenance release.

= 2.0.0 =
* Added Reply-To header support for emails sent via Amazon SES.
* Improved error handling and validation.
* Enhanced compatibility with core SMTP plugin 2.0.0.
* **BREAKING CHANGE**: Minimum PHP version increased to 8.2 (required by AWS SDK for PHP).

= 1.0.0 =
* Initial release.