awcodes/filament-gravatar

Replace Filament's default avatar url provider with one for Gravatar.

v3.0.0-beta.1 2025-06-12 18:10 UTC

Requires

• php: ^8.2
• filament/filament: ^4.0
• spatie/laravel-package-tools: ^1.15

Requires (Dev)

• laravel/pint: ^1.0
• orchestra/testbench: ^9.0|^10.0
• pestphp/pest: ^3.7
• pestphp/pest-plugin-laravel: ^3.0
• pestphp/pest-plugin-livewire: ^3.0
• rector/rector: ^2.0
• spatie/laravel-ray: ^1.26

MIT

• Adam Weston

• gravatar
• plugin
• laravel
• filament
• awcodes

README

Replace Filament's default avatar url provider with one for Gravatar.

Installation

First, install the plugin with composer.

composer require awcodes/filament-gravatar

Next, add the GravatarProvider to your panel.

use Awcodes\FilamentGravatar\GravatarProvider;

public function panel(Panel $panel): Panel
{
    return $panel
        ->defaultAvatarProvider(GravatarProvider::class)
        ->plugins([
            GravatarPlugin::make(),
        ])
}

Global Defaults

You can modify the global defaults by using the following methods on the GravatarPlugin.

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            GravatarPlugin::make()
                ->default('robohash')
                ->size(200)
                ->rating('pg'),
        ])
}

Additional Info

You can also use the Awcodes\FilamentGravatar\Gravatar class by itself should you need to outside a panel.

Awcodes\FilamentGravatar\Gravatar::get(
    string $email = null,
    int $size = 80,
    string $default = 'mp',
    string $rating = 'g',
    bool $asImage = false,
    array $attributes = []
);