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
- have configurable behavior via CanCan Ability
##Upgrading from 0.1 to current version (0.2)
rails generate inboxes:upgrade_discussible and then roll up the migration. Your DB is upgraded!
##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.
Since version 0.2.0, it is possible to add
has_inboxes option to any model. For instance, it can be
gem "inboxes", "~> 0.2.0"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.
- Add CanCan abilities to manage Inboxes models:
can [:index, :create], Discussion can :read, Discussion do |discussion| discussion.can_participate?(user) end
- 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 running Inboxes with Faye, don't forget to run Faye worker it:
rackup faye.ru -s thin -E production
You can read more about that 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.
- Finalize RSpec tests (are located in rspec branch)
- Add Pusher capability
- Email notifications and the ability to answer received emails like in Github issues (#7)
- Kir Shatrov (Evrone Company)
- Nikolay Seskin (Evrone Company)
- Andrey Ognevsky (Evrone Company)
- Alexander Brodyanoj
- Dmitriy Kiriyenko
- Alexey Poimtsev ([http://progress-engine.ru/](Progress Engine))
- Chris Sargeant
##Feel free for pull requests!