Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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

branch: master
README.markdown

OrnicarGravatarBundle

Build Status

Installation

  1. Add this bundle to your projects composer.json

    "require": { 
        "ornicar/gravatar-bundle" : "dev-master"
    }
    
  2. Run composer update to install the bundle and regenerate the autoloader

    $ composer.phar update
    
  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('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.

Something went wrong with that request. Please try again.