=== WPO365 | MICROSOFT 365 GRAPH MAILER === Contributors: wpo365 Tags: Microsoft, SMTP, Email, wp_mail, PHPMailer Requires at least: 5.0 Tested up to: 6.9 Stable tag: 5.3 Requires PHP: 7.4 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Send WordPress emails from a M365 / Exchange Online Mailbox using Microsoft Graph, leveraging OAuth for authentication which is more secure than SMTP == Description == **WPO365 | MS GRAPH MAILER** provides you with a modern, reliable and efficient way to send WordPress transactional emails from one of your Microsoft 365 / Exchange Online / Mail enabled accounts. The plugin re-configures your WordPress website to send emails using the **Microsoft Graph API** instead of - for example - SMTP. Sending WordPress emails using the **Microsoft Graph API** has become the only available alternative after Microsoft has disabled basic authentication (username and password) over the SMTP protocol. = DELIVERY = - Send WordPress transactional emails from one of your **Microsoft 365 Exchange Online / Mail enabled accounts** using Microsoft Graph instead of - for example - SMTP. - Choose between delegated (send mail as a user) and application-level (send mail as any user) type permissions. - Or: Select either a Microsoft 365 account or a personal Microsoft account, like Hotmail.com or Outlook.com, to send WordPress emails. - Or: Configure [RBAC for Exchange Online](https://learn.microsoft.com/en-us/Exchange/permissions-exo/application-rbac) and authorize as an application but with a limited scope e.g. one specific mailbox. = SEND AS HTML = - Send emails formatted as **HTML**. = SAVE TO SENT ITEMS = - Emails sent will be saved in the account's mailbox in the **Sent Items** folder, further helping to track (successful) mail delivery. = ATTACHMENTS = - Send files from your WordPress website as *attachments*. = WPO365 INSIGHTS = - **See what matters, when it happens** Track key WPO365 events like sent emails with WPO365 Insights [more](https://docs.wpo365.com/article/210-wpo365-insights) = CONFIGURATION / TEST EMAIL DELIVERY = - Easy configuration with detailed step-by-step [Getting started](https://docs.wpo365.com/article/141-send-email-using-microsoft-graph-mailer) guide and video. - Send *test email* to recipients incl. CC, BCC and attachment. https://youtu.be/1CK7Fl8f8iA **ADD FUNCTIONALITY WITH PREMIUM EXTENSIONS** The following features can be unlocked with the [WPO365 | MAIL](https://www.wpo365.com/downloads/wpo365-mail/) extension. = WPO365 INSIGHTS = - Get **WPO35 Alerts** in your inbox when email delivery is failing [more](https://docs.wpo365.com/article/210-wpo365-insights) = Auto-Retry = - **Log every email** sent from your WordPress website, review errors and (automatically) try to send unsuccessfully **sent mails again**. = LARGE ATTACHMENTS = - Add support to send WordPress emails with **attachments larger than 3 MB** using Microsoft Graph. = SEND AS / SEND ON BEHALF OF = - Send email **as / on behalf of** another user or distribution list. = SHARED MAILBOX = - Send email from **Microsoft 365 Shared Mailbox**. = STAGING MODE = - **Mail Staging Mode** is useful for debugging and staging environments. WordPress emails will be logged and saved in the database instead of being sent. = DYNAMIC SEND-FROM = - Allow forms to **override "From"** address e.g allow Contact Form 7 to dynamically configure the account used to send the email from (requires application-level Mail.Send permissions). = MAIL THROTTLE = - **Throttle** the number of emails sent from your website per minute. = WP-CONFIG FOR AAD SECRETS = - Further improve overall security by choosing to store Azure Active Directory secrets in your WordPress WP-Config.php (on disk) and have those secrets removed from the database. = SEND AS BCC = - Send emails **as BCC** instead and prevent reply-to-all mail pollution. = REPLY-TO = - Configure a **default reply-to** mail address if this should differ from the account's mail address that is used to send WordPress transactional emails from. == Prerequisites == - We have tested our plugin with Wordpress >= 5.0 and PHP >= 5.6.40. - You need to be an Entra ID Tenant Administrator to configure both Azure Active Directory and the plugin. == Support == We will go to great length trying to support you if the plugin doesn't work as expected. Go to our [Support Page](https://www.wpo365.com/how-to-get-support/) to get in touch with us. We haven't been able to test our plugin in all endless possible Wordpress configurations and versions so we are keen to hear from you and happy to learn! == Feedback == We are keen to hear from you so share your feedback with us on [LinkedIn](https://www.linkedin.com/company/downloads-by-van-wieren) and help us get better! == Open Source == When you're a developer and interested in the code you should have a look at our repo over at [WordPress](http://plugins.svn.wordpress.org/wpo365-msgraphmailer/). == Installation == Please refer to [these **Getting started** articles](https://docs.wpo365.com/article/141-send-email-using-microsoft-graph-mailer) for detailed installation and configuration instructions. == Frequently Asked Questions == == Screenshots == 1. Configuration page 2. Mail audit log == Changelog == = 5.3 = * Fix: The Mail Log Viewer now reliably displays attachment names without crashing. * Fix: Corrected an issue that could cause a crash while generating client secret expiration warning emails. * Fix: Resolved a "Failed to execute 'querySelector' on 'Document'" error in the wizard app triggered by invalid auto-generated element IDs. = 5.2 = * Fix: Automatically disables SSO when the mail function is invoked in the context of the WPO365 | MICROSOFT GRAPH MAILER plugin (preventing the plugin from logging unconfigured-warnings). [MAILER]. = 5.1 = * Fix: Prevented duplicate or incorrect type attributes on script tags, which could cause "Cannot use import statement outside a module" errors. [MAILER] = 5.0 = * Change: Redesigned the menu of the plugin's Configuration Pages - new with a new vertical navigation, Redesigned the plugin menu with a new vertical navigation, improving clarity and access to features. [ALL] * Improvement: To align with Microsoft’s current branding, Azure AD has been renamed to Microsoft Entra ID throughout the plugin, and all portal links now open in entra.microsoft.com. [ALL] * Fix: Fixed an issue in the stand‑alone WPO365 | MICROSOFT GRAPH MAILER plugin and tested and confirmed compatibility with GCC High tenants. [MAILER] = 4.2 = * Security Fix: A Server Side Request Forgery (SSRF) vulnerability has been patched. [ALL] * Improvement: Confirms support for WordPress 6.9. [ALL] = 4.1 = * Improvement: When emails are successfully sent during a retry, the corresponding error message is removed, and the error count on the WPO365 | INSIGHTS Dashboard is updated accordingly. * Improvement: Sending WordPress emails via Microsoft Graph is now supported for **GCC High tenants**. = 4.0 = * Feature: **See what matters, when it happens** Track key WPO365 events like sent emails with **WPO365 Insights** and get alerted when when a critical WPO365 event occurs. Consult the [updated documentation](https://docs.wpo365.com/article/210-wpo365-insights) for instructions how to configure WPO365 Alerts. [ALL PREMIUM] * Improvement: A new **Daily WPO365 Insights** widget has been added to the WP Admin Dashboard, informing administrator about key WPO365 events like logins, sent emails and user creation and updates. Refer to the [update documentation](https://docs.wpo365.com/article/210-wpo365-insights) for further details or how to hide the widget. [ALL] * Fix: The plugin checks whether the request parameter with the key idp_id was added by WPO365, and ignores it if not. [ALL PREMIUM] * Fix: Addressed various technical problems to enhance plugin reliability. [ALL] = v3.7 = * Fix: WPO365 will avoid using "wp_print_inline_script_tag" and instead create a