SwiftTrap for Mailtrap

변경이력

3.0.1

• Fixed: Webhook receiver now verifies Mailtrap’s actual Mailtrap-Signature HMAC-SHA256 header instead of a header Mailtrap never sends. Every real delivery-tracking webhook call was being rejected outright since the feature shipped in 2.4.0.
• Fixed: Webhook payload parsing now unwraps Mailtrap’s {"events": [...]} envelope correctly, so verified events reach do_action('swifttrap_mailtrap_webhook_event', ...).
• Fixed: Usage card on the Stats page now calls Mailtrap’s current /api/billing/usage endpoint instead of a stale account-scoped path that returned no data.
• Fixed: Uninstalling the plugin now clears the actual cached transients instead of pre-2.3.0 key names that no longer match.
• Improved: Email Logs recipient search and account API calls now consistently use bracketed filter syntax and Bearer-token authentication.

3.0.0

• Breaking: Removed all local file-based email logging. No more log files written to disk — eliminates OOM/disk-full risk on high-volume sites.
• New: Email Logs panel on the Stats page pulls live data directly from the Mailtrap API (GET /api/email_logs).
• New: Email Logs support filtering by recipient email address, delivery status, and date range.
• New: Client-side pagination — buffers up to 1,000 entries from Mailtrap per API call, displays 20 rows at a time with Prev/Next navigation. Automatically fetches the next batch when the buffer is exhausted.
• New: Webhook handler now fires do_action('swifttrap_mailtrap_webhook_event', $event) for every delivery event, allowing third-party integrations without modifying the plugin.
• Removed: CSV export, log file clear, log detail modal, log resend, per-page logs setting, and cron-based log cleanup. All replaced by the live API view.
• Fixed: Stats page no longer creates a redundant nonce attribute on the wrapper element.

2.4.2

• Fixed: The email log dropped most entries during high-volume or concurrent sends. Each write re-read and rewrote the whole log file, so parallel processes overwrote each other’s lines. Writes now use an atomic, exclusively-locked append, so the Stats dashboard (sends-per-day, categories, totals) reflects the real number of sent emails.
• Improved: Logging no longer slows down large mailings — appends are O(1) instead of re-reading and rewriting the entire file on every email.

2.4.1

• Fixed: Suppression list now reads the Mailtrap type field, so the dashboard shows real BOUNCE / COMPLAINT / UNSUBSCRIBE / MANUAL counts instead of marking every record as manual.
• New: Suppression rows display the message bounce category (when provided) for hard-bounce detail.
• Fixed: Suppression dates are now formatted server-side using the site’s date format instead of the browser locale.
• New: “View all in Mailtrap” link on the Suppressions card.
• New: Per-page selector (10/25/50/100) on the Email Logs screen.
• Improved: Email Logs header actions aligned to the right; date filter input restyled to match other fields.

2.4.0

• New: REST Webhook Endpoint (swifttrap/v1/webhook) for tracking delivered, bounced, opened, and clicked statuses.
• New: Suppression Management CRUD in Admin Stats and pre-send recipient checks to skip suppressed emails.
• New: Fallback mechanism returning null in pre_wp_mail on API failure so native wp_mail sends the email instead.
• New: Site Health connection and verified domain status test.
• New: Upgraded Admin logs UI with search, filtering, CSV export, iframe payload preview modals, and resend actions.
• New: Category settings grid for category stream mapping rules and sender overrides.
• New: WP-CLI namespace wp swifttrap (test, stats, prune-logs, send-suppression-sync).
• New: Attachment size guard setting.
• Refactored: Extracted CSV row formatter into a helper function for unit tests. Fully covered and verified by the test suite.

2.3.0

• PHP 8.0 is now the minimum; tested up to WordPress 7.0.
• Reliability: automatic retry with backoff on transient Mailtrap API errors (429/5xx, honors Retry-After).
• Deterministic log retention via a daily cron event (replaces the previous probabilistic cleanup).
• Account/stats/domain/suppression caches are now keyed per API token, so switching tokens no longer serves stale data.
• Robust JSON handling for all Mailtrap API responses; multisite-safe settings cache.
• New: “Verify token” button on the settings screen.
• Code modernized to PHP 8 idioms; first unit-test suite added.

2.2.2

• Plugin URI: now points to the dedicated landing page at https://plugins.symonov.com/swifttrap-for-mailtrap/
• No code or behavior changes

2.2.1

• Readme: USP-first rewrite emphasizing Mailtrap Email API (vs SMTP) and bulk/transactional stream routing
• Tags: replaced email/mail/smtp with targeted mailtrap, transactional-email, email-api, wp-mail, email-log
• FAQ: added comparison with WP Mail SMTP / Post SMTP, Mailtrap template support, and bulk stream routing
• Tested up to WordPress 7.0

2.2.0

• Replaced all file_get_contents/file_put_contents with WP_Filesystem API
• Fixed $_GET sanitization with proper wp_unslash() and phpcs annotations
• Improved PHPDoc headers across all files
• Better WordPress Coding Standards compliance

2.1.0

• Added sending domain verification status on Stats page
• Added suppression list (bounces, complaints, unsubscribes) on Stats page
• Added swifttrap_mailtrap_template filter for Mailtrap template support
• Added swifttrap_mailtrap_custom_variables filter for email tracking metadata
• Extracted reusable swifttrap_mailtrap_get_account_id() with transient caching

2.0.0

• Removed Mailtrap SDK dependency — uses WordPress HTTP API directly
• Zero external dependencies, ~30 KB total plugin size
• Improved WP.org compliance

1.3.0

• Security: protected log directory from direct web access
• Added attachment size validation (25 MB limit)
• Added empty recipient validation
• Fixed timezone handling in log display
• Optimized email category computation
• Improved log file locking