oGravatar: Get avatar images and the profile of Gravatar user

Recommend this page to a friend!
  Info   View files (9)   Download .zip   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 201 All time: 8,279 This week: 364
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: 9 packages by
Country: Portugal Portugal
Age: 28
All time rank: 124316 in Portugal Portugal
Week rank: 246 4 in Portugal Portugal
Innovation award
Innovation award
Nominee: 2x

Details
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);

  Files  
File Role Description
exceptions (4 files)
composer.json Data Auxiliary data
example.php Example Example script
LICENSE Lic. License text
oGravatar.php Class Class source
README.md Doc. Documentation

  Files  /  exceptions  
File Role Description
   oGravatarInvalidEmailException.php Class Auxiliary script
   oGravatarInvalidRatingException.php Class Auxiliary script
   oGravatarInvalidSizeException.php Class Auxiliary script
   oGravatarRequestFailedException.php Class Auxiliary script

 Version Control Unique User Downloads Download Rankings  
 100%
Total:201
This week:0
All time:8,279
This week:364

For more information send a message to info at phpclasses dot org.