maily_herald 0.0.1 → 0.8.0

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZjIwNzFmNTFiM2E1MzI0NGM0MjkxZDQyNTk2MDdkY2IzMmE1YzBjNA==
+  data.tar.gz: !binary |-
+    YzBlMTQ1Mzk0ZDEzYTg5N2FhYTlmYjQ3ZGMzY2E0NTZmMGU1NTkzMQ==
+SHA512:
+  metadata.gz: !binary |-
+    ZmViMzhiN2IzMzg1NWQ0NzI0MjdlMTg3YzI0ZmZlNzU5MjY4NTdjNDJlYTM5
+    NThhY2Q4NGRlZjYwNjBhNDYyYTFkMDE2NTZjZjVhOWFlZmU5YTAwY2ZlZjhm
+    MjU2ZDg5OTZlNWEzZDk3ZjdjM2Q0YzU0Y2RmOGViNmUzNmEzMTA=
+  data.tar.gz: !binary |-
+    ODhiYzU0N2Q4YTgyNGZhNTg1OWI2NTE1NzA2NmRmODlkNGUyNjE2ODY5ZWU4
+    YjcwMDkyZmNlYzhhOGQ3NWNmYWE4N2I3YjUyZjdlMjFjNjY1Nzg3YTU4YTFi
+    YmI2MTRlNjc1ODNlYzNiNWU2MTNiNjhlODkzY2YxOGVjOTlmYTU=

data/.gitignore

