== sfGravatarPlugin symfony plugin ==

=== Overview ===

Lets you easily use Gravatar from http://site.gravatar.com with a caching system


=== Installation === 

==== Step 1 ====

{{{ 
    symfony plugin-install http://plugins.symfony-project.com/sfGravatarPlugin
    
    symfony cc
}}}

==== Step 2 ====

Create a directory named g_cache in web/uploads and add full rights to it (note : you can change the directory's name but don't forget to change it in config file).

==== Step 3 (optional) ====

 - You can configure you gravatar plugin to your needs by adding the config above in your app.yml
 - You can copy the gravatar_default.png in your cache directory or create your

=== Usage === 
{{{
    <?php use_helper('Gravatar') ?>

    <?php echo gravatar_image_tag($email, $gravatar_rating = null, $gravatar_size = null) ?>
}}}

More information about rating and size on : http://site.gravatar.com

You can set some default option that are common for all of your gravatar in your app.yml

{{{
    all:  
      gravatar:
        default_size:   80
        default_rating: G
        default_image:  gravatar_default.png
        cache_dir_name: g_cache
        cache_expiration: 3 days # refer to strtotime() php function for more infos, but you can write 1 week, 1 year, whatever you want
}}}

=== License === 

For the full copyright and license information, please view the LICENSE
file that was distributed with this source code.

=== Todo ===

 - automatically remove cached gravatar through a cron OR with phptask
 - add unit tests

=== Change log === 

 - 22.09.07 : initial release