PHP Classes

File: README.md

Recommend this page to a friend!
  Classes of Andre Roque Filipe   oGravatar   README.md   Download  
File: README.md
Role: Documentation
Content type: text/plain
Description: Documentation
Class: oGravatar
Get avatar images and the profile of Gravatar user
Author: By
Last change: Update of README.md
Date: 2 months ago
Size: 2,947 bytes
 

Contents

Class file image Download
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('andre.r.flip@gmail.com'); 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);