=== WPO365 | MICROSOFT 365 GRAPH MAILER === Contributors: wpo365 Tags: mail, email, smtp, phpmailer, wp_mail, Office 365, O365, Microsoft 365, M365, Exchange Online, Microsoft Graph, sendMail, azure active directory, Azure AD, AAD Requires at least: 5.0 Tested up to: 6.0 Stable tag: 2.4 Requires PHP: 5.6.40 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html == 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. = 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*. = 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. == ADD FUNCTIONALITY WITH EXTENSIONS == The following features can be unlocked with the [WPO365 | MAIL](https://www.wpo365.com/downloads/wpo365-mail/) extension. = 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. = MULTIPLE 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 AUDIT / RESEND = - **Log every email** sent from your WordPress website, review errors and try to send unsuccessfully **sent mails again**. = 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 (Office 365) 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 [Twitter](https://twitter.com/WPO365) 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 == = v2.4 = * Fix: Mail authorization would fail with the error "Could not retrieve a tenant and application specific JSON Web Key Set and thus the JWT token cannot be verified successfully". = v2.3 = * Fix: The delegated mail authorization feature would - under circumstances - fail to get the mail specific tenant ID and as a result an attempt to refresh the access token may fail. = v2.2 = * Fix: The Redirect URL field for the mail authorization is no longer greyed out and can be changed by administrators. [LOGIN] = 2.1 = * Fix: Added missing files. = 2.0 = * Change: Sending WordPress emails using Microsoft Graph can now also be configured with **delegated** permissions. Administrators are urged to review the (documentation)[https://docs.wpo365.com/article/141-send-email-using-microsoft-graph-mailer] and to update their configuration. [LOGIN, MICROSOFT GRAPH MAILER] * Feature: Azure Active Directory secrets can now be stored in the website's **WP-Config.php** and removed from the database. [MAIL] = 1.8 = * Fix: If the plugin is configured to send WordPress emails using Microsoft Graph then it will now always replace the "from" email address if WordPress tries to sent emails from "wordpress@[sitename]". WordPress will propose this email address is no email is set by the plugin sending the email (e.g. Contact Form 7). This email may pass checks as a valid email address but in reality this email address most likely does not exist. The option to fix the "localhost" issue has been removed since this fix improves the behavior for all hosts (incl. localhost). [ALL] = 1.7 = * Improvement: When specified in - for example - an email form the "From" address will be used to send the email from (instead of the configured "From" address and if the address specified in the form appears to be valid). This behavior is a premium feature and not enabled by default. = 1.6 = * Change: Sending mail as HTML is no longer a premium feature. * Change: Saving a sent mail in the Sent Items folder is no longer a premium feature. * Improvement: The Graph Mailer components have been refactored for improved logging / auditing. * Fix: Sending a test email with attachment is now supported by all versions. * Fix: The plugin will not try and send attachments larger than 3 Mb (the prevent the mail being refused by the Microsoft Graph API). = 1.5 = * Fix: Several issues related to PHP 8.x have been fixed. = 1.4 = * Updated README.txt = 1.3 = * Improvement: The plugin will now honor a reply-to email address defined "externally" e.g. when using Contact Form 7. * Fix: Activating the plugin would case a critical error due to a class-loading error. = 1.2 = * Fix: Compatibility update. = 1.1 = * Fix: Some minor code issues were fixed after review. = 1.0 = * Initial version.