Skip to content

Commit

Permalink
prepare for rc.2 release
Browse files Browse the repository at this point in the history
  • Loading branch information
rhukster committed Oct 19, 2022
1 parent c19dd34 commit 71791b7
Show file tree
Hide file tree
Showing 3 changed files with 31 additions and 4 deletions.
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,10 @@
# v4.0.0-rc.2
## 10/19/2022

1. [](#improved)
* Set `sendmail` as default engine to provide better fallback for unsupported `mailer` option
* Added info about available engine plugins in `README.md`

# v4.0.0-rc.1
## 10/05/2022

Expand Down
22 changes: 21 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -42,10 +42,30 @@ The first setting you'd likely change is your `Email from` / `Email to` names an

Also, you'd likely want to setup a SMTP server instead of using PHP Mail, as the latter is not 100% reliable and you might experience problems with emails.

## 3rd Party Plugin Support
## Built-in Engines

By default Email 4.0 supports 4 native engines:

* SMTP - Standard "Simple Mail Transport Protocol" - The default for most providers
* SMTPS - "Simple Mail Transport Protocol Secure" - Not very commonly used
* Sendmail - Uses the built-in `sendmail` binary file available on many Linux and Mac systems
* Native - Uses `sendmail_path` of `php.ini` for Mac + Linux, and `smtp` and `smtp_port` on Windows

Due to the modular nature of Symfony/Mailer, 3rd party engines are supported via Grav plugins.

## 3rd-Party Engines Plugin Support

Along with the **Email** `v4.0` release, there has also been several custom provider plugins released to provide support for `SMTP`, `API`, and sometimes even `HTTPS` support for 3rd party providers such as **Sendgrid**, **MailJet**, **MailGun**, **Amazon SES**, **Mailchimp/Mandrill**, and others! `API` or `HTTPS` will provide a faster email sending experience compared to `SMTP` which is an older protocol and requires more back-and-forth negotiation and communication compared to the single-request of `API` or `HTTPS` solutions.

Examples of the currently available plugins include:

* https://github.com/getgrav/grav-plugin-email-sendgrid - Sengrid Mailer
* https://github.com/getgrav/grav-plugin-email-amazon - Amazon SES
* https://github.com/getgrav/grav-plugin-email-mandrill - Mailchimp Mandrill Mailer
* https://github.com/getgrav/grav-plugin-email-mailersend - Mailersend Mailer

More plugins will be released soon to support `Gmail`, `Mailgun`, `Mailjet`, `OhMySMTP`, `Postmark`, and `SendInBlue`.

## SMTP Configurations for popular solutions:

### Google Email
Expand Down
6 changes: 3 additions & 3 deletions email.php
Original file line number Diff line number Diff line change
Expand Up @@ -166,11 +166,11 @@ protected function sendFormEmail($form, $params, $vars)
public static function getEngines(): array
{
$engines = (object) [
'none' => 'PLUGIN_ADMIN.DISABLED',
'sendmail' => 'Sendmail',
'smtp' => 'SMTP',
'smtps' => 'SMTPS',
'sendmail' => 'Sendmail',
'native' => 'Native'
'native' => 'Native',
'none' => 'PLUGIN_ADMIN.DISABLED',
];
Grav::instance()->fireEvent('onEmailEngines', new Event(['engines' => $engines]));
return (array) $engines;
Expand Down

0 comments on commit 71791b7

Please sign in to comment.