Download the PHP package lekoala/silverstripe-mandrill without Composer
On this page you can find all versions of the php package lekoala/silverstripe-mandrill. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download lekoala/silverstripe-mandrill
More information about lekoala/silverstripe-mandrill
Files in lekoala/silverstripe-mandrill
Package silverstripe-mandrill
Short Description Adds mandrill in the SilverStripe CMS
License MIT
Informations about the package silverstripe-mandrill
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
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
# Set app domain explicitly
MANDRILL_DOMAIN="mysite.co.nz"
# Also recommended to specify an explicit from
SS_SEND_ALL_EMAILS_FROM="[email protected]"
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 we receive a spam complaint".
MandrillController provides 4 extensions points:
- 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:
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.
via config
via .env file
Migration from Swift Mailer
SilverStripe 5 replaced swift mailer by symfony/mailer
Make sure to read the docs https://docs.silverstripe.org/en/5/developer_guides/email/ https://symfony.com/doc/current/mailer.html
For SS4 version, check branch 3 and v4 releases
Compatibility
Tested with SilverStripe 5+
Maintainer
LeKoala - [email protected]
All versions of silverstripe-mandrill with dependencies
silverstripe/recipe-plugin Version ^2
silverstripe/vendor-plugin Version ^2
silverstripe/framework Version ^5
composer/ca-bundle Version ^1.1
symfony/mailchimp-mailer Version ^6.3
symbiote/silverstripe-gridfieldextensions Version ^4.0
symfony/http-client Version ^5.4|^6.0