MailerHelper

Type
Class
Namespace
craft\helpers
Inherits
craft\helpers\MailerHelper
Since
3.0.0

Class MailerHelper

View source (opens new window)

# Public Methods

Method Description
allMailerTransportTypes() Returns all available mailer transport adapter classes.
createMailer() Creates a mailer component based on the given mail settings.
createTransportAdapter() Creates a transport adapter based on the given mail settings.
normalizeEmails() Normalizes To/From/CC/BCC values into an array of email addresses, or email/name pairs.
settingsReport() Returns a report of the settings used for the given Mailer instance.

# allMailerTransportTypes()

Returns all available mailer transport adapter classes.

View source (opens new window)

Returns

string (opens new window)[]

# createMailer()

DEPRECATED

Deprecated in 3.0.18. Use craft\helpers\App::mailerConfig() instead.

Creates a mailer component based on the given mail settings.

View source (opens new window)

Arguments

Returns

craft\mail\Mailer

# createTransportAdapter()

Creates a transport adapter based on the given mail settings.

View source (opens new window)

Arguments

Returns

craft\mail\transportadapters\TransportAdapterInterface

Throws

# normalizeEmails()

Since
3.5.0

Normalizes To/From/CC/BCC values into an array of email addresses, or email/name pairs.

View source (opens new window)

Arguments

Returns

array (opens new window), null (opens new window)

# settingsReport()

Since
3.5.0

Returns a report of the settings used for the given Mailer instance.

View source (opens new window)

Arguments

Returns

string (opens new window)

# Events

# EVENT_REGISTER_MAILER_TRANSPORT_TYPES

Type
craft\events\RegisterComponentTypesEvent

The event that is triggered when registering mailer transport adapter types.

Mailer transports must implement craft\mail\transportadapters\TransportAdapterInterface. craft\mail\transportadapters\BaseTransportAdapter provides a base implementation.

Example

use craft\events\RegisterComponentTypesEvent;
use craft\helpers\MailerHelper;
use yii\base\Event;

Event::on(MailerHelper::class,
    MailerHelper::EVENT_REGISTER_MAILER_TRANSPORT_TYPES,
    function(RegisterComponentTypesEvent $event) {
        $event->types[] = MyTransportType::class;
    }
);