=== Mailtrap Email Testing by Volade ===
Contributors: volade
Tags: email, mailtrap, staging, wp_mail, email testing
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later

Capture wp_mail on staging and local — Mailtrap sandbox inbox, capture log, test email, 4 presets and free JSON export.

== Description ==

Mailtrap Email Testing by Volade intercepts WordPress mail on non-production environments and routes it to your [Mailtrap](https://mailtrap.io) Email Testing sandbox — never hitting real inboxes when capture is enabled.

* Mailtrap SMTP or Testing API — credentials from your Mailtrap dashboard
* wp-config overrides — `MTT_API_TOKEN` / `MAILTRAP_API_TOKEN` (no secrets in repo)
* Capture bridge — short-circuits wp_mail when capture mode is on
* Capture log — ring buffer (to, subject, body excerpt, status, time) + view last email
* Test email button with teal/emerald admin theme
* Environment guard — auto-enable capture when `WP_ENVIRONMENT_TYPE` is local/development/staging
* 4 presets: Staging Capture, Mailtrap SMTP, Local Dev, Agency Handoff
* Site Health test, REST `mtt/v1`, WP-CLI `wp mtt`, free JSON export

Complements Resend Email by Volade for production delivery. Works without a Volade account. Connect for REST automation.

== Installation ==

1. Upload the ZIP via Plugins → Add New → Upload
2. Activate Mailtrap Email Testing by Volade
3. Paste Mailtrap sandbox SMTP credentials (or API token + inbox ID)
4. Enable capture mode and send a test email

Optional in wp-config.php:

`define( 'MTT_API_TOKEN', '…' );`
`define( 'MAILTRAP_API_TOKEN', '…' );`

== Frequently Asked Questions ==

= Does this send to real inboxes? =

No — when capture mode is enabled, wp_mail is intercepted. Mail goes to your Mailtrap sandbox or the local capture log only.

= How do I keep secrets out of git? =

Define `MTT_API_TOKEN` or `MAILTRAP_API_TOKEN` in wp-config.php, or enter credentials in wp-admin (masked in UI).

= What does Staging Capture do? =

Forces capture mode and blocks real SMTP — ideal for cloned production sites and WooCommerce staging.

= How is this different from Resend Email by Volade? =

MTT is for Mailtrap Email Testing (sandbox capture). Resend Email routes production transactional mail via the Resend API.

== Changelog ==

= 1.0.0 =
* Initial release — settings, capture bridge, capture log, test email, environment guard, presets, export, REST and WP-CLI.
