Sendelva – Email Delivery for Microsoft 365
| 开发者 | remymazmanian |
|---|---|
| 更新时间 | 2026年10月13日 22:32 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
wp_mail(), such as password resets, form notifications and order emails, through the Microsoft Graph sendMail endpoint with an app-only OAuth token. Messages go out from your real tenant and appear in the sender mailbox's Sent Items.
How it behaves
- Nothing changes until it's configured. While any of the four credentials is missing, WordPress mail works exactly as before.
- Fails safely. With fallback on (the default), a Graph error hands the message back to WordPress's own mailer instead of dropping it. With fallback off, the send fails and
wp_mail_failedfires. - Behaves like WordPress's own mailer. HTML switched on with the
wp_mail_content_typefilter (how WooCommerce and most form plugins do it) or aContent-Typeheader is sent as HTML, andwp_mail_succeededfires after each successful send, so mail logging plugins keep working. - HTML, Cc, Bcc, Reply-To and attachments up to the 3 MB
sendMailrequest limit. Every address in a header such asCc: a@example.com, b@example.comis delivered, display names are kept, and an attachment keyed by name (WordPress 6.2 and newer) is sent under that name. - Mail goes out as the sender mailbox. Microsoft Graph sends as the configured mailbox, so a
Fromheader set by another plugin is ignored. SetReply-Toto send replies elsewhere, such as to a contact form visitor. - Tokens are cached and refreshed two minutes before they expire. A cached token is only used with the credentials it was issued for, and saving the settings clears it. If Microsoft refuses a token, the plugin waits a minute before asking again rather than holding up every email.
- A send log on the settings screen keeps the last 20 messages, successes and failures alike, with Microsoft's error message for any that failed.
- A test message button, a setup checklist that ticks itself off, and a step-by-step Microsoft Entra guide you can show or hide.
- Secrets can stay out of the database. The client secret field is write-only, and all four settings can be defined as constants in
wp-config.phpinstead.
安装:
- Install and activate Sendelva from Plugins > Add New, or upload the
sendelvafolder to/wp-content/plugins/. - In the Microsoft Entra admin center, register an application (single tenant, no redirect URI) and copy its Directory (tenant) ID and Application (client) ID.
- Under Certificates & secrets, create a client secret and copy its value. It's shown only once.
- Under API permissions, add the Microsoft Graph application permission
Mail.Send, then click Grant admin consent. - In WordPress, go to Settings > Sendelva, enter the tenant ID, client ID, client secret and the sender mailbox, and save.
- Send a test message from the same screen and check the send log.
wp-config.php instead. The settings screen labels each value that comes from a constant.
define( 'SENDELVA_TENANT_ID', '...' );
define( 'SENDELVA_CLIENT_ID', '...' );
define( 'SENDELVA_CLIENT_SECRET', '...' );
define( 'SENDELVA_SENDER', 'noreply@example.com' );
The GRAPH_MAILER_* names from before the plugin was renamed still work.屏幕截图:
常见问题:
Do I need an SMTP server or an SMTP password?
No. Sendelva talks to Microsoft Graph over HTTPS with an app-only token. There is no SMTP connection and no mailbox password.
Which Microsoft 365 permission does it need?
The Microsoft Graph application permission Mail.Send, with admin consent. Without consent, Microsoft issues a token but refuses every send, which is the most common setup problem.
Mail.Send as an application permission can send as any mailbox in your tenant. To limit the app to the one mailbox you use, add an Exchange application access policy. Microsoft documents this under "Limiting application permissions to specific Exchange Online mailboxes".
What happens if Microsoft Graph is unavailable?
With fallback on (the default), the message is handed back to WordPress's own mailer and the send log notes that it was. With fallback off, the send fails and WordPress fires wp_mail_failed.
Why is my From address ignored?
Microsoft Graph sends as the configured sender mailbox. A From header added by another plugin can't change that. Use Reply-To to route replies somewhere else.
Does it work with WooCommerce and contact form plugins?
Yes. Anything that sends with wp_mail() goes through Sendelva, and HTML emails stay HTML.
Is there a size limit?
Attachments can total up to 3 MB, the limit of Microsoft Graph's sendMail request. Larger messages fail with a clear error (and fall back to the default mailer if fallback is on).
What does the plugin store?
Its settings (including the client secret, unless you use the wp-config.php constants), a cached access token, and a log of the last 20 messages with each recipient, subject and result. Uninstalling the plugin deletes all of it, on every site of a multisite network.
I used Graph Mailer. How do I switch?
Sendelva is Graph Mailer under a new name. Install and activate Sendelva: the first time it runs it copies Graph Mailer's settings and send log, and GRAPH_MAILER_* constants in wp-config.php keep working. Then deactivate and delete Graph Mailer. While it's still active, Sendelva shows a link to deactivate it.
Does it track me or contact anything other than Microsoft?
No. It makes no requests of its own except to Microsoft's sign-in and Graph services, and only once it's configured. See "External services" below.
更新日志:
- Graph Mailer is now Sendelva. The plugin's folder, main file and text domain are now
sendelva, and its settings screen is under Settings > Sendelva. - Settings and the send log carry over from Graph Mailer automatically, and its
GRAPH_MAILER_*constants inwp-config.phpkeep working. The new names areSENDELVA_*. - While Graph Mailer is still active, Sendelva offers to deactivate it.
- Prepared for the WordPress.org plugin directory: added this readme, made every string translatable, and moved the settings screen's styles and script into enqueued files.
- Added a Settings link on the Plugins screen and suggested privacy policy text under Settings > Privacy.
- The test message result is passed back with a nonce instead of a plain URL parameter.
- The client secret is sanitized like the other settings when it's saved.
- Fixed HTML mail from plugins that use the
wp_mail_content_typefilter, which arrived as raw markup. - Fixed Cc, Bcc and Reply-To headers with several addresses, which lost every address in them.
- Fixed recipients whose quoted display name contains a comma.
- Cached tokens are tied to the credentials they were issued for.
- Added
wp_mail_succeededafter a successful send, attachment names from array keys, and multisite-aware uninstall. - After a token refusal, the plugin waits a minute before asking again.
- First release.