2017 © Pedro Peláez
 

silverstripe-module silverstripe-mandrill

Adds mandrill in the SilverStripe CMS

image

lekoala/silverstripe-mandrill

Adds mandrill in the SilverStripe CMS

  • Thursday, January 25, 2018
  • by lekoala
  • Repository
  • 4 Watchers
  • 15 Stars
  • 9,381 Installations
  • PHP
  • 1 Dependents
  • 0 Suggesters
  • 14 Forks
  • 1 Open issues
  • 10 Versions
  • 6 % Grown

The README.md

SilverStripe Mandrill module

Build Status Scrutinizer Code Quality Code Coverage Build Status codecov.io, (*1)

Latest Stable Version Latest Unstable Version Total Downloads License Monthly Downloads Daily Downloads, (*2)

codecov.io, (*3)

Use Mandrill in SilverStripe, (*4)

Define in your .env file the following constant, (*5)

MANDRILL_API_KEY='YOUR_API_KEY_HERE'

or by defining the api key in your config.yml, (*6)

LeKoala\Mandrill\MandrillHelper:
    mandrill_api_key: "key3goes9here"

This module uses the official php sdk version 1.0.54 with a few tweaks., (*7)

You can also autoconfigure the module with the following constants in your .env file, (*8)

# Will log emails in the temp folders
MANDRILL_ENABLE_LOGGING=true
# Will disable sending (useful in development)
MANDRILL_SENDING_DISABLED=true
# Set app domain explicitly
MANDRILL_DOMAIN="mysite.co.nz"
# Also recommended to specify an explicit from
SS_SEND_ALL_EMAILS_FROM="noreply@mysite.co.nz"

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

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, (*10)

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., (*11)

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 we receive a spam complaint"., (*12)

MandrillController provides 4 extensions points:, (*13)

  • updateHandleAnyEvent
  • updateHandleSyncEvent
  • updateHandleInboundEvent
  • updateHandleMessageEvent

It's recommended that you ensure requests are coming from Mailchimp Transactional rather than an imitator. Webhook authentication is disabled by default but you can enable webhook authentication through the config layer like so:, (*14)

LeKoala\Mandrill\MandrillController:
  webhook_auth_enabled: true

You'll need your webhook authentication key which you can view and reset from the (Webhooks)[https://mandrillapp.com/settings/webhooks] page in your account. Add your key using the config layer or .env file., (*15)

via config, (*16)

LeKoala\Mandrill\MandrillController:
  webhook_key: YOUR_KEY

via .env file, (*17)

MANDRILL_WEBHOOK_KEY=YOUR_KEY

Migration from Swift Mailer

SilverStripe 5 replaced swift mailer by symfony/mailer, (*18)

Make sure to read the docs https://docs.silverstripe.org/en/5/developer_guides/email/ https://symfony.com/doc/current/mailer.html, (*19)

For SS4 version, check branch 3 and v4 releases, (*20)

Compatibility

Tested with SilverStripe 5+, (*21)

Maintainer

LeKoala - thomas@lekoala.be, (*22)

The Versions

25/01 2018

1.x-dev

1.9999999.9999999.9999999-dev

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

17/07 2017

dev-master

9999999-dev

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

13/07 2017

2.0.0

2.0.0.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

09/06 2017

1.1.5

1.1.5.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

20/01 2017

1.1.4

1.1.4.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

26/09 2016

1.1.3

1.1.3.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

14/01 2016

1.1.2

1.1.2.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

MIT

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

06/10 2015

1.1.1

1.1.1.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

BSD-3-Clause

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

16/09 2015

1.1.0

1.1.0.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

BSD-3-Clause

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill

24/12 2014

1.0.0

1.0.0.0

Adds mandrill in the SilverStripe CMS

  Sources   Download

BSD-3-Clause

The Requires

 

by Avatar lekoala

module cms silverstripe mandrill