@@ -1,11 +1,17 @@
 .bundle/
 log/*.log
 pkg/
-test/dummy/db/*.sqlite3
-test/dummy/log/*.log
-test/dummy/tmp/
-test/dummy/.sass-cache
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+spec/dummy/.sass-cache
+coverage/*
+dump.rdb
+tmp
+*.gem
 
 *.swo
 *.swp
 *.rvmrc
+*.ruby-gemset
+*.ruby-version

data/.rspec

@@ -0,0 +1,5 @@
+--color
+#--format=documentation
+--backtrace
+--profile
+--order random

data/Gemfile

@@ -1,19 +1,8 @@
 source "http://rubygems.org"
 
-# Declare your gem's dependencies in maily_herald.gemspec.
-# Bundler will treat runtime dependencies like base dependencies, and
-# development dependencies will be added by default to the :development group.
 gemspec
 
 # jquery-rails is used by the dummy application
 gem "jquery-rails"
 
-gem "liquid", "~> 2.6.0", :git => "git@github.com:Shopify/liquid.git"
-
-# Declare any dependencies that are still in development here instead of in
-# your gemspec. These might include edge Rails or gems from your path or
-# Git. Remember to move these dependencies to your gemspec before releasing
-# your gem to rubygems.org.
-
-# To use debugger
-# gem 'debugger'
+gem 'debugger'

data/Gemfile.lock

@@ -1,26 +1,20 @@
-GIT
-  remote: git@github.com:Shopify/liquid.git
-  revision: fbfda1a1895bfb5bd9477248008f60fc1953c297
-  specs:
-    liquid (2.6.0)
-
 PATH
   remote: .
   specs:
     maily_herald (0.0.1)
-      liquid (~> 2.6.0)
-      rails (~> 3.2.8)
-      sidekiq (~> 2.13.0)
+      liquid (~> 2.6.1)
+      rails (> 3.2)
+      sidekiq (~> 2.17.8)
 
 GEM
   remote: http://rubygems.org/
   specs:
-    actionmailer (3.2.13)
-      actionpack (= 3.2.13)
-      mail (~> 2.5.3)
-    actionpack (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
+    actionmailer (3.2.18)
+      actionpack (= 3.2.18)
+      mail (~> 2.5.4)
+    actionpack (3.2.18)
+      activemodel (= 3.2.18)
+      activesupport (= 3.2.18)
       builder (~> 3.0.0)
       erubis (~> 2.7.0)
       journey (~> 1.0.4)
@@ -28,122 +22,175 @@ GEM
       rack-cache (~> 1.2)
       rack-test (~> 0.6.1)
       sprockets (~> 2.2.1)
-    activemodel (3.2.13)
-      activesupport (= 3.2.13)
+    activemodel (3.2.18)
+      activesupport (= 3.2.18)
       builder (~> 3.0.0)
-    activerecord (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
+    activerecord (3.2.18)
+      activemodel (= 3.2.18)
+      activesupport (= 3.2.18)
       arel (~> 3.0.2)
       tzinfo (~> 0.3.29)
-    activeresource (3.2.13)
-      activemodel (= 3.2.13)
-      activesupport (= 3.2.13)
-    activesupport (3.2.13)
-      i18n (= 0.6.1)
+    activeresource (3.2.18)
+      activemodel (= 3.2.18)
+      activesupport (= 3.2.18)
+    activesupport (3.2.18)
+      i18n (~> 0.6, >= 0.6.4)
       multi_json (~> 1.0)
-    arel (3.0.2)
-    bourne (1.5.0)
-      mocha (>= 0.13.2, < 0.15)
+    arel (3.0.3)
     builder (3.0.4)
-    celluloid (0.14.1)
-      timers (>= 1.0.0)
-    connection_pool (1.1.0)
-    database_cleaner (1.0.1)
-    diff-lcs (1.2.4)
+    celluloid (0.15.2)
+      timers (~> 1.1.0)
+    coderay (1.1.0)
+    columnize (0.8.9)
+    connection_pool (2.0.0)
+    database_cleaner (1.3.0)
+    debugger (1.6.8)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.3.5)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.3.5)
+    diff-lcs (1.2.5)
+    docile (1.1.3)
     erubis (2.7.0)
-    factory_girl (4.2.0)
+    factory_girl (4.4.0)
       activesupport (>= 3.0.0)
-    factory_girl_rails (4.2.1)
-      factory_girl (~> 4.2.0)
+    factory_girl_rails (4.4.1)
+      factory_girl (~> 4.4.0)
       railties (>= 3.0.0)
+    ffi (1.9.3)
+    formatador (0.2.5)
+    guard (2.6.1)
+      formatador (>= 0.2.4)
+      listen (~> 2.7)
+      lumberjack (~> 1.0)
+      pry (>= 0.9.12)
+      thor (>= 0.18.1)
+    guard-rspec (4.2.10)
+      guard (~> 2.1)
+      rspec (>= 2.14, < 4.0)
     hike (1.2.3)
-    i18n (0.6.1)
+    i18n (0.6.9)
     journey (1.0.4)
-    jquery-rails (3.0.2)
+    jquery-rails (3.1.0)
       railties (>= 3.0, < 5.0)
       thor (>= 0.14, < 2.0)
-    json (1.8.0)
+    json (1.8.1)
+    liquid (2.6.1)
+    listen (2.7.7)
+      celluloid (>= 0.15.2)
+      rb-fsevent (>= 0.9.3)
+      rb-inotify (>= 0.9)
+    lumberjack (1.0.6)
     mail (2.5.4)
       mime-types (~> 1.16)
       treetop (~> 1.4.8)
-    metaclass (0.0.1)
-    mime-types (1.23)
-    mocha (0.14.0)
-      metaclass (~> 0.0.1)
-    multi_json (1.7.7)
-    polyglot (0.3.3)
+    method_source (0.8.2)
+    mime-types (1.25.1)
+    multi_json (1.10.1)
+    polyglot (0.3.5)
+    pry (0.10.0)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
     rack (1.4.5)
     rack-cache (1.2)
       rack (>= 0.4)
-    rack-ssl (1.3.3)
+    rack-ssl (1.3.4)
       rack
     rack-test (0.6.2)
       rack (>= 1.0)
-    rails (3.2.13)
-      actionmailer (= 3.2.13)
-      actionpack (= 3.2.13)
-      activerecord (= 3.2.13)
-      activeresource (= 3.2.13)
-      activesupport (= 3.2.13)
+    rails (3.2.18)
+      actionmailer (= 3.2.18)
+      actionpack (= 3.2.18)
+      activerecord (= 3.2.18)
+      activeresource (= 3.2.18)
+      activesupport (= 3.2.18)
       bundler (~> 1.0)
-      railties (= 3.2.13)
-    railties (3.2.13)
-      actionpack (= 3.2.13)
-      activesupport (= 3.2.13)
+      railties (= 3.2.18)
+    railties (3.2.18)
+      actionpack (= 3.2.18)
+      activesupport (= 3.2.18)
       rack-ssl (~> 1.3.2)
       rake (>= 0.8.7)
       rdoc (~> 3.4)
       thor (>= 0.14.6, < 2.0)
-    rake (10.1.0)
+    rake (10.3.2)
+    rb-fsevent (0.9.4)
+    rb-inotify (0.9.5)
+      ffi (>= 0.5.0)
     rdoc (3.12.2)
       json (~> 1.4)
-    redis (3.0.4)
-    redis-namespace (1.3.0)
-      redis (~> 3.0.0)
-    rspec-core (2.13.1)
-    rspec-expectations (2.13.0)
-      diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.1)
-    rspec-rails (2.13.2)
+    redcarpet (3.2.2)
+    redis (3.1.0)
+    redis-namespace (1.5.1)
+      redis (~> 3.0, >= 3.0.4)
+    rspec (3.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+    rspec-core (3.0.0)
+      rspec-support (~> 3.0.0)
+    rspec-expectations (3.0.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.0.0)
+    rspec-mocks (3.0.1)
+      rspec-support (~> 3.0.0)
+    rspec-rails (3.0.1)
       actionpack (>= 3.0)
       activesupport (>= 3.0)
       railties (>= 3.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    shoulda-matchers (1.5.6)
-      activesupport (>= 3.0.0)
-      bourne (~> 1.3)
-    sidekiq (2.13.0)
-      celluloid (>= 0.14.1)
-      connection_pool (>= 1.0.0)
+      rspec-core (~> 3.0.0)
+      rspec-expectations (~> 3.0.0)
+      rspec-mocks (~> 3.0.0)
+      rspec-support (~> 3.0.0)
+    rspec-support (3.0.0)
+    sidekiq (2.17.8)
+      celluloid (= 0.15.2)
+      connection_pool (~> 2.0)
       json
-      redis (>= 3.0)
-      redis-namespace
+      redis (~> 3.1)
+      redis-namespace (~> 1.3)
+    simplecov (0.8.2)
+      docile (~> 1.1.0)
+      multi_json
+      simplecov-html (~> 0.8.0)
+    simplecov-html (0.8.0)
+    slop (3.5.0)
+    spring (1.1.3)
+    spring-commands-rspec (1.0.2)
+      spring (>= 0.9.1)
     sprockets (2.2.2)
       hike (~> 1.2)
       multi_json (~> 1.0)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
-    sqlite3 (1.3.7)
-    thor (0.18.1)
+    sqlite3 (1.3.9)
+    thor (0.19.1)
     tilt (1.4.1)
+    timecop (0.7.1)
     timers (1.1.0)
-    treetop (1.4.14)
+    treetop (1.4.15)
       polyglot
       polyglot (>= 0.3.1)
-    tzinfo (0.3.37)
+    tzinfo (0.3.41)
+    yard (0.8.7.6)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   database_cleaner
+  debugger
   factory_girl_rails
+  guard
+  guard-rspec
   jquery-rails
-  liquid (~> 2.6.0)!
   maily_herald!
+  redcarpet
   rspec-rails
-  shoulda-matchers (~> 1.0)
+  simplecov
+  spring-commands-rspec
   sqlite3
+  timecop
+  yard

data/Guardfile

@@ -0,0 +1,25 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+guard :rspec, :version => 2, :cmd => "spring rspec" do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^app/(.*)(\.erb|\.haml)$})                 { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+
+  # Capybara features specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml)$})          { |m| "spec/features/#{m[1]}_spec.rb" }
+
+  # Turnip features and steps
+  watch(%r{^spec/acceptance/(.+)\.feature$})
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$})   { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance' }
+
+  notification :notifysend
+end

data/LICENSE

@@ -0,0 +1,10 @@
+MailyHerald - Ruby on Rails email marketing solution.
+
+Copyright (c) 2013-2015 Sology (http://www.sology.eu) 
+with initial development sponsored by 
+Smart Language Apps Ltd <http://www.smartlanguageapps.com>.
+
+MailyHerald is an Open Source project licensed under the terms of
+the LGPLv3 license. 
+Please see <http://www.gnu.org/licenses/lgpl-3.0.html>
+for license text.

data/README.md

@@ -0,0 +1,346 @@
+# MailyHerald
+
+MailyHerald is a Ruby on Rails gem that helps you sending and managing your mailings. Think of Maily as a self-hosted Mailchimp alternative you can easily integrate with your site. MailyHerald is great both for email marketing and conducting daily stream of notifications you send to your users.
+
+With MailyHerald you can send:
+* one-time mailings (i.e. welcome emails, special offers),
+* periodical mailings (i.e. weekly notifications, reminders),
+* mailing sequences - multiple ordered emails delivered with certain delays since specific point in time (i.e. onboarding emails, site feature overview).
+
+Maily keeps track of user subscriptions and allow them to easily opt out. You can define who receives which emails and specify conditions that control delivery. All deliveries are tracked and logged. Periodical and Sequence mailing deliveries are scheduled individually for each recipient.
+
+Maily seamlessly integrates with your app. It can use your regular Mailers or you can build ad-hoc mailings with [Liquid](http://liquidmarkup.org/) markup templates. 
+
+Core Maily features are accessible for Rails programmers via API. Apart from that, Maily has a nice web UI provided by separate [maily_herald-webui](https://github.com/Sology/maily_herald-webui) gem.
+
+## Requirements
+
+Both Ruby on Rails 3.2 and 4 are supported. 
+
+## Installation
+
+Simply just
+
+    gem install maily_herald
+
+or put in your Gemfile
+
+    gem "maily_herald"
+
+## Features
+
+* Designed for Ruby on Rails
+* Self-hosted
+* Seamless and flexible integration
+* Asynchronous processing
+* Individual delivery scheduling 
+* Great both for developers (API) and end-users (Web UI) 
+* Ad-hoc email templating using [Liquid](http://liquidmarkup.org/) syntax
+* Three different mailing types
+* User-friendly subscription management i.e. via automatic & personal opt-out links
+* Correspondence logging
+* Mailing conditions
+
+## Development state
+
+MailyHerald is relatively young piece of software and can't be considered stable. Although it has been deployed to few production environments for quite some time now, we can't guarantee it will suite your needs too.
+
+If you decide to use it, please tell us what you think about it, post some issues on GitHub etc. We're waiting for your feedback.
+
+Here are some things we would like to implement in the future:
+
+* better mailing scheduling,
+* message analytics,
+* link tracking,
+* better Web UI,
+* _put your beloved feature here_.
+
+## How it works
+
+There are few key concepts that need to be explained in order to understand how Maily works. Some of them are similar to what you might know form other conventional email marketing software. Others come strictly from Ruby on Rails world.
+
+**Entities**
+
+Entities are basically your mailing recipients. They will be probably represented in your application by `User` model.
+
+**Mailings**
+
+You usually send single emails to your users - one at a time. Mailing is a bunch of emails sent out to many users. MailyHerald allows you to send three types of Mailings: one-times, periodicals and sequences.
+
+**Contexts**
+
+Maily Contexts are abstraction layer for accessing collections of entities and their attributes. 
+
+There are three main things that Contexts do:
+
+* They define sets of entities via Rails scopes (i.e. `User.activated` meaning all application users that activated their accounts). 
+* They specify destination email addresses for entities (i.e. you can define that `User#email` method returns email address or specify a custom proc that does that).
+* They specify additional entity attributes that can be used inside Mailing templates, conditions etc. (basically - attributes accessible via Liquid).
+
+**Lists and Subscriptions**
+
+Lists are sets of entities that receive certain mailings. Entities are added to Lists by creating Subscriptions. It is entirely up to you how you manage subscriptions in application. Typically, you put some checkbox in user's profile page that subscribes and unsubscribes them from mailing lists.
+
+Each Subscription has it's unique token allowing users to be provided with one click opt-out link.
+
+**Mailers**
+
+Mailers are standard way of sending emails in Rails applications. MailyHerald hooks into ActionMailer internals and allows you to send Mailings just like you send your regular emails. All you need to do is inherit `MailyHerald::Mailer` in your Mailer. 
+
+There's also a possibility to send Mailings without using any of your custom Mailers. `MailyHerald::Mailer` is in this case used implicitly; email body and subject is stored directly in your Mailing definition as a Liquid template. Liquid gives you access to entity attributes defined in the Context. This way of creating Mailings is especially useful within Web UI where you can build new Mailing by just typing its template.
+
+**Delivery**
+
+MailyHerald uses great gem [Sidekiq](http://sidekiq.org/) to process deliveries in the background. This applies to Periodical and Sequence Mailings - their delivieries are scheduled individually for each entity on the subscription list. 
+
+Maily needs to check periodically for scheduled mailings and if their time come - queue them for delivery. This is job for MailyHerald Paperboy - tiny daemon that runs in the background and check the schedules. It is essential to make you periodical and sequence mailings work.
+
+## Usage
+
+Let's assume your entities are your `User` model objects. Read on in order to find out how to start with Maily.
+
+### Migrations
+
+Install engine migrations and run them.
+
+```ruby
+rake maily_herald:install:migrations
+rake db:migrate
+```
+
+### Defaults (optional)
+
+In some cases, you need to specify default `from` and `host` mailer options in order to ensure proper email rendering:
+
+```ruby
+config.action_mailer.default_options = { from: "hello@mailyherald.org" }
+config.action_mailer.default_url_options = { host: "mailyherald.org" }
+
+```
+
+### Initializer
+
+Generate and setup an initializer.
+
+```ruby
+rails g maily_herald:install
+```
+
+This will create the following file:
+
+```ruby
+# config/initializers/maily_herald.rb
+MailyHerald.setup do |config|
+  # Put your contexts, mailing definitions etc. here.
+end
+```
+
+There are few things you need to put there. 
+
+**Set up your context**
+
+Say for example, you want to deliver your mailings to all your active users:
+
+```ruby
+config.context :active_users do |context|
+  context.scope {User.active}
+  context.destination {|user| user.email}
+  
+  # Alternatively, you can specify destination as attribute name:
+  # context.destination = :email
+end
+```
+
+**Set up your lists**
+
+Following means that all users in `:active_users` context scope can be subscribed to `:newsletters` list.
+
+```ruby
+config.list :newsletters do |list|
+  list.context_name = :active_users
+end
+```
+
+**Set up your mailings**
+
+```ruby
+config.one_time_mailing :hello do |mailing|
+  mailing.title = "Hello mailing"
+  mailing.context_name = :active_users
+  mailing.mailer_name = "UserMailer"
+  mailing.enable # mailings are disabled by default
+end
+
+config.periodical_mailing :weekly_newsletter do |mailing|
+  mailing.title = "Weekly newsletter"
+  mailing.context_name = :active_users
+  mailing.mailer_name = "UserMailer"
+  mailing.enable
+end
+```
+
+### Mailers
+
+You don't need to have any Mailer to use MailyHerald. It works perfectly fine with its generic `MailyHerald::Mailer` and mailing templates written in Luquid. 
+
+But if you still want your fancy Mailer views and features, you need to modify it a bit.
+
+First, each Mailer you want to use with MailyHerald needs to extend `MailyHerald::Mailer` class. 
+Then each Mailer method must be named after mailing identification name and accept only one parameter which is your entity (i.e. `User` class object).
+
+This setup gives you some extra instance variables available in your views:
+
+* `@maily_entity` - entity you are sending this email to,
+* `@maily_mailing` - Mailing you are sending,
+* `@maily_subscription` - `MailyHerald::Subscription` object related to this entity and Mailing,
+
+Here's the complete example:
+
+```ruby
+class UserMailer < MailyHerald::Mailer
+  def hello user
+    mail :subject => "Hi there #{user.name}!"
+  end
+end
+```
+
+### Opt-outs
+
+MailyHerald allows entities to easily opt-out using direct unsubscribe urls. Each entity subscription has its own token and based on this token, opt-out URL is generated.
+
+To process user opt-out requests you need to mount Maily into your app:
+
+```ruby
+# config/routes.rb
+
+mount MailyHerald::Engine => "/unsubscribe", :as => "maily_herald_engine"
+```
+
+Maily provides you with URL helper that generates opt-out URLs (i.e. in your ActionMailer views):
+
+```ruby
+maily_herald_engine.unsubscribe_url(@maily_subscription)
+```
+
+When you use Liquid for email templating, you should use following syntax:
+```
+{{subscription.token_url}}
+```
+
+Visiting opt-out url disables subscription and by default redirects to "/".
+
+### Delivery
+
+From now on, Maily will handle and track your regular mail deliveries:
+
+```ruby
+UserMailer.hello(User.first).deliver
+```
+
+Of course, you can also run the mailing for all users in scope at once:
+
+```ruby
+MailyHerald.dispatch(:hello).run
+```
+
+See [API Docs](http://www.rubydoc.info/gems/maily_herald) for more details about delivery methods.
+
+### Background processing
+
+Start MailyHerald Paperboy which will take care of your other periodical and sequence deliveries:
+
+```
+$ maily_herald paperboy --start
+```
+
+**That's it!**
+
+Your Maily setup is now complete.
+
+## Configuring
+
+You can configure your Maily using config file `config/maily_herald.yml`. Supported options:
+
+* `verbose`: true,false
+* `logfile`: where all the stuff is logged, usually 'log/maily_herald.log`
+* `pidfile`: file name
+* `redis_url`: string
+* `redis_namespace`: string
+* `redis_driver`: string
+
+## Customizing
+
+### Opt-out URLs
+
+By default, visiting opt-out URL disables subscription and redirects to "/". You can easily customize the redirect path by specifying `token_redirect` proc:
+
+```ruby
+# Evaluated within config:
+config.token_redirect do |controller, subscription|
+  # This is just an example, put here whatever you want.
+  controller.view_context.unsubscribed_path
+end
+```
+
+In case you need more customization, you can always overwrite `MailyHerald::TokensController` and its `get` method:
+
+```ruby
+# app/controllers/maily_herald/tokens_controller.rb
+module MailyHerald
+  class TokensController < ::ApplicationController
+    before_action :find_subscription
+
+    def get
+      if @subscription && @subscription.active?
+        @subscription.deactivate!
+        # now render some custom view
+      else
+        redirect_to(main_app.root_url)
+      end
+    end
+
+    private
+
+    def find_subscription
+      @subscription ||= MailyHerald::Subscription.find_by_token(params[:token])
+    end
+  end
+end
+```
+
+### Redis namespaces
+
+If you want to use MailyHerald with non-standard Redis namespace, make sure your Sidekiq is also configured properly. This usually involves creating initializer file:
+
+```ruby
+# config/initializers/sidekiq.rb
+Sidekiq.configure_server do |config|
+  config.redis = { namespace: 'maily' }
+end
+Sidekiq.configure_client do |config|
+  config.redis = { namespace: 'maily' }
+end
+```
+
+Then of course you need to tell Maily about that too:
+
+```yaml
+# config/maily_herald.yml
+---
+:redis_namespace: maily
+```
+
+## More Information
+
+* [Home Page](http://www.mailyherald.org)
+* [API Docs](http://www.rubydoc.info/gems/maily_herald)
+* Showcase (_coming soon_)
+* [Sample application](https://github.com/Sology/maily_testapp)
+
+For bug reports or feature requests see the [issues on Github](https://github.com/Sology/maily_herald/issues).  
+
+## License
+
+LGPLv3 License. Copyright 2013-2015 Sology. http://www.sology.eu
+
+Initial development sponsored by Smart Language Apps Limited http://smartlanguageapps.com/