jorisvaesen/cakephp-sendgrid

Sendgrid wrapper for CakePHP

Sendgrid wrapper for CakePHP

Installation

You can install this plugin into your CakePHP application using composer., _(*1)

The recommended way to install composer packages is:, _(*2)

composer require jorisvaesen/cakephp-sendgrid

Load the plugin in config/bootstrap.php:, _(*3)

Plugin::load('JorisVaesen/Sendgrid', ['bootstrap' => true]);

Configuration

Method 1 (using ENV)

The plugin loads from dotenv the following:, _(*4)

SENDGRID_API_KEY="your_sendgrid_api_key"

Method 2 (using app.php)

Set the sendgrid api key in app.php:, _(*5)

'Sendgrid' => [
    'apiKey' => 'your_sendgrid_api_key',
],

Method 3 (hardcoded)

Add in your app.php file, in the EmailTransport item, _(*6)

'EmailTransport' => [
        ...
        'sendgrid' => [
            'className' => '\JorisVaesen\Sendgrid\Mailer\Transport\SendgridTransport',
            'password' => 'your_sendgrid_api_key',
        ],
        ...
    ],

To use it by default, set your default transport to sendgrid in app.php:, _(*7)

'Email' => [
    'default' => [
        'transport' => 'sendgrid',
    ],
],

Callback

If you want to use Sendgrid API methods which do not have a CakePHP equivalent, you can make use of the callback configuration:, _(*8)

'EmailTransport' => [
        ...
        'sendgrid' => [
            'className' => '\JorisVaesen\Sendgrid\Mailer\Transport\SendgridTransport',
            'password' => 'your_sendgrid_api_key',
            'callback' => function (\SendGrid\Mail\Mail $sendgridEmail, \Cake\Mailer\Email $cakephpEmail) {
                if ($cakephpEmail->getSubject() === 'If you open this mail...') {
                    $sendgridEmail->setOpenTracking(true);
                }

                return $sendgridEmail;
            },
        ],
        ...
    ],

Usage

$email = new Email('default');
$email->viewBuilder()->setLayout('default);
/* @var \Sendgrid\Response $response */
$response = $email
    ->setProfile('sendgrid')    // optional when you've set sendgrid as the default transport in configuration
    ->setEmailFormat('html')
    ->setSender('noreply@example.com', 'Example sender')
    ->setFrom('from@example.com', 'Example From')
    ->setReplyTo('replyTo@example.com', 'Example ReplyTo')
    ->setTo('to@example.com', 'Example To')
    ->setSubject('Sample email')
    ->setTemplate('default')
    ->setViewVars([])
    ->send();

return $response->statusCode() === 202;

www.datrix.be, _(*9)