henrikbjorn / gravatarbundle

Simple wrapper to gravatar API for Symfony2 - Provides a configurable service and a template helper

GravatarBundle

Deprecated

Installation

1. Add this bundle to your projects composer.json

"require": { 
    "ornicar/gravatar-bundle" : "~1.0"
}

2. Run composer update to install the bundle and regenerate the autoloader

$ composer update ornicar/gravatar-bundle

3. Add this bundle to your application's kernel:

// application/ApplicationKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Ornicar\GravatarBundle\OrnicarGravatarBundle(),
        // ...
    );
}

4. Configure the gravatar service, templating helper and Twig extension in your config:

# application/config/config.yml
ornicar_gravatar: ~

5. If you always have some default for your gravatars such as size, rating or default it can be configured in your config

# application/config/config.yml
ornicar_gravatar:
  rating: g
  size: 80
  default: mm

Usage

All you have to do is use the helper like this example:

<img src="<?php echo $view['gravatar']->getUrl('[email protected]') ?>" />

Or with parameters:

<img src="<?php echo $view['gravatar']->getUrl('[email protected]', '80', 'g', 'defaultimage.png', true) ?>" />

The only required parameter is the email adress. The rest have default values.

If you use twig you can use the helper like this example:

<img src="{{ gravatar('[email protected]') }}" />

Or if you want to check if a gravatar email exists:

{% if gravatar_exists('[email protected]') %}
  The email is an gravatar email
{% endif %}

Or with parameters:

<img src="{{ gravatar('[email protected]', size, rating, default, secure) }}" />

For more information look at the gravatar implementation pages.