activity_notification 1.3.0 → 1.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e179e93cf2ac56df97de6634905fa1167b46ed6c
-  data.tar.gz: 1ee6aa961fcaf36d1b57d51b6eb984b4994c0b1a
+  metadata.gz: 88318797860ba42ece844a7e4b34152b3ea640a7
+  data.tar.gz: b7ba3947ed5473862f6f804eeff88e0e259f3e60
 SHA512:
-  metadata.gz: 013879fc731c40a053424a7a1910602f551baf17f200fbdd297458dbf45d3d8dd09c4eed978096ae9939da7b76bd8233ec860cd1a56d6d3f3f7cdbe1072ddb1a
-  data.tar.gz: 46afc218dd6ee8feded9f54acfc0819a9fb60ab956bd5e80f83aa9975f3b9b9d92bbaa221a3d427d023ebbae6401a9d0c622cf8838a97d279ee86cd881b77826
+  metadata.gz: c215def478cbd3ecc909fc3e24cf7bf803dc6e5342893bfd14b2c987ef72b28a147e73b0871b775a59acb738ba2324522f97abd1e7ea448d7862303def127800
+  data.tar.gz: 0b84b958c2a507ce739a73a3f8afc76e7525b810ddd953e2d78a298e445ef1ee653754c2e38bbfbad11157fe0e24803c7a6fa42da0f339fa46c61df021bf9e9b

data/.travis.yml

@@ -13,8 +13,9 @@ rvm:
 
 gemfile:
   - Gemfile
-  - gemfiles/Gemfile.rails-5.0
   - gemfiles/Gemfile.rails-4.2
+  - gemfiles/Gemfile.rails-5.0
+  - gemfiles/Gemfile.rails-5.1
 
 env:
   - AN_ORM=active_record
@@ -22,12 +23,44 @@ env:
 
 matrix:
   exclude:
+    - rvm: 2.1.10
+      gemfile: Gemfile
     - rvm: 2.1.10
       gemfile: gemfiles/Gemfile.rails-5.0
     - rvm: 2.1.10
-      gemfile: Gemfile
-    - env: AN_ORM=mongoid
-      gemfile: Gemfile
+      gemfile: gemfiles/Gemfile.rails-5.1
+    - rvm: ruby-head
+      env: AN_ORM=mongoid
+    - gemfile: Gemfile
+      env: AN_ORM=mongoid
+  include:
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-4.2
+      env: AN_ORM=active_record AN_TEST_DB=mysql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-4.2
+      env: AN_ORM=active_record AN_TEST_DB=postgresql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-4.2
+      env: AN_ORM=mongoid AN_TEST_DB=mongodb
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.0
+      env: AN_ORM=active_record AN_TEST_DB=mysql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.0
+      env: AN_ORM=active_record AN_TEST_DB=postgresql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.0
+      env: AN_ORM=mongoid AN_TEST_DB=mongodb
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.1
+      env: AN_ORM=active_record AN_TEST_DB=mysql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.1
+      env: AN_ORM=active_record AN_TEST_DB=postgresql
+    - rvm: 2.4.1
+      gemfile: gemfiles/Gemfile.rails-5.1
+      env: AN_ORM=mongoid AN_TEST_DB=mongodb
   allow_failures:
     - rvm: ruby-head
   fast_finish: true
@@ -41,7 +74,10 @@ cache: bundler
 
 before_install: "rm ${BUNDLE_GEMFILE}.lock"
 
-before_script: "bundle update"
+before_script:
+  - bundle update
+  - mysql -e 'create database activity_notification_test'
+  - psql -c 'create database activity_notification_test' -U postgres
 
 script: bundle exec rspec
 

data/CHANGELOG.md

@@ -1,7 +1,26 @@
+## 1.4.0 / 2017-05-10
+[Full Changelog](http://github.com/simukappu/activity_notification/compare/v1.3.0...v1.4.0)
+
+Enhancements:
+
+* Allow use with Rails 5.1
+* Allow mongoid models as `Target` and `Notifiable` models
+* Add functions for automatic tracked notifications
+* Enable `render_notification_of` view helper method to use `:as_latest_group_member` option
+
+Bug Fixes:
+
+* Fix illegal ActiveRecord query for MySQL and PostgreSQL database
+
+Breaking Changes:
+
+* Update type of polymolohic id field in Notification and Subscription from Integer to String
+
 ## 1.3.0 / 2017-04-07
 [Full Changelog](http://github.com/simukappu/activity_notification/compare/v1.2.1...v1.3.0)
 
 Enhancements:
+
 * Suport Mongoid ORM to store `Notification` and `Subscription` records
   * Separate `Notification` and `Subscription` models into ORMs and make them load from ORM selector
   * Update query logic in `Notification` and `Subscription` models for Mongoid
@@ -13,6 +32,7 @@ Enhancements:
 [Full Changelog](http://github.com/simukappu/activity_notification/compare/v1.2.0...v1.2.1)
 
 Enhancements:
+
 * Support default Slack optional target with `slack-notifier` 2.0.0
 
 Breaking Changes:

data/Gemfile

@@ -2,7 +2,10 @@ source 'https://rubygems.org'
 
 gemspec
 
-gem 'rails', '~> 5.0'
+gem 'rails', '~> 5.1'
+
+#TODO Remove it after devise supporting rails 5.1 is released
+gem 'devise', github: 'plataformatec/devise', ref: '83002017'
 
 group :development do
   gem 'bullet'

data/Gemfile.lock

@@ -1,48 +1,60 @@
+GIT
+  remote: git://github.com/plataformatec/devise.git
+  revision: 83002017ea4761e30796f3b288be9c7d9b870fcd
+  ref: 83002017
+  specs:
+    devise (4.2.1)
+      bcrypt (~> 3.0)
+      orm_adapter (~> 0.1)
+      railties (>= 4.1.0, < 5.2)
+      responders
+      warden (~> 1.2.3)
+
 PATH
   remote: .
   specs:
-    activity_notification (1.3.0)
+    activity_notification (1.4.0)
       activerecord (>= 4.2.0)
       i18n (>= 0.5.0)
       jquery-rails (>= 3.1.1)
-      railties (>= 4.2.0, < 5.1)
+      railties (>= 4.2.0, < 5.2)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actioncable (5.0.2)
-      actionpack (= 5.0.2)
-      nio4r (>= 1.2, < 3.0)
+    actioncable (5.1.0)
+      actionpack (= 5.1.0)
+      nio4r (~> 2.0)
       websocket-driver (~> 0.6.1)
-    actionmailer (5.0.2)
-      actionpack (= 5.0.2)
-      actionview (= 5.0.2)
-      activejob (= 5.0.2)
+    actionmailer (5.1.0)
+      actionpack (= 5.1.0)
+      actionview (= 5.1.0)
+      activejob (= 5.1.0)
       mail (~> 2.5, >= 2.5.4)
       rails-dom-testing (~> 2.0)
-    actionpack (5.0.2)
-      actionview (= 5.0.2)
-      activesupport (= 5.0.2)
+    actionpack (5.1.0)
+      actionview (= 5.1.0)
+      activesupport (= 5.1.0)
       rack (~> 2.0)
       rack-test (~> 0.6.3)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.0.2)
-    actionview (5.0.2)
-      activesupport (= 5.0.2)
+    actionview (5.1.0)
+      activesupport (= 5.1.0)
       builder (~> 3.1)
-      erubis (~> 2.7.0)
+      erubi (~> 1.4)
       rails-dom-testing (~> 2.0)
       rails-html-sanitizer (~> 1.0, >= 1.0.3)
-    activejob (5.0.2)
-      activesupport (= 5.0.2)
+    activejob (5.1.0)
+      activesupport (= 5.1.0)
       globalid (>= 0.3.6)
-    activemodel (5.0.2)
-      activesupport (= 5.0.2)
-    activerecord (5.0.2)
-      activemodel (= 5.0.2)
-      activesupport (= 5.0.2)
-      arel (~> 7.0)
-    activesupport (5.0.2)
+    activemodel (5.1.0)
+      activesupport (= 5.1.0)
+    activerecord (5.1.0)
+      activemodel (= 5.1.0)
+      activesupport (= 5.1.0)
+      arel (~> 8.0)
+    activesupport (5.1.0)
       concurrent-ruby (~> 1.0, >= 1.0.2)
       i18n (~> 0.7)
       minitest (~> 5.1)
@@ -51,14 +63,14 @@ GEM
       activesupport (>= 3.0)
       railties (>= 3.0)
       rspec-rails (>= 2.2)
-    arel (7.1.4)
-    aws-sdk (2.9.1)
-      aws-sdk-resources (= 2.9.1)
-    aws-sdk-core (2.9.1)
+    arel (8.0.0)
+    aws-sdk (2.9.16)
+      aws-sdk-resources (= 2.9.16)
+    aws-sdk-core (2.9.16)
       aws-sigv4 (~> 1.0)
       jmespath (~> 1.0)
-    aws-sdk-resources (2.9.1)
-      aws-sdk-core (= 2.9.1)
+    aws-sdk-resources (2.9.16)
+      aws-sdk-core (= 2.9.16)
     aws-sigv4 (1.0.0)
     bcrypt (3.1.11)
     bson (4.2.1)
@@ -67,72 +79,68 @@ GEM
       activesupport (>= 3.0.0)
       uniform_notifier (~> 1.10.0)
     concurrent-ruby (1.0.5)
-    coveralls (0.8.20)
+    coveralls (0.8.21)
       json (>= 1.8, < 3)
       simplecov (~> 0.14.1)
       term-ansicolor (~> 1.3)
       thor (~> 0.19.4)
       tins (~> 1.6)
-    devise (4.2.1)
-      bcrypt (~> 3.0)
-      orm_adapter (~> 0.1)
-      railties (>= 4.1.0, < 5.1)
-      responders
-      warden (~> 1.2.3)
     diff-lcs (1.3)
     docile (1.1.5)
-    dotenv (2.2.0)
-    dotenv-rails (2.2.0)
-      dotenv (= 2.2.0)
-      railties (>= 3.2, < 5.1)
-    erubis (2.7.0)
+    dotenv (2.2.1)
+    dotenv-rails (2.2.1)
+      dotenv (= 2.2.1)
+      railties (>= 3.2, < 5.2)
+    erubi (1.6.0)
     factory_girl (4.8.0)
       activesupport (>= 3.0.0)
     factory_girl_rails (4.8.0)
       factory_girl (~> 4.8.0)
       railties (>= 3.0.0)
-    globalid (0.3.7)
-      activesupport (>= 4.1.0)
+    globalid (0.4.0)
+      activesupport (>= 4.2.0)
     i18n (0.8.1)
     jmespath (1.3.1)
     jquery-rails (4.3.1)
       rails-dom-testing (>= 1, < 3)
       railties (>= 4.2.0)
       thor (>= 0.14, < 2.0)
-    json (2.0.3)
+    json (2.1.0)
     loofah (2.0.3)
       nokogiri (>= 1.5.9)
-    mail (2.6.4)
+    mail (2.6.5)
       mime-types (>= 1.16, < 4)
     method_source (0.8.2)
     mime-types (3.1)
       mime-types-data (~> 3.2015)
     mime-types-data (3.2016.0521)
     mini_portile2 (2.1.0)
-    minitest (5.10.1)
+    minitest (5.10.2)
     mongo (2.4.1)
       bson (>= 4.2.1, < 5.0.0)
     mongoid (6.1.0)
       activemodel (~> 5.0)
       mongo (>= 2.4.1, < 3.0.0)
+    mysql2 (0.4.6)
     nio4r (2.0.0)
-    nokogiri (1.7.1)
+    nokogiri (1.7.2)
       mini_portile2 (~> 2.1.0)
     orm_adapter (0.5.0)
-    rack (2.0.1)
+    pg (0.20.0)
+    rack (2.0.2)
     rack-test (0.6.3)
       rack (>= 1.0)
-    rails (5.0.2)
-      actioncable (= 5.0.2)
-      actionmailer (= 5.0.2)
-      actionpack (= 5.0.2)
-      actionview (= 5.0.2)
-      activejob (= 5.0.2)
-      activemodel (= 5.0.2)
-      activerecord (= 5.0.2)
-      activesupport (= 5.0.2)
+    rails (5.1.0)
+      actioncable (= 5.1.0)
+      actionmailer (= 5.1.0)
+      actionpack (= 5.1.0)
+      actionview (= 5.1.0)
+      activejob (= 5.1.0)
+      activemodel (= 5.1.0)
+      activerecord (= 5.1.0)
+      activesupport (= 5.1.0)
       bundler (>= 1.3.0, < 2.0)
-      railties (= 5.0.2)
+      railties (= 5.1.0)
       sprockets-rails (>= 2.0.0)
     rails-controller-testing (1.0.1)
       actionpack (~> 5.x)
@@ -143,15 +151,16 @@ GEM
       nokogiri (~> 1.6)
     rails-html-sanitizer (1.0.3)
       loofah (~> 2.0)
-    railties (5.0.2)
-      actionpack (= 5.0.2)
-      activesupport (= 5.0.2)
+    railties (5.1.0)
+      actionpack (= 5.1.0)
+      activesupport (= 5.1.0)
       method_source
       rake (>= 0.8.7)
       thor (>= 0.18.1, < 2.0)
     rake (12.0.0)
-    responders (2.3.0)
-      railties (>= 4.2.0, < 5.1)
+    responders (2.4.0)
+      actionpack (>= 4.2.0, < 5.3)
+      railties (>= 4.2.0, < 5.3)
     rspec-core (3.5.4)
       rspec-support (~> 3.5.0)
     rspec-expectations (3.5.0)
@@ -183,7 +192,7 @@ GEM
       activesupport (>= 4.0)
       sprockets (>= 3.0.0)
     sqlite3 (1.3.13)
-    term-ansicolor (1.5.0)
+    term-ansicolor (1.6.0)
       tins (~> 1.0)
     thor (0.19.4)
     thread_safe (0.3.6)
@@ -197,7 +206,7 @@ GEM
     websocket-driver (0.6.5)
       websocket-extensions (>= 0.1.0)
     websocket-extensions (0.1.2)
-    yard (0.9.8)
+    yard (0.9.9)
     yard-activesupport-concern (0.0.1)
       yard (>= 0.8)
 
@@ -210,18 +219,20 @@ DEPENDENCIES
   aws-sdk (~> 2)
   bullet
   coveralls
-  devise (~> 4.2.1)
+  devise!
   dotenv-rails
   factory_girl_rails (~> 4.8.0)
   mongoid (>= 4.0.0)
-  rails (~> 5.0)
+  mysql2 (~> 0.4.6)
+  pg (~> 0.20.0)
+  rails (~> 5.1)
   rails-controller-testing
-  rspec-rails (~> 3.5.1)
+  rspec-rails (~> 3.5.2)
   simplecov (~> 0.14.1)
   slack-notifier (>= 1.5.1)
   sqlite3 (~> 1.3.13)
   timecop
-  yard (~> 0.9.8)
+  yard (~> 0.9.9)
   yard-activesupport-concern (~> 0.0.1)
 
 BUNDLED WITH

data/README.md

@@ -10,7 +10,7 @@
 
 `activity_notification` provides integrated user activity notifications for Ruby on Rails. You can easily use it to configure multiple notification targets and make activity notifications with notifiable models, like adding comments, responding etc.
 
-`activity_notification` supports Rails 5.0 and 4.2+. Also, it is supported with ActiveRecord and [Mongoid](http://mongoid.org) ORM.
+`activity_notification` supports Rails 4.2+ with ActiveRecord and [Mongoid](http://mongoid.org) ORM. It is tested for MySQL, PostgreSQL, SQLite with ActiveRecord ORM and MongoDB with Mongoid ORM.
 
 
 ## About
@@ -18,8 +18,9 @@
 `activity_notification` provides following functions:
 * Notification API (creating notifications, query for notifications and managing notification parameters)
 * Notification models (stored with ActiveRecord or [Mongoid](http://mongoid.org) ORM)
-* Notification controllers (managing open/unopen of notifications, link to notifiable activity page)
+* Notification controllers (managing open/unopen of notifications, providing link to notifiable activity page)
 * Notification views (presentation of notifications)
+* Automatic tracked notifications (generating notifications along with the lifecycle of notifiable models)
 * Grouping notifications (grouping like `"Kevin and 7 other users posted comments to this article"`)
 * Email notification
 * Batch email notification (event driven or periodical email notification, daily or weekly etc)
@@ -57,6 +58,8 @@
   - [Configuring controllers](#configuring-controllers)
   - [Configuring routes](#configuring-routes)
   - [Creating notifications](#creating-notifications)
+    - [Notification API](#notification-api)
+    - [Automatic tracked notifications](#automatic-tracked-notifications)
   - [Displaying notifications](#displaying-notifications)
     - [Preparing target notifications](#preparing-target-notifications)
     - [Rendering notifications](#rendering-notifications)
@@ -147,12 +150,28 @@ You need to configure Mongoid in your Rails application for your MongoDB environ
 Configure your target model (e.g. app/models/user.rb).
 Add `acts_as_target` configuration to your target model to get notifications.
 
+##### Target as ActiveRecord model
+
 ```ruby
 class User < ActiveRecord::Base
   # acts_as_target configures your model as ActivityNotification::Target
-  # with parameters as value or custom methods defined in your model as lambda or symbol
+  # with parameters as value or custom methods defined in your model as lambda or symbol.
+  # This is an example without any options (default configuration) as the target.
+  acts_as_target
+end
+```
+
+##### Target as  Mongoid model
 
-  # This is an example without any options (default configuration) as the target
+```ruby
+require 'mongoid'
+class User
+  include Mongoid::Document
+  include Mongoid::Timestamps
+  include GlobalID::Identification
+
+  # You need include ActivityNotification::Models except ActiveRecord models
+  include ActivityNotification::Models
   acts_as_target
 end
 ```
@@ -162,9 +181,11 @@ end
 #### Configuring notifiable model
 
 Configure your notifiable model (e.g. app/models/comment.rb).
-Add `acts_as_notifiable` configuration to your notifiable model representing activity to notify.
+Add `acts_as_notifiable` configuration to your notifiable model representing activity to notify for each of your target model.
 You have to define notification targets for all notifications from this notifiable model by `:targets` option. Other configurations are options. `:notifiable_path` option is a path to move when the notification is opened by the target user.
 
+##### Notifiable as ActiveRecord model
+
 ```ruby
 class Article < ActiveRecord::Base
   belongs_to :user
@@ -177,7 +198,8 @@ class Comment < ActiveRecord::Base
   belongs_to :user
 
   # acts_as_notifiable configures your model as ActivityNotification::Notifiable
-  # with parameters as value or custom methods defined in your model as lambda or symbol
+  # with parameters as value or custom methods defined in your model as lambda or symbol.
+  # The first argument is the plural symbol name of your target model.
   acts_as_notifiable :users,
     # Notification targets as :targets is a necessary option
     # Set to notify to author and users commented to the article, except comment owner self
@@ -194,6 +216,42 @@ class Comment < ActiveRecord::Base
 end
 ```
 
+##### Notifiable as Mongoid model
+
+```ruby
+require 'mongoid'
+class Article
+  include Mongoid::Document
+  include Mongoid::Timestamps
+
+  belongs_to :user
+  has_many :comments, dependent: :destroy
+
+  def commented_users
+    User.where(:id.in => comments.pluck(:user_id))
+  end
+end
+
+require 'mongoid'
+class Comment
+  include Mongoid::Document
+  include Mongoid::Timestamps
+  include GlobalID::Identification
+
+  # You need include ActivityNotification::Models except ActiveRecord models
+  include ActivityNotification::Models
+  acts_as_notifiable :users,
+    targets: ->(comment, key) {
+      ([comment.article.user] + comment.article.commented_users.to_a - [comment.user]).uniq
+    },
+    notifiable_path: :article_notifiable_path
+
+  def article_notifiable_path
+    article_path(article)
+  end
+end
+```
+
 ### Configuring views
 
 `activity_notification` provides view templates to customize your notification views. The view generator can generate default views for all targets.
@@ -282,6 +340,8 @@ end
 
 ### Creating notifications
 
+#### Notification API
+
 You can trigger notifications by setting all your required parameters and triggering `notify`
 on the notifiable model, like this:
 
@@ -295,7 +355,57 @@ Or, you can call public API as `ActivityNotification::Notification.notify`
 ActivityNotification::Notification.notify :users, @comment, key: "comment.reply"
 ```
 
+The first argument is the plural symbol name of your target model, which is configured in notifiable model by `acts_as_notifiable`.
+
 *Hint*: `:key` is a option. Default key `#{notifiable_type}.default` which means `comment.default` will be used without specified key.
+You can override it by `Notifiable#default_notification_key`.
+
+#### Automatic tracked notifications
+
+You can also generate automatic tracked notifications by `:tracked` option in `acts_as_notifiable`.
+`:tracked` option adds required callbacks to generate notifications for creation and update of the notifiable model.
+Set true to `:tracked` option to generate all tracked notifications, like this:
+
+```ruby
+class Comment < ActiveRecord::Base
+  acts_as_notifiable :users,
+    targets: ->(comment, key) {
+      ([comment.article.user] + comment.article.commented_users.to_a - [comment.user]).uniq
+    },
+    # Set true to :tracked option to generate automatic tracked notifications.
+    # It adds required callbacks to generate notifications for creation and update of the notifiable model.
+    tracked: true
+end
+```
+
+Or, set `:only` or `:except` option to generate specified tracked notifications, like this:
+
+```ruby
+class Comment < ActiveRecord::Base
+  acts_as_notifiable :users,
+    targets: ->(comment, key) {
+      ([comment.article.user] + comment.article.commented_users.to_a - [comment.user]).uniq
+    },
+    # Set { only: [:create] } to :tracked option to generate tracked notifications for creation only.
+    # It adds required callbacks to generate notifications for creation of the notifiable model.
+    tracked: { only: [:create] }
+end
+```
+
+```ruby
+class Comment < ActiveRecord::Base
+  acts_as_notifiable :users,
+    targets: ->(comment, key) {
+      ([comment.article.user] + comment.article.commented_users.to_a - [comment.user]).uniq
+    },
+    # Set { except: [:update] } to :tracked option to generate tracked notifications except update (creation only).
+    # It adds required callbacks to generate notifications for creation of the notifiable model.
+    tracked: { except: [:update] }
+end
+```
+
+*Hint*: `#{notifiable_type}.create` and `#{notifiable_type}.update` will be used as the key of tracked notifications.
+You can override them by `Notifiable#notification_key_for_tracked_creation` and `Notifiable#notification_key_for_tracked_update`.
 
 ### Displaying notifications
 
@@ -361,7 +471,7 @@ Then, content named `:notification_index` will be prepared and you can use it in
 Sometimes, it's desirable to pass additional local variables to partials. It can be done this way:
 
 ```erb
-<%= render_notification(@notification, locals: {friends: current_user.friends}) %>
+<%= render_notification(@notification, locals: { friends: current_user.friends }) %>
 ```
 
 #### Notification views
@@ -626,7 +736,7 @@ This makes all target model subscribers. You can also configure them for each ta
 class User < ActiveRecord::Base
   # Example using confirmed_at of devise field
   # to decide whether activity_notification manages subscriptions of this user
-  acts_as_target email: :email, email_allowed: :confirmed_at, subscription_allowed: confirmed_at
+  acts_as_target email: :email, email_allowed: :confirmed_at, subscription_allowed: :confirmed_at
 end
 ```
 
@@ -786,7 +896,7 @@ class Comment < ActiveRecord::Base
   require 'activity_notification/optional_targets/amazon_sns'
   require 'activity_notification/optional_targets/slack'
   require 'custom_optional_targets/console_output'
-  acts_as_notifiable :admins, targets: Admin.all,
+  acts_as_notifiable :admins, targets: [Admin.first].compact,
     notifiable_path: :article_notifiable_path,
     # Set optional target implementation class and initializing parameters
     optional_targets: {
@@ -839,7 +949,7 @@ Any other options for `Aws::SNS::Client.new` are available as initializing param
 ```ruby
 class Comment < ActiveRecord::Base
   require 'activity_notification/optional_targets/amazon_sns'
-  acts_as_notifiable :admins, targets: Admin.all,
+  acts_as_notifiable :admins, targets: [Admin.first].compact,
     optional_targets: {
       ActivityNotification::OptionalTarget::AmazonSNS => { topic_arn: 'arn:aws:sns:XXXXX:XXXXXXXXXXXX:XXXXX' }
     }
@@ -862,7 +972,7 @@ Any other options for `Slack::Notifier.new` are available as initializing parame
 ```ruby
 class Comment < ActiveRecord::Base
   require 'activity_notification/optional_targets/slack'
-  acts_as_notifiable :admins, targets: Admin.all,
+  acts_as_notifiable :admins, targets: [Admin.first].compact,
     optional_targets: {
       ActivityNotification::OptionalTarget::Slack  => {
         webhook_url: 'https://hooks.slack.com/services/XXXXXXXXX/XXXXXXXXX/XXXXXXXXXXXXXXXXXXXXXXXX',
@@ -912,7 +1022,7 @@ Then, you can configure them to notifiable model by `acts_as_notifiable` like th
 ```ruby
 class Comment < ActiveRecord::Base
   require 'custom_optional_targets/amazon_sns'
-  acts_as_notifiable :admins, targets: Admin.all,
+  acts_as_notifiable :admins, targets: [Admin.first].compact,
     optional_targets: {
       CustomOptionalTarget::AmazonSNS => { topic_arn: 'arn:aws:sns:XXXXX:XXXXXXXXXXXX:XXXXX' }
     }
@@ -1002,6 +1112,36 @@ $ bin/rails server
 ```
 Then, you can access <http://localhost:3000> for the dummy application.
 
+##### Run with your local database
+As default, dummy Rails application runs with local SQLite database in `spec/rails_app/db/development.sqlite3`.
+This application supports to run with your local MySQL, PostgreSQL and MongoDB.
+Set `AN_TEST_DB` environment variable like:
+```console
+$ export AN_TEST_DB=mysql
+```
+for MySQL,
+```console
+$ export AN_TEST_DB=postgresql
+```
+for PostgreSQL, and
+```console
+$ export AN_TEST_DB=mongodb
+```
+for MongoDB. When you set `mongodb` as `AN_TEST_DB`, you have to use `activity_notification` with MongoDB. Also set `AN_ORM` like:
+```console
+$ export AN_ORM=mongoid
+```
+
+Then, configure `spec/rails_app/config/database.yml` or `spec/rails_app/config/mongoid.yml` as your local database.
+Finally, run database migration, seed data script and the dummy appliation.
+```console
+$ cd spec/rails_app
+$ # You don't need migration when you use MongoDB only (AN_ORM=mongoid and AN_TEST_DB=mongodb)
+$ bin/rake db:migrate
+$ bin/rake db:seed
+$ bin/rails server
+```
+
 
 ## Documentation