PHP Classes

oGravatar: Get avatar images and the profile of Gravatar user

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in Bookmark in
  Info   View files View files (9)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings  
2014-05-05 (1 year ago) RSS 2.0 feedNot yet rated by the usersTotal: 191 This week: 2All time: 7,601 This week: 691Up
Version License PHP version Categories  
ogravatar 1.0MIT/X Consortium ...5.4PHP 5, Graphics, Web services
Description Author  

This class can get avatar images and the profile of Gravatar user.

It can return the URL of a user with avatar images in the Gravatar site.

The class can also send HTTP requests to the Gravatar API Web server to get user profile information.

Picture of Andre Roque Filipe
  Performance   Level  
Name: Andre Roque Filipe is available for providing paid consulting. Contact Andre Roque Filipe .
Classes: 8 packages by
Country: Portugal Portugal
Age: 23
All time rank: 131817 in Portugal Portugal
Week rank: 197 Up3 in Portugal Portugal Up
Innovation award
Innovation award
Nominee: 1x

oGravatar <a href="" target="__blank" alt="ReiDuKuduro @gittip" ><img alt="ReiDuKuduro @gittip" src="" /></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('');

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.


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

##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_WAVATAR`

Well, you know…


##It's avatar time!!

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


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'
    //<img src=""  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>';
	    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)

  Files folder image Files  
File Role Description
Files folder imageexceptions (4 files)
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file example.php Example Example script
Accessible without login Plain text file LICENSE Lic. License text
Plain text file oGravatar.php Class Class source
Accessible without login Plain text file Doc. Documentation

  Files folder image Files  /  exceptions  
File Role Description
  Plain text file oGravatarInvalidEmailException.php Class Auxiliary script
  Plain text file oGravatarInvalidRatingException.php Class Auxiliary script
  Plain text file oGravatarInvalidSizeException.php Class Auxiliary script
  Plain text file oGravatarRequestFailedException.php Class Auxiliary script

 Version Control Unique User Downloads Download Rankings  
 100%Total:191All time:7,601
 This week:2This week:691Up