isobar-nz / silverstripe-mandrill

Mandrill integration for Silverstripe

SilverStripe Mandrill module

Use Mandrill in SilverStripe

Define in your .env file the following constant

MANDRILL_API_KEY='YOUR_API_KEY_HERE'

or by defining the api key in your config.yml

LeKoala\Mandrill\MandrillHelper::
  mandrill_api_key: 'key3goes9here'

This module uses the official php sdk version 1.0.54 with a few tweaks.

You can also autoconfigure the module with the following constants in your .env file

# Will log emails in the temp folders
MANDRILL_ENABLE_LOGGING=true
# Will disable sending (useful in development)
MANDRILL_SENDING_DISABLED=true

By defining the Api Key, the module will register a new mailer that will be used to send all emails.

Integration

This module create a new admin section that allows you to see results from your api calls right from the SilverStripe CMS without having to log into mandrillapp.com

Webhooks

From the Mandrill Admin, you can setup a webhook for your website. This webhook will be called and MandrillController will take care of handling all events for you.

By default, MandrillController will do nothing. Feel free to add your own extensions to MandrillController to define your own rules, like "Send an email to the admin when a receive a spam complaint".

MandrillController provides 4 extensions points:

• updateHandleAnyEvent
• updateHandleSyncEvent
• updateHandleInboundEvent
• updateHandleMessageEvent

Compatibility

Tested with SilverStripe 4.1+

Maintainer

LeKoala - [email protected]