= ActionMessager

ActionMessager is dead simple IM notifications for your app.

== Get It
  
    $ sudo gem install action_messager
    
    ... or get the source ...
    
    $ git clone git@github.com:giraffesoft/action_messager.git
    
== Usage

ActionMessager works just like ActionMailer. All you have to do start sending IM notifications to your users is subclass 
ActionMessager::Base; then, create a method that sets an array of recipients, and returns the message you'd like to 
send:

  class JabberNotifier < ActionMessager::Base
    def friendship_request(friendship_request)
      @recipients = friendship_request.receiver.jabber_contact
      
      "You have received a friendship request from #{friendship_request.sender.name}! Click here to accept or decline: 
      #{friendship_request.url}"
    end
  end
  
Then, wherever you'd like to send the notification:

  JabberNotifier.deliver_friendship_request(friendship_request)
  
That's it!

== Configuration

You'll need to configure ActionMessager with your jabber credentials.

  ActionMessager::Base.jabber_settings = {
    :username => 'somebody@somejabberserver.com',
    :password => 'swordfish!'
  }

== Credits

ActionMessager was created, and is maintained by {James Golick}[http://jamesgolick.com].

== License

ActionMessager is Copyright (c) 2008 James Golick, GiraffeSoft, Inc. It is released under the {MIT 
License}[http://en.wikipedia.org/wiki/MIT_License]