Mandrails - The Mandrill/ActionMailer connector
A delivery method implementation which uses the Mandrill REST API. This allows to simply send e-mails from a Rails app using Mandrill instead of SMTP or sendmail.
Open items
Currently this gem is in alpha quality, things we are still working:
- Support for custom
X-headers - Ability to override Mandrill settings, e.g. click tracking, per mail
-
Improve test cases -
Implement Railtie which automatically hooks delivery method into AM -
Attachment support
Installation
Add mandrails to your Gemfile and run bundle afterwards:
gem 'mandrails'Usage
When using with Rails it's basically all setup to use the :mandrill delivery
handler in config/environemnts/*.rb:
config.action_mailer.delivery_method = :mandrill
config.action_mailer.mandrill_settings = {
key: "123...-abcde", # or set the MANDRILL_APIKEY environment variable
from_name: "My Application",
from_email: "saas@example.com"
}Basically the :key and :from_email are required attributes, the :key can
be omitted if the MANDRILL_APIKEY environment variable is set.
Additional information
Mailchimp & Mandrill
Thanks to the team at Mailchimp which provides the mandrill-api gem and of course the Mandrill service itself. FYI - the maintainers of this gem are in no way affiliated with Mailchimp or Mandrill.
License
MIT License. Copyright 2013 at-point ag. http://at-point.ch