= 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]