Carrier is result of extracting simple messaging functionality from one working Rails app.
Insert into Gemfile
Run bundler to bundle gems in the app
$ bundle update
Since Carrier is a Rails 3.1 mountable app, you need to define mount point like:
# config/routes.rb mount Carrier::Engine => "/carrier"
Install Carrier’s migrations and run them:
rake carrier:install:migrations rake db:migrate
Carrier uses Unread to manage read/unread status of messages. So add this into your User model:
# app/models/user.rb class User < ActiveRecord::Base # ... acts_as_reader # ... end
Carrier works only for authenticated users expecting #current_user method somehow defined. Carrier’s controllers namespaces are isolated, so to provide authentication procedure yielding #current_user (before_filter is most common way) add it to Carrier::ApplicationController like:
# your app's root/app/controllers/carrier/application_controller.rb module Carrier class ApplicationController < ActionController::Base before_filter :authenticate_user! # If using Devise end end
This ensures that Carrier will be aware of current authenticated user.
Point your browser to your_apps’s url/carrier, fx:
and you are on the go!
- Rails 3.1
- Carrier has been tested with Devise as authentication system. Any other solution providing #current_user should be just fine too.
- Carrier has been tested to work with MySQL and PostgreSQL. It doesn’t work with SQLite3, because sqlite3 doesn’t serialize fields (maybe this is the issue of current gem environment only). Scope’s queries are using the most basic Arel features so it should be easy to use any other ORM.
The Carrier design is very simple:
It has messages and chains (Message model, and Chain model). Message model has chain_id i.e. messages are simply grouped in chains. Chains are non-threaded, each chain is just a linear sequence of messages.
All queries to messages and their chains are being done using scopes with joins and includes so performance is expected to be fast (review it and advice how accomplish it even better!).
Carrier doesn’t support deletion of messages yet. Instead it supports archivation of chains (Chain has #archived_for field to store serialized array of user’s ids).
Carrier’s templates are written in I18n way. Carrier has two locales :en and :ru pre-written. If you change locale in config/application.rb Carrier will try to find corresponding rules from locale’s yml files
Try dummy app located in spec/ folder. Clone repo, then:
# edit Gemfile: gem 'mysql' or gem 'pg' bundle cd spec/dummy rake reset_db # shortcut for rake db:drop => create => migrate => seed rails s http://localhost/carrier
- Deletion along with archivation
- ORM’s support
- More and better tests
- Stanislaw Pankevich
Copyright © 2011 Stanislaw Pankevich. See LICENSE for details.