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

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 DependencyInjection
Octocat-spinner-32 Resources
Octocat-spinner-32 Templating
Octocat-spinner-32 Tests
Octocat-spinner-32 Twig
Octocat-spinner-32 GravatarApi.php
Octocat-spinner-32 GravatarBundle.php
Octocat-spinner-32 LICENSE
Octocat-spinner-32 README.markdown
README.markdown

Installation

  1. Add this bundle to your project as Git submodules:

      $ git submodule add git://github.com/ornicar/GravatarBundle.git src/Bundle/GravatarBundle
    
  2. Add this bundle to your application's kernel:

      // application/ApplicationKernel.php
      public function registerBundles()
      {
          return array(
              // ...
              new Bundle\GravatarBundle\GravatarBundle(),
              // ...
          );
      }
    
  3. Configure the gravatar service, templating helper and Twig extension in your config:

      # application/config/config.yml
      gravatar.config: ~
    
  4. 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
     gravatar.config:
        rating: g
        size: 80
        default: ~
    

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') ?>" />

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

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

  {{ 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:

  {{ gravatar('alias@domain.tld', site, rating, default) }}

For more information look at the gravatar implementation pages.

Something went wrong with that request. Please try again.