VR SMTP Mailer
| 开发者 | vinodkram |
|---|---|
| 更新时间 | 2026年4月11日 21:25 |
| PHP版本: | 6.2 及以上 |
| WordPress版本: | 6.9 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
VR SMTP Mailer replaces the default WordPress mail transport with SMTP or an OAuth-based mail API, with full support for Microsoft 365 (Office365), Outlook SMTP, and Microsoft Graph API.
It is designed as a complete email solution for WordPress — combining SMTP delivery, OAuth authentication, and API-based sending in a single plugin, without requiring multiple paid extensions.
安装:
- Upload the
vr-smtp-mailerfolder to the/wp-content/plugins/directory. - Activate the plugin through the "Plugins" menu in WordPress.
- Go to VR SMTP Mailer → Settings to configure:
- Choose provider (SMTP or Graph OAuth mail).
- Enter SMTP host, username, password, and port, or tenant ID, client ID, and client secret for OAuth.
- Set From Email and From Name.
- Enable Debug Mode if desired.
- For Graph OAuth mail:
- Save settings, then click Sign in to connect and complete the OAuth consent.
- Add the Authorization Redirect URI shown on the settings page to your cloud identity app registration (for example
https://yoursite.com/vr-smtp-mailer-oauth). Legacy paths/vr-smtp-oauthand/m365-mailer-oauthstill work if you registered those URLs earlier. - Use VR SMTP Mailer → Test Email to verify sending.
- Use VR SMTP Mailer → SMTP Tester to verify SMTP connectivity.
常见问题:
Does this plugin replace the default wp_mail behavior?
Yes. Emails are queued and delivered via the configured provider (SMTP or Graph OAuth mail) using WP-Cron.
Does it require WP-Cron to be enabled?
Yes. The queue worker runs on a custom five-minute cron schedule.
Why does the readme list “vinodkram” under Contributors?
WordPress.org uses contributor profile usernames (slugs), not display names. List your WordPress.org username exactly as it appears in your profile URL (https://profiles.wordpress.org/username/).
What should Plugin URI and Author URI use?
For this plugin, Plugin URI is the WordPress.org directory page: https://wordpress.org/plugins/vr-smtp-mailer/ (slug vr-smtp-mailer, same as the Text Domain and the plugin directory name). Author URI is https://profiles.wordpress.org/vinodkram/. If your approved slug on WordPress.org ever differs, update the Plugin URI in the main PHP file header to match https://wordpress.org/plugins/{your-slug}/. Avoid URLs that could be mistaken for an official vendor or Microsoft property.
What about banners and icons?
Do not use Microsoft, Windows, Office, Azure, or other vendors’ logos, trademarks, or trade dress in your WordPress.org banner, icon, or screenshots. Use your own branding and neutral artwork.
更新日志:
1.0.10
- WordPress.org slug: Public plugin slug and directory name
vr-smtp-mailer. Text domainvr-smtp-mailer; PHP prefixVR_SMTP_MAILER_and option/hook prefixvr_smtp_mailer_; admin screen and asset handles use thevr-smtp-mailer-*pattern. - OAuth redirect: Canonical path
/vr-smtp-mailer-oauth;/vr-smtp-oauthand/m365-mailer-oauthremain supported for existing app registrations. - Migration: On upgrade, copies options and renames custom tables from prior
vr_smtp_*keys/names when needed; clears legacyvr_smtp_process_queuecron in favor ofvr_smtp_mailer_process_queue. - Bootstrap file: Main plugin file is
vr-smtp-mailer.php.
- wp_mail-style delivery: Mailers now receive full
pre_wp_mailarguments—headers (From, Cc, Bcc, Reply-To, Content-Type, custom headers on SMTP), attachments, and embeds—so immediate sends align much more closely with corewp_mail(). SMTP path runsphpmailer_initand standardwp_mail_*filters. - Graph sendMail: Maps To/Cc/Bcc/Reply-To, HTML vs plain text, attachments, and inline embeds (per-file size limit for base64 payload); documents Graph vs SMTP differences in the readme.
- OAuth: Admin-only (
manage_options) token exchange on both the admin callback and the pretty redirect URL; non-admins are redirected back to settings with an error. - Readme: Expanded Description—
wp_mailparity, Graph limits, queue storage limits, credential storage disclosure.
- Requires WordPress 6.2+ for
%iidentifier placeholders in$wpdb->prepare()(debug log queries). Database calls use prepared statements without raw$sqlvariables.
- Text Domain and all
__()/esc_html__()calls usevr-smtpto match the WordPress.org plugin directory slug.VR_SMTP_PLUGIN_SLUGisvr-smtp. OAuth redirect URI is/vr-smtp-oauth;/vr-smtp-mailer-oauthand/m365-mailer-oauthremain supported for existing Azure app registrations.
- Restored Text Domain and
VR_SMTP_PLUGIN_SLUGtovr-smtp-mailer. Canonical OAuth redirect path is/vr-smtp-mailer-oauth;/vr-smtp-oauthand/m365-mailer-oauthremain supported for existing app registrations. For WordPress.org, the plugin directory name must match the text domain (use thevr-smtp-mailerfolder).
- Text domain and
VR_SMTP_PLUGIN_SLUGaligned with the plugin directory slugvr-smtp(WordPress.org requirement). OAuth redirect URI is/vr-smtp-oauth;/vr-smtp-mailer-oauthand/m365-mailer-oauthremain supported for existing app registrations.
- Readme: documented third-party and external services (Microsoft identity OAuth, Microsoft Graph, user-configured SMTP); what data is sent and when; links to terms and privacy policies.
- Readme: contributor field uses WordPress.org username; Plugin URI / Author URI point to WordPress.org; tags and marketing copy reduced unnecessary trademark use; clearer disclaimer and asset guidance.
- Admin: “Authorize Microsoft” replaced with neutral “Sign in to connect”; Graph section labels softened while keeping technical behavior unchanged.
- Text domain
vr-smtp-mailer(matches plugin slug). All__(),_e(),esc_html__(), and related calls updated;load_plugin_textdomain()loads translations from/languages. - Plugin directory slug is
vr-smtp-mailer(wasvr-smtp). OAuth redirect URI is/vr-smtp-mailer-oauth;/vr-smtp-oauthand/m365-mailer-oauthremain supported for existing Azure app registrations.
- Renamed plugin to VR SMTP (directory
vr-smtp, text domainvr-smtp). Migration preserves settings and renames database tables from the previous release. - OAuth callback accepts the legacy
/m365-mailer-oauthpath for existing Azure redirect URIs.
- Initial release.