DeviseCampaignable

Have your users automatically added to and removed from your favourite mail campaign tool. Currently supports MailChimp.

Inspired by the now slightly out of date devise_mailchimp and based upon Gibbon, this gem works in a similar fashion but with a focus on multi-vendor support, rather than exclusively MailChimp.

It is directly extracted from Sorry™ where we use MailChimp to stay in touch with customers about our product development.

Simply add DeviseCampaignable and Gibbon to your application's Gemfile:

gem 'devise'
gem 'devise_campaignable'

DeviseCampaignable adds a few configuration variables which you'll need to add to your devise initilizer.

Devise.setup do |config|
	# ==> Configuration for :campaignable
	config.campaignable_vendor = :mailchimp
	config.campaignable_api_key = 'your_service_api_key'
	config.campaignable_list_id = 'the_id_of_the_list_to_which_we_subscribe'
	config.campaignable_additional_fields = [:array, :of, :additional, :fields]
end

A symbol which represents which mail campaign vendor you wish to use. Defaults to :mailchimp. Yet to support any other options but future plans for CampaignMonitor etc.

A API key for your chosen vendor. How you aqcuire this will depend from vendor to vendor. We also recommend for security that you store this in an environment variable instead of directly in the initializer.

The unique ID of the list to which you want your users to be subscribed. Again, how you get this will vary from vendor to vendor.

An array of symbols which denote attributes on the model you want sent to the campaign vendor. Can be things like Name, Age, Address. Defaults to no additional fields.

MailChimp Users: You need to have added merge fields with matching names to your MailChimp list before this will work, the merge fields should match the attribute on your user model, capitalized. i.e. an attribute such as 'name' should have a merge field on the list of 'NAME'. If your attribute is more than 10 characters (MailChimp's limit) then use the first 10 characters.

Add :campaignable to the devise call in your model (we’re assuming here you already have a User model with some Devise modules):

class User < ActiveRecord::Base
	devise :database_authenticatable, :confirmable, :campaignable
end

Once configured this gem will ensure any users which are created by Devise will be automaticaly subscribed to your mailing list. They will also be unsubscribed when they are deleted.

By default users are not required to 'double opt in' when added to your list.

Should you wish to manually subscribe or unsubscribe any of your users, we have added some new methods to your user model to help you do this.

Instance methods User.find(1).subscribe and User.find(1).unsubscribe perform an action on a particular user.

Class methods User.subscribe_all() and User.unsubscribe_all() add or remove all users in your system to your mailing list of choice.

In lieu of a formal styleguide, take care to maintain the existing coding style. Add unit tests for any new or changed functionality. Lint and test your code using Grunt.

Once you are happy that your contribution is ready for production please send us a pull request, at which point we'll review the code and merge it in.

For transparency and insight into our release cycle, and for striving to maintain backward compatibility, This project will be maintained under the Semantic Versioning guidelines as much as possible.

Releases will be numbered with the following format:

<major>.<minor>.<patch>

And constructed with the following guidelines:

• Breaking backward compatibility bumps the major (and resets the minor and patch)
• New additions without breaking backward compatibility bumps the minor (and resets the patch)
• Bug fixes and misc changes bumps the patch

For more information on SemVer, please visit http://semver.org/.

Robert Rawlins

• http://twitter.com/sirrawlins
• https://github.com/SirRawlins

© Copyright 2015 - See LICENSE for details.