Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Demonstrates a reference implementation for sending messages between users

tree: 384624a9be

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 app
Octocat-spinner-32 generators
Octocat-spinner-32 lib
Octocat-spinner-32 test
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 CHANGELOG.rdoc
Octocat-spinner-32 Gemfile
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.rdoc
Octocat-spinner-32 Rakefile
Octocat-spinner-32 has_messages.gemspec
Octocat-spinner-32 init.rb
README.rdoc

has_messages

has_messages demonstrates a reference implementation for sending messages between users.

Resources

API

Bugs

Development

Testing

Source

  • git://github.com/pluginaweek/has_messages.git

Mailing List

Description

Messaging between users is fairly common in web applications, especially those that support social networking. Messaging doesn't necessarily need to be between users, but can also act as a way for the web application to send notices and other notifications to users.

Designing and building a framework that supports this can be complex and takes away from the business focus. This plugin can help ease that process by demonstrating a reference implementation of these features.

Usage

Installation

has_messages requires additional database tables to work. You can generate a migration for these tables like so:

script/generate has_messages

Then simply migrate your database:

rake db:migrate

Adding message support

class User < ActiveRecord::Base
  has_messages
end

This will build the following associations:

  • messages

  • unsent_messages

  • sent_messages

  • received_messages

If you have more specific needs, you can create the same associations manually that has_messages builds. See HasMessages::MacroMethods#has_messages for more information about the asssociations that are generated from this macro.

Creating new messages

message = user.messages.build
message.to user1, user2
message.subject = 'Hey!'
message.body = 'Does anyone want to go out tonight?'
message.deliver

Replying to messages

reply = message.reply_to_all
reply.body = "I'd love to go out!"
reply.deliver

Forwarding messages

forward = message.forward
forward.body = 'Interested?'
forward.deliver

Processing messages asynchronously

In addition to delivering messages immediately, you can also queue messages so that an external application processes and delivers them. This is especially useful for messages that need to be sent outside of the confines of the application.

To queue messages for external processing, you can use the queue event, rather than deliver. This will indicate to any external processes that the message is ready to be sent.

To process queued emails, you need an external cron job that checks and sends them like so:

Message.with_state('queued').each do |message|
  message.deliver
end

Testing

Before you can run any tests, the following gem must be installed:

To run against a specific version of Rails:

rake test RAILS_FRAMEWORK_ROOT=/path/to/rails

Dependencies

Something went wrong with that request. Please try again.