/GravatarBundle

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

Primary LanguagePHPMIT LicenseMIT

OrnicarGravatarBundle

Note: This is the new home for OrnicarGravatarBundle. The package name and namespace will not change. But the code will be maintained.

Build Status

Installation

  1. Add this bundle to your projects composer.json
"require": { 
    "ornicar/gravatar-bundle" : "~1.0"
}
  1. Run composer update to install the bundle and regenerate the autoloader
$ composer update ornicar/gravatar-bundle
  1. Add this bundle to your application's kernel:
// application/ApplicationKernel.php
public function registerBundles()
{
    return array(
        // ...
        new Ornicar\GravatarBundle\OrnicarGravatarBundle(),
        // ...
    );
}
  1. Configure the gravatar service, templating helper and Twig extension in your config:
# application/config/config.yml
ornicar_gravatar: ~
  1. 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('alias@domain.tld') ?>" />

Or with parameters:

<img src="<?php echo $view['gravatar']->getUrl('alias@domain.tld', '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('alias@domain.tld') }}" />

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

{% if gravatar_exists('alias@domain.tld') %}
  The email is an gravatar email
{% endif %}

Or with parameters:

<img src="{{ gravatar('alias@domain.tld', size, rating, default, secure) }}" />

For more information look at the gravatar implementation pages.