🚄 Email subscriptions made easy
- Add one-click unsubscribe links to your emails
- Fetch bounces and spam reports from your email service
Gracefully handles email address changes
📮 Check out Ahoy Email for analytics
Add this line to your application’s Gemfile:
gem 'mailkick'
And run the generator. This creates a model to store opt-outs.
rails generate mailkick:install
rake db:migrate
Add an unsubscribe link to your emails.
Unsubscribe: <%= mailkick_unsubscribe_url %>
<%= link_to "Unsubscribe", mailkick_unsubscribe_url %>
When a user unsubscribes, he or she is taken to a mobile-friendly page and given the option to resubscribe.
To customize the view, run:
rails generate mailkick:views
which copies the view into app/views/mailkick
.
Before sending marketing emails, make sure the user has not opted out.
Add the following method to models with email addresses.
class User < ActiveRecord::Base
mailkick_user
end
Get all users who have opted out
User.opted_out
And those who have not - send to these people
User.not_opted_out
Check one user
user.opted_out?
Fetch bounces, spam reports, and unsubscribes from your email service.
Mailkick.fetch_opt_outs
Add the gem
gem 'sendgrid_toolkit'
Be sure ENV["SENDGRID_USERNAME"]
and ENV["SENDGRID_PASSWORD"]
are set.
gem 'mandrill-api'
Be sure ENV["MANDRILL_APIKEY"]
is set.
gem 'gibbon'
Be sure ENV["MAILCHIMP_API_KEY"]
and ENV["MAILCHIMP_LIST_ID"]
are set.
gem 'mailgun-ruby'
Be sure ENV["MAILGUN_API_KEY"]
is set.
Will gladly accept pull requests.
For more control over services, set them by hand.
Mailkick.services = [
Mailkick::Service::Sendgrid.new(api_key: "API_KEY"),
Mailkick::Service::Mandrill.new(api_key: "API_KEY")
]
You may want to split your emails into multiple categories, like sale emails and order reminders.
Set the list in the mailer.
class UserMailer < ActionMailer::Base
def order_reminder(user)
headers[:mailkick_list] = "order_reminders"
# ...
end
end
Pass the list
option to methods.
User.opted_out(list: "order_reminders")
User.not_opted_out(list: "order_reminders")
user.opted_out?(list: "order_reminders")
For opt-in lists, you’ll need to manage the subscribers yourself.
Check opt-ins against the opt-outs
User.where(send_me_sales: true).not_opted_out(list: "sales")
Check one user
user.send_me_sales && !user.opted_out?(list: "sales")
More great gems for email
- Roadie - inline CSS
- Letter Opener - preview email in development
- Make it easy to customize controller
- Subscribe to events
Change how the user is determined
Mailkick.user_method = -> (email) { User.find_by(email: email) }
Use a different email field
mailkick_user email_key: :email_address
Unsubscribe
user.opt_out
Resubscribe
user.opt_in
View the changelog
Everyone is encouraged to help improve this project. Here are a few ways you can help:
- Report bugs
- Fix bugs and submit pull requests
- Write, clarify, or fix documentation
- Suggest or add new features