File: README.md

oGravatar <a href="https://www.gittip.com/ReiDuKuduro/" target="__blank" alt="ReiDuKuduro @gittip" ><img alt="ReiDuKuduro @gittip" src="http://bottlepy.org/docs/dev/_static/Gittip.png" /></a>
=========

Simple class that provides easy gravatar integration

#Getting the avatar

First you need to create a oGravatar object, see below:
    
    $my_gravatar = new oGravatar('[email protected]');

If you want to use a secure connection, you'll need to pass `true` as second parameter.

Now that you have the object created, you can set the some properties like the image size, rating and a default image, in case of a non Gravatar account.

##Image Size

Simply use the `setSize` function and use an integer greater than 1 and less than 2048 for the pixel size.

    $my_gravatar->setSize(200);

##Image Rating

The function you need is `setRating` and you can use one of the following constants to simplify your life:

- `oGravatar::RATING_G`
- `oGravatar::RATING_PG`
- `oGravatar::RATING_R`
- `oGravatar::RATING_X`

Just like this:

    $my_gravatar->setRating(oGravatar::RATING_X);
    
##Default Image

As you can imagine, my creativity isn't that great, I called this function `setDefault`, you can either set the image path, that you want to define as default, or use one of the following constants:

- `oGravatar::DEFAULT_404`
- `oGravatar::DEFAULT_MM`
- `oGravatar::DEFAULT_IDENTICON`
- `oGravatar::DEFAULT_MONSTERID`
- `oGravatar::DEFAULT_WAVATAR`

Well, you know…

    $my_gravatar->setDefault(oGravatar::DEFAULT_MONSTERID);

##It's avatar time!!

Now that you know how to set some properties, you can get the image, to get the URL.

    $my_gravatar->getAvatarUrl();
    //http://en.gravatar.com/avatar/c34fd2d73a25fabf0bf9ef8f85dbae42?s=200&r=x&d=monsterid

If you dont want to loose time writing the HTML, you can do it this way:
    
    $attributes = array(
        'id'    => 'my_gravatar_image',
        'class' => 'some_random_class or-not',
        'style' => 'height: 200px',
        'width' => '200px'
    );
    $my_gravatar->getAvatar($attibutes);
    //<img src="http://en.gravatar.com/avatar/c34fd2d73a25fabf0bf9ef8f85dbae42?s=200&r=x&d=monsterid"  id="my_gravatar_image"  class="some_random_class or-not"  style="height: 200px"  width="200px"  />

#Getting the profile info

If you want to request the profile info simply call `$my_gravatar->getProfile();`, once you do that, you can check if they email you are using has a profile by doing something like this:

    if ($my_gravatar->has_profile) {
	    echo '<pre>';
    	print_r($my_gravatar);
	    echo '</pre>';
    } else {
	    echo "This email doesn't have a gravatar account";
    }
#But wait there is more…

… you can chain the functions, watch it:

    echo $my_gravatar->setSize(200)
                     ->setRating(oGravatar::RATING_X)
                     ->setDefault(oGravatar::DEFAULT_MONSTERID)
                     ->getAvatar($attributes);