Inboxes is a young messaging system for Rails app. It:
- provides 3 models for developers: Discussion, Message and Speaker
- read/unread discussions counter
- any user can be invited to discussion by the member of this discussion, so you can chat with unlimited number of users
Requirements and recommendations
Inboxes requires Rails 3.x and Devise for user identification (surely, messaging system is not possible without users). Now the gem is tested only with Ruby 1.8.7 and REE.
We recommend to use Inboxes with Faye, because it's really sexy with it.
Remember that unfortunately, Inboxes reserve 3 resources names: Discussion, Message and Speaker.
Make sure that Devise is already installed and configured in your app!
gem "inboxes", "~> 0.1.2"to the
rails generate inboxes:install. This command will generate migration for messaging system. Don't forget to run migrations:
has_inboxesto your User model like here
- Now Inboxes are ready to use. Open
http://yoursite.dev/discussionsto see the list of discussions. You can start new one.
Default Inboxes views are ugly, so you can copy into your app and make anything with them:
rails generate inboxes:views
If you have problems with installation, you can check code of demo app
By default, the gem provides localized phrases for Russian and English languages. You can easily override any of them. Here is list of all I18n phrases.
Integration with Faye
You can watch the demo of integration on YouTube
gem "faye"to your Gemfile and run
bundle install. Install Faye by the screencast
//= require inboxes/faye
Add config parameters to your application config (last 2 are not necessary):
config.inboxes.faye_enabled = true config.inboxes.faye_host = "inboxes-app.dev" # localhost by default config.inboxes.faye_port = 9292 # 9292 by default
- Faye installation is finished. If you have any troubles, check the example app
While testing Inboxes with Faye, don't forget to run it:
rackup faye.ru -s thin -E production
You can read more about Faye on it's official page.
- If you want to add breadcrumbs to Inboxes pages, we recommend you to use crummy gem. It allows to define breadcrumbs in views.
- Add RSpec tests