Redmine/vendor/plugins/gravatar
Jean-Philippe Lang 2ee45e8cac Use Object#tap instead of #returning (#6887).
git-svn-id: svn+ssh://rubyforge.org/var/svn/redmine/trunk@4406 e93f8b46-1217-0410-a6f0-8f06a7374b81
2010-11-14 16:24:21 +00:00
..
lib Use Object#tap instead of #returning (#6887). 2010-11-14 16:24:21 +00:00
spec Rewrite the Gantt chart. #6276 2010-09-10 03:09:02 +00:00
.gitignore Upgraded the gravatar plugin from http://github.com/woods/gravatar-plugin 2009-08-02 04:19:44 +00:00
MIT-LICENSE Gravatar support for issue detai, user grid, and activity stream 2008-10-30 02:58:04 +00:00
README.rdoc Upgraded the gravatar plugin from http://github.com/woods/gravatar-plugin 2009-08-02 04:19:44 +00:00
Rakefile Rewrite the Gantt chart. #6276 2010-09-10 03:09:02 +00:00
about.yml Upgraded the gravatar plugin from http://github.com/woods/gravatar-plugin 2009-08-02 04:19:44 +00:00
init.rb Gravatar support for issue detai, user grid, and activity stream 2008-10-30 02:58:04 +00:00

README.rdoc

== Gravatar Plugin

This plugin provides a handful of view helpers for displaying gravatars 
(globally-recognized avatars). 

Gravatars allow users to configure an avatar to go with their email address at
a central location: http://gravatar.com. Gravatar-aware websites (such
as yours) can then look up and display each user's preferred avatar, without
having to handle avatar management. The user gets the benefit of not having to
set up an avatar for each site that they post on.

== Installation

  cd ~/myapp
  ruby script/plugin install git://github.com/woods/gravatar-plugin.git

or, if you're using piston[http://piston.rubyforge.org] (worth it!):

  cd ~/myapp/vendor/plugins
  piston import git://github.com/woods/gravatar-plugin.git

== Example

If you represent your users with a model that has an +email+ method (typical
for most rails authentication setups), then you can simply use this method
in your views:

  <%= gravatar_for @user %>
  
This will be replaced with the full HTML +img+ tag necessary for displaying 
that user's gravatar.

Other helpers are documented under GravatarHelper::PublicMethods.

== Acknowledgments

Thanks to Magnus Bergmark (http://github.com/Mange), who contributed the SSL
support in this plugin, as well as a few minor fixes.

The following people have also written gravatar-related Ruby libraries:
* Seth Rasmussen created the gravatar gem[http://gravatar.rubyforge.org]
* Matt McCray has also created a gravatar 
  plugin[http://mattmccray.com/svn/rails/plugins/gravatar_helper]

== Author

  Scott A. Woods
  West Arete Computing, Inc.
  http://westarete.com
  scott at westarete dot com

== TODO

* Add specs for ssl support
* Finish rdoc documentation