backpack/gravatar

A Laravel Gravatar package for retrieving gravatar image URLs or checking the existance of an image.

v1.0.26 2026-03-23 13:39 UTC

Requires

• php: >=8.2.0
• illuminate/support: ^12.0|^13.0

Requires (Dev)

• php: >=8.2.0
• nunomaduro/larastan: ^0.6.2|^2.4
• orchestra/testbench: ^10.0|^11.0

MIT

• Jaco Tijssen

• gravatar
• laravel
• avatar

README

NOTE: This is a fork of https://github.com/brainpink/gravatar. We had to fork it, to add Laravel 13 support. All the work is credited to the maintainers of that package.

Installation

First, pull in the package through Composer via the command line:

composer require backpack/gravatar

or add the following to your composer.json file and run composer update.

"require": {
    "backpack/gravatar": "~1.0"
}

Finally, publish the config by running the php artisan vendor:publish command

Usage

Within your controllers or views, you can use

    Gravatar::get('[e-mail]');

this will return the URL to the gravatar image of the specified email address. In case of a non-existing gravatar, it will return return a URL to a placeholder image. You can set the type of the placeholder in the configuration option fallback. For more information, visit gravatar.com

Alternatively, you can check for the existence of a gravatar image by using

    Gravatar::exists('[e-mail]');

This will return a boolean (true or false).

Or you can pass a url to a custom image using the fallback method:

    Gravatar::fallback('http://urlto.example.com/avatar.jpg')->get('[e-mail]');

Configuration

You can create different configuration groups to use within your application and pass the group name as a second parameter to the get-method:

There is a default group in config/gravatar.php which will be used when you do not specify a second parameter.

If you would like to add more groups, feel free to edit the config/gravatar.php file. For example:

return array(
	'default' => array(
		'size'   => 80,
		'fallback' => 'mm',
		'secure' => false,
		'maximumRating' => 'g',
		'forceDefault' => false,
		'forceExtension' => 'jpg',
	),
	'small-secure' => array (
	    'size'   => 30,
	    'secure' => true,
	),
	'medium' => array (
	    'size'   => 150,
	)
);

then you can use the following syntax:

Gravatar::get('[e-mail]', 'small-secure'); // will use the small-secure group
Gravatar::get('[e-mail]', 'medium'); // will use the medium group
Gravatar::get('[e-mail]', 'default'); // will use the default group
Gravatar::get('[e-mail]'); // will use the default group

Alternatively, you could also pass an array directly as the second parameter as inline options. So, instead of passing a configuration key, you pass an array, which will be merged with the default group:

Gravatar::get('[e-mail]', ['size'=>200]);