ZDN Whitelist Outgoing Email
| 开发者 | cuongquach |
|---|---|
| 更新时间 | 2026年7月15日 00:13 |
| 捐献地址: | 去捐款 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.0 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
ZDN Whitelist Outgoing Email prevents WordPress from accidentally sending emails to real users in development or staging environments, and keeps a searchable log of everything that left the site.
Filtering is off by default after activation so a live site is not affected until you enable it. When filtering is on and the allowlist is empty, every recipient is redirected to the fallback address.
Features
- Whitelist-based filtering — only allowed email addresses receive emails.
- Wildcard domain support — allow entire domains with
*@example.com. - Fallback replacement — non-whitelisted recipients are replaced with your fallback address.
- Traceability — the original email is preserved in the display name (e.g.,
user@external.com <fallback@site.com>). - Outgoing email logger — capture To, subject, body, headers, attachments, and errors in a custom table.
- Filtered badge — logs show when the whitelist rewrote recipients and what the original address was.
- View / resend / delete — inspect HTML or raw bodies, resend a message, or clean up bulk rows.
- Retention rules — auto-prune by max row count and/or age.
- Highest priority filter — hooks at
PHP_INT_MINso filtering runs before any other mail plugin; logging runs last atPHP_INT_MAX. - CC/BCC filtering — also filters CC and BCC headers.
- PHP error log option — optionally log replacements to the PHP error log.
- Development environments where you don't want emails going to real customers.
- Staging sites that mirror production data.
- QA testing where only testers should receive emails.
- Debugging which plugin sent which email (and whether it was filtered).
安装:
- Upload the
zdn-whitelist-outgoing-emailfolder to/wp-content/plugins/, or install the release zip via Plugins → Add New → Upload Plugin. - Activate the plugin through the Plugins menu. Filtering starts disabled.
- Go to Outgoing Email → Whitelist.
- Set your fallback email address.
- Optionally add allowed email addresses (one per line). Leave empty to send all outgoing emails to the fallback when filtering is enabled.
- Enable filtering when you are ready.
- Browse captured mail under Outgoing Email → Email Logs.
常见问题:
Will this break mail on a production site after I activate it?
No. Filtering is off by default. Mail is only rewritten after you enable filtering in settings.
What happens if filtering is on but the allowlist is empty?
Every To, Cc, and Bcc recipient is replaced with the fallback address. That is intentional for staging clones of production data.
Does resending a log send a real email?
Yes. Resend calls wp_mail again. If filtering is still enabled, recipients are filtered again. Only users who can manage options can resend.
Where are email logs stored?
In a custom database table ({prefix}zdnwhoue_email_logs) on your site. Nothing is sent to third-party servers by this plugin.
更新日志:
1.1.2
- Fix email log detail modal contrast: design tokens now apply on the modal (not only the page wrap) so meta fields and Raw/HTML message views stay readable.
- Prefix all public PHP identifiers (classes, functions, options, hooks, script handles) with
zdnwhoue/ZDNWHOUEfor WordPress.org uniqueness guidelines. - Keep WordPress.org banner/icon assets out of the distributable plugin zip (SVN assets only).
- Initial release: whitelist-based outgoing email filtering with wildcard domain support (
*@example.com). - Replace non-whitelisted To/Cc/Bcc recipients with a fallback address while preserving the original in the display name.
- Hooks at
PHP_INT_MINso filtering runs before other mail plugins. - Filtering defaults off after activation for safer installs; empty allowlist redirects all recipients when filtering is on.
- Optional PHP error-log entries when a recipient is replaced.
- Outgoing email logger (custom table, list table, detail modal with HTML/raw views).
- Track whitelist rewrites on each log row (original recipient + Filtered badge).
- Logging settings: enable/disable, max logs, age-based retention.
- Resend, bulk delete, search, and status views (sent / failed / filtered).
- Top-level Outgoing Email admin menu with branded UI.
- Privacy policy helper content and uninstall cleanup of logs/options.