A plugin to manage your Mailchimp campaigns from RefineryCMS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
app Make the tests pass again May 31, 2012
db Migrating to Refinery CMS 2.0 support May 21, 2012
script Localization (work in progress) & script/rails May 22, 2012
.travis.yml Refinery specific travis settings May 31, 2012
readme.md Fix capatilization in readme install instructions Jan 26, 2015
refinerycms-mailchimp.gemspec Update refinerycms-mailchimp.gemspec Mar 15, 2013


Build Status

Mailchimp engine for Refinery CMS

This project was originally sponsored by Mailchimp and is now maintained and funded by Wirelab Creative! Many thanks to them for supporting open source development.

How to use this engine with a Refinery CMS project

To set up a Refinery app from scratch, you'll need to install Refinery and create a new app:

gem install refinerycms
refinerycms new_project
cd new_project

Once you have a Refinery app created, add this engine to your Gemfile in the USER DEFINED area:

gem 'refinerycms-mailchimp', :github => 'wirelab/refinerycms-mailchimp', :branch => 'refinery-2.1'

Then, from the command line:

bundle install
rails generate refinery:mailchimp
rake db:migrate


You'll need to set up your Mailchimp API key in config/initializers/refinery/mailchimp.rb. Get your API key here.

All available settings are:

  • mailchimp_default_to_name The default To: name recipients will see (not email address). This can be changed for each campaign.
  • mailchimp_default_from_name The default From: name for your campaign message (not an email address). This can be changed for each campaign.
  • mailchimp_default_from_email The default From: email address for your campaign message. This can be changed for each campaign.

Using Templates

This plugin currently only supports one editable text area per campaign. If you use a template, the body will replace the template's MAIN area (see the Mailchimp docs on editable content areas).

How to run the test suite

Uncomment the following line in your Gemfile:

gem 'refinerycms-testing',    '~>'

Then install the testing functionality with

rails generate refinerycms_testing

You can now run all engine specs and features with rake, or run them separately with rake spec and rake cucumber.