Gravatar

Gravatar is a service for providing globally unique avatars.

Installation

Begin by installing this package through Composer.

composer require pespantelis/gravatar

Usage

Create and initialize a gravatar url builder.

<?php

// require the Gravatar autoloader
require 'vendor/autoload.php';

// set options (optional)
$options = [
  'size' => 256,
  'default-image' => 'identicon',
  'force-default' => false,
  'rating' => 'pg',
  'secure' => true
];

$gravatar = new Peslis\Gravatar\Factory($options);

Generate a Gravatar url for the requested email.

echo $gravatar->url('[email protected]');

Check if the requested email has an associated image.

echo $gravatar->exists('[email protected]');
// or
echo $gravatar->url('[email protected]')->exists();

Override the options.

// size
echo $gravatar->url('[email protected]', 256);
// or
echo $gravatar->url('[email protected]')->size(256);

// secure requests
echo $gravatar->url('[email protected]')->secure();

// default image
echo $gravatar->url('[email protected]')->defaultImage('identicon');

// force default image
echo $gravatar->url('[email protected]')->forceDefault();

// rating level
echo $gravatar->url('[email protected]')->rating('pg');

Method chaining to set options.

echo $gravatar->url('[email protected]', 256)->defaultImage('identicon')->rating('pg');

Laravel Extension

If you are a Laravel user, there is a README.md here.

License

Gravatar is released under the MIT Licence. See the bundled LICENSE file for details.