DeviseSlackNotifiable

Devise slack notifications gem. It posts message after registration and confirmation (if Devise confirmations strategy is enabled).

Gem Version codecov ruby

Installation

Add this line to your application's Gemfile:

gem 'devise_slack_notifiable'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install devise_slack_notifiable

Usage

1. Slack

Prepare Slack Webhook - it should look like https://hooks.slack.com/services/XXX/XXX/XXX.

Not sure how to do that? Check out slack documentation.

2. Application

After preparing Slack Webhook create initializer - config/initializers/devise_slack_notifiable.rb:

DeviseSlackNotifiable.configure do |config|
  # Enabled state
  #   By default integration is disabled. You need to enable it manually on desired environments.
  #   For example production only:
  #     config.enabled = Rails.env.production?
  #   Default: false
  config.enabled = true

  # Slack Webhook URL
  #   Required when integration enabled.
  #   It's recommended to use rails credentials instead of raw url (https://edgeguides.rubyonrails.org/security.html#custom-credentials)
  # Default: nil
  config.slack_webhook = 'YOUR_SLACK_WEBHOOK_URL'

  # Confirmation message state
  #   If You want You can disable sending confirmation message:
  #     config.confirmation_message_enabled
  #   Default: true

  # Context fields
  #   To all messages sent there is context attached that adds entity fields.
  #   If You want to customize fields:
  #     config.context_fields = [:id, :email, :first_name, :last_name]
  #   Default: [:id, :email]
end

After creating initializer add :slack_notifiable 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, :slack_notifiable
end

And you are ready to go!

Messages

Messages overview:

Registration notification Confirmation notification

Customization

Context

If You want to add more fields to context check out configuration in initializer - it's based on context_fields.

Example with context extended by first and last name (as on screenshots):

config.context_fields = [:id, :email, :first_name, :last_name]

Sending own messages

You can send own messages with this context for anywhere You want inside rails application:

# Let's assume that customer with id 1 asked for sales contact
user = User.find(1)
formatter = ->(entity) { "Customer #{entity.id} asked for sales contact!" }

notifier = DeviseSlackNotifiable::Notifier.new
notifier.send_message(user, formatter)

Message formatting

You can customize messages by initializer:

config.registration_message_formatter = lambda { |entity|
                                          "Yeah πŸŽ‰! Looks like we have new #{entity.model_name.human}! 😊"
                                        }
config.confirmation_message_formatter = lambda { |entity|
                                          "#{entity.model_name.human} have just confirmed his account πŸ₯‚"
                                        }

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/b67-engineering/devise_slack_notifiable. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the DeviseSlackNotifiable project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.