Chris@909: == Gravatar Plugin
Chris@909: 
Chris@909: This plugin provides a handful of view helpers for displaying gravatars 
Chris@909: (globally-recognized avatars). 
Chris@909: 
Chris@909: Gravatars allow users to configure an avatar to go with their email address at
Chris@909: a central location: http://gravatar.com. Gravatar-aware websites (such
Chris@909: as yours) can then look up and display each user's preferred avatar, without
Chris@909: having to handle avatar management. The user gets the benefit of not having to
Chris@909: set up an avatar for each site that they post on.
Chris@909: 
Chris@909: == Installation
Chris@909: 
Chris@909:   cd ~/myapp
Chris@909:   ruby script/plugin install git://github.com/woods/gravatar-plugin.git
Chris@909: 
Chris@909: or, if you're using piston[http://piston.rubyforge.org] (worth it!):
Chris@909: 
Chris@909:   cd ~/myapp/vendor/plugins
Chris@909:   piston import git://github.com/woods/gravatar-plugin.git
Chris@909: 
Chris@909: == Example
Chris@909: 
Chris@909: If you represent your users with a model that has an +email+ method (typical
Chris@909: for most rails authentication setups), then you can simply use this method
Chris@909: in your views:
Chris@909: 
Chris@909:   <%= gravatar_for @user %>
Chris@909:   
Chris@909: This will be replaced with the full HTML +img+ tag necessary for displaying 
Chris@909: that user's gravatar.
Chris@909: 
Chris@909: Other helpers are documented under GravatarHelper::PublicMethods.
Chris@909: 
Chris@909: == Acknowledgments
Chris@909: 
Chris@909: Thanks to Magnus Bergmark (http://github.com/Mange), who contributed the SSL
Chris@909: support in this plugin, as well as a few minor fixes.
Chris@909: 
Chris@909: The following people have also written gravatar-related Ruby libraries:
Chris@909: * Seth Rasmussen created the gravatar gem[http://gravatar.rubyforge.org]
Chris@909: * Matt McCray has also created a gravatar 
Chris@909:   plugin[http://mattmccray.com/svn/rails/plugins/gravatar_helper]
Chris@909: 
Chris@909: == Author
Chris@909: 
Chris@909:   Scott A. Woods
Chris@909:   West Arete Computing, Inc.
Chris@909:   http://westarete.com
Chris@909:   scott at westarete dot com
Chris@909: 
Chris@909: == TODO
Chris@909: 
Chris@909: * Add specs for ssl support
Chris@909: * Finish rdoc documentation