scherersoftware / cake-notifications Goto Github PK

A CakePHP 3.8 notification plugin which can send out emails asynchronously through to the cakephp-queuesadilla job queue.

• CakePHP Queuesadilla Plugin 3.0
• PHP 7.1+

composer require codekanzlei/cake-notifications

$this->addPlugin('Notifications');

Set your default locale in a config file, for example in app.php. This config is mandatory and will cause an exception if not set.

'Notifications' => [
    'defaultLocale' => 'en_US'
]

You can also override the queue options like attempts, attempts_delay, delay, expires_in and queue.

'Notifications' => [
    'queueOptions' => [
        'queue' => 'notification'
    ]
]

This doesn't affect the use of queueOptions() later. You can still override the options there.

Also, be sure to set up the the cakephp-queuesadilla plugin config. You can find an example config here: https://cakephp-queuesadilla.readthedocs.io/en/latest/.

Or you can find available config options inside your used Engine file (vendor/josegonzalez/queuesadilla/src/josegonzalez/Queuesadilla/Engine/*Engine.php) inside the $baseConfig property.

IMPORTANT: Set "date.timezone" in your cli/php.ini to an appropriate value, else notifications with a delay_until could be sent out at the wrong time.

The EmailNotification is completely compatible with the CakePHP Email.

Add the following to your class where you want to send an email:

use Notifications\Notification\EmailNotification;

Then simply create a new EmailNotification object.

$email = new EmailNotification();
$email->to('[email protected]')
    ->setSubject('Send with cake-notifications v2')
    ->send('Hello :)');

You can chain all methods provided by the CakePHP Email Class http://book.cakephp.org/3.0/en/core-libraries/email.html

Send out the email immediately. before- and afterSend callbacks are still available

Set the locale for the notification. If null, Configure::read('Notifications.defaultLocale') is used.

Push the email into the queue to send it asynchronous

You can change some of the default options from the cakephp-queuesadilla plugin.

Supported options:

• attempts how often the notification will be executed again after a failure
• attempts_delay how long it takes in seconds until the notification will be executed again
• delay how long it takes until the notification will be executed for the first time in seconds
• expires_in how long the notification will stay in the queue in seconds
• queue name of the queue

Pass a callable as the $class parameter. Static and none-static functions are supported.

$email->beforeSendCallback(['Foo', 'bar'], ['first_param', 'second_param'])

This will call the bar method inside the Foo class with two parameters before the email is send.

To manipulate the EmailNotification instance before sending, the beforeSendCallback may return a function taking the notification instance reference and for example changing the profile. The bar method may then look something like this:

public function bar($first_param, $second_param)
{
    // do something
    return function (&$instance) {
        $instance->profile([
            'from' => '[email protected]'
        ]);
    };
}

Pass a callable as the $class parameter. Static and none-static functions are supported.

$email-> afterSendCallback(['Foo::bar'], ['first_param', 'second_param'])

This will call the static bar method inside the Foo class with two parameters after the email was send.

Add an additional callback to beforeSend.

Add an additional callback to afterSend.