Chat

Simple Rails chat plugin that allows users to talk to one or more people at a time that leverages ActionCable.

A demo of functionality can be found: https://chatgem.herokuapp.com/

Getting Started

Prerequisites

  1. This gem relies on ActionCable therefore Rails 5.0.0 is a minimum.
  2. For help setting up ActionCable when coming from an older version of Rails, view this.
  3. An authentication system must be setup before installing chat, like Devise, Clearance, or your own custom solution. The generator will only run unless a users table exists.
  4. Chat assumes that a current_user view helper method exists.
  5. Your connection should be identified by current_user. You can learn more about how to set this up by reading here.

Installation

Add Chat to your application's Gemfile:

gem 'chat'

And then execute:

❯ bundle

Run the installer to setup migrations and helpers and then migrate:

❯ rails generate chat:install
❯ rails db:migrate

Require chat in your app/assets/javascripts/application.js file:

//= require chat

Require chat in your app/assets/stylesheets/application.css file

 *= require chat

Finally, add the following line to your application.html.erb file or any view file you'd like Chat available from:

<%= render_chat %>

Dot Commands

Dot commands behave differently than regular messages and begin with a dot(.). The following commands are available:

  • .shrug followed by an optional message outputs a srugging emoticon
  • .gif following by a label fetches a random gif from giphy with the given label

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/npezza93/chat.

License

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