{"id":50142402,"url":"https://github.com/adamjohnlea/leastudios-mailer","last_synced_at":"2026-05-24T02:04:58.736Z","repository":{"id":359407337,"uuid":"1224188253","full_name":"adamjohnlea/leastudios-mailer","owner":"adamjohnlea","description":"Lightweight Amazon SES email transport for WordPress. Routes every wp_mail() through SES, logs every send, and tracks bounces/complaints/deliveries via SNS webhooks.","archived":false,"fork":false,"pushed_at":"2026-05-22T00:11:12.000Z","size":171,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T03:25:01.065Z","etag":null,"topics":["mysql","php","wordpress","wordpress-plugin"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adamjohnlea.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-29T03:28:29.000Z","updated_at":"2026-05-22T00:11:16.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/adamjohnlea/leastudios-mailer","commit_stats":null,"previous_names":["adamjohnlea/leastudios-mailer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/adamjohnlea/leastudios-mailer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamjohnlea%2Fleastudios-mailer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamjohnlea%2Fleastudios-mailer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamjohnlea%2Fleastudios-mailer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamjohnlea%2Fleastudios-mailer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adamjohnlea","download_url":"https://codeload.github.com/adamjohnlea/leastudios-mailer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adamjohnlea%2Fleastudios-mailer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33418555,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T22:14:44.296Z","status":"online","status_checked_at":"2026-05-24T02:00:06.296Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["mysql","php","wordpress","wordpress-plugin"],"created_at":"2026-05-24T02:04:58.673Z","updated_at":"2026-05-24T02:04:58.728Z","avatar_url":"https://github.com/adamjohnlea.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# leaStudios Mailer\n\nLightweight Amazon SES email transport for WordPress. Routes every `wp_mail()` through SES, logs every send, and tracks bounces/complaints/deliveries via SNS webhooks.\n\n- **Requires WordPress:** 6.4+\n- **Requires PHP:** 8.1+\n- **License:** GPL-2.0-or-later\n\n## Features\n\n- **Amazon SES via REST API** — no SMTP configuration required.\n- **Email logging** — every send is logged with recipient, subject, status, and SES message ID.\n- **Delivery tracking** — configure an SNS webhook to receive bounce/complaint/delivery events; status updates flow into the email log.\n- **Health check** in the admin — verify your SES configuration and send a test email.\n- **Encrypted credentials** at rest (libsodium).\n- **Configurable log retention** with automatic cleanup.\n\n## How it works\n\nThe plugin hooks into WordPress's `pre_wp_mail` filter to intercept outgoing emails. When SES is enabled, mail goes through the SES API; when disabled or on error, it falls back to the default WordPress transport.\n\n## Installation\n\n1. Upload `leastudios-mailer` to `/wp-content/plugins/`.\n2. Activate via Plugins → Installed Plugins.\n3. Go to **Mailer** in the admin menu, enter AWS credentials (Access Key, Secret, Region) and the verified From address.\n4. Enable SES and send a test email.\n5. Optionally configure an SNS webhook (URL shown on the settings page) for delivery tracking.\n\n## Related plugins\n\nThis plugin is part of the leaStudios plugin family. It works on its own, and integrates with:\n\n- **[leastudios-email-templates](../leastudios-email-templates)** — when active, the template wrapper hooks into the mailer pipeline so branded emails go through SES with full delivery tracking.\n- **[leastudios-forms](../leastudios-forms)** — form notification deliveries are tracked per submission when the mailer is active.\n- **[leastudios-payments](../leastudios-payments)** — payment receipts and subscription emails benefit from SES delivery + logging.\n\n## Development\n\nThis plugin is self-contained — it can be cloned, linted, tested, and packaged on its own.\n\n```bash\ncomposer install            # install dependencies (incl. dev tools)\ncomposer lint               # phpcs + phpstan\ncomposer test               # phpunit (requires the WP test library)\ncomposer phpcbf             # auto-fix WPCS issues\n```\n\nTo run the test suite, install the WordPress test library once:\n\n```bash\nbash ../leastudios-dev-tools/bin/install-wp-tests.sh wordpress_test root '' localhost latest\n```\n\nThe shared scaffold, packaging script, and project-wide development conventions live in **[leastudios-dev-tools](../leastudios-dev-tools)** — start there when bootstrapping a new plugin or making cross-plugin tooling changes.\n\n## License\n\nGPL-2.0-or-later. See `readme.txt` for the WordPress.org-style header.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamjohnlea%2Fleastudios-mailer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadamjohnlea%2Fleastudios-mailer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadamjohnlea%2Fleastudios-mailer/lists"}