README

A simple gravatar package for php

• Provides a fluent interface with Gravatar API
• Seamless integration with Laravel 4

This is a direct clone of https://github.com/MalonMedia/gravatari to resolve this issue: https://github.com/MalonMedia/gravatari/issues/1

Installation

Installing via Composer

The recommended way to install Gravatari is through Composer.

1. Add malonmedia/gravatari as a dependency in your project's composer.json file:

    {
        "require": {
            "jchaney01/gravatari": "*"
        }
    }
   

2. Download and install Composer:

    curl -s http://getcomposer.org/installer | php
   

3. Install your dependencies:

    php composer.phar install
   

4. Require Composer's autoloader

   Composer also prepares an autoload file that's capable of autoloading all of the classes in any of the libraries that it downloads. To use it, just add the following line to your code's bootstrap process:

    require 'vendor/autoload.php';
   

You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at getcomposer.org.

Usage

Images (avatars)

<?php

use Gravatari\Api\Image;

$gravatar = new Image;

// Generate url for 80x80 avatar using Mystery Man if avatar does not exist
$url = $gravatar->size(80)->default('mm')->url('[email protected]');

Options

size(80)                size in pixels                      1 - 2048
default('404')          image to use as default             404, mm, identicon, monsterid, wavatar, retro, blank, OR an url
forceDefault('no')      whether to force default image      yes, no
rating('g')             maximum allowed content rating      g, pg, r, x

Url Generation

    url('[email protected]')          //retrieve the url for the supplied email's gravatar
    
    urlSecure('[email protected]')    //retrieve a secure url for the supplied email's gravatar

Profiles

<?php

use Gravatari\Api\Profile;

$profile = new Profile;

// Url Methods (retrieve url in specified format)
$profile->url('[email protected]');
$profile->urlJson('[email protected]');
$profile->urlJson('[email protected]', 'alert');      //Json method accepts optional javascript callback paremeter
$profile->urlXml('[email protected]');
$profile->urlPhp('[email protected]');
$profile->urlVcf('[email protected]');
$profile->urlQr('[email protected]');

// Request Methods (send request and return response for specified format)
$profile->requestJson('[email protected]');
$profile->requestJson('[email protected]', 'alert');  //Json method accepts optional javascript callback paremeter
$profile->requestXml('[email protected]');
$profile->requestPhp('[email protected]');

Extensions

Support for some common frameworks is/will be provided through extensions. Below are instructions for currently supported extensions (more will be provided in the future):

Laravel 4

1. Add 'Gravatari\Extension\Laravel\GravatariServiceProvider', to the providers array in app/config/app.php.
2. Add 'Gravatari' => 'Gravatari\Extension\Laravel\Facades\Gravatari', to the aliases array in app/config/app.php.
3. To access the avatar api, use Gravatari::image()->url('[email protected]') or simply Gravatari::url('[email protected]')
4. To access the profile api, use Gravatari::profile()->urlJson('[email protected]')