🚀 A lightweight and easy-to-use Laravel package designed to simplify avatar generation for your Eloquent models. It provides a flexible and extensible solution for generating avatars using Gravatar, DiceBear, UI Avatars or Boring Avatar
| Driver | Description | Supported | Link |
|---|---|---|---|
| Gravatar | Gravatar is a service for providing globally unique avatars. | Yes ✅️ | Gravatar |
| DiceBear | DiceBear is an avatar library for designers and developers. | Yes ✅️ | DiceBear |
| UI Avatars | UI Avatars is an avatar library for designers and developers. | Yes ✅️ | UI Avatars |
| Boring Avatar | Boring avatars is a tiny JavaScript React library that generates custom, SVG-based, round avatars from any username and color palette. | Yes ✅️ | Boring Avatar |
Note
You can also add your own custom driver by implementing the AmplifiedHQ\Laravatar\Contracts\AvatarInterface; interface and extending the AmplifiedHQ\Laravatar\Abstracts\BaseAvatar class.
Note: This package requires PHP 7.4 or higher. You can install the package via composer:
composer require martian/laravatarAdd the service provider to the providers array in config/app.php:
AmplifiedHQ\Laravatar\Providers\LaravatarServiceProvider::class,Publish the configuration file using the following command:
php artisan vendor:publish --provider="AmplifiedHQ\Laravatar\Providers\LaravatarServiceProvider" --tag="config"You can configure the package by editing the config/laravatar.php file.
- In the configuration file you can specify the default avatar driver to use across your application.
'default' => env('LARAVATAR_DRIVER', 'gravatar'),- If you want to change the default options for a driver, you can do so by editing the
config/laravatar.phpfile.
'drivers' => [
...
'gravatar' => [
'class' => \AmplifiedHQ\Laravatar\Drivers\Gravatar::class,
'options' => [
'size' => 96,
],
],
...
],In order to use the package in your model to generate an avatar on the fly, you need to add the AmplifiedHQ\Laravatar\Traits\HasAvatar trait to your model.
namespace App\Models;
use AmplifiedHQ\Laravatar\HasAvatar;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Foundation\Auth\User as Authenticatable;
use Illuminate\Notifications\Notifiable;
use Laravel\Sanctum\HasApiTokens;
class User extends Authenticatable
{
use HasApiTokens, HasFactory, Notifiable, HasAvatar;
/** @var Avatar Column */
protected $avatarColumn = 'email';
/** @var Avatar Storage Column */
protected $avatarStorageColumn = 'avatar';
...
}Important
If you are using the gravatar driver, you need to use the email column as the avatar column. If you are using the dicebear or ui-avatars or boringavatar driver, you can use any column as the avatar column, provided that the column is a string column. (e.g. name, email, username etc.)
Warning
The HasAvatar trait requires you to define the $avatarColumn and $avatarStorageColumn properties in your model. The $avatarColumn property is the column that will be used to generate the avatar. The $avatarStorageColumn property is the column that will be used to store the avatar.
You can also use each driver method directly on your application either on on your controller, model or view.
use AmplifiedHQ\Laravatar\Drivers\Gravatar;
use App\Http\Controllers\Controller;
class UserController extends Controller {
public function generateAvatar()
{
$gravatar = new Gravatar('[email protected]');
$gravatar->setSize(100);
$gravatar->getUrl(); // https://www.gravatar.com/avatar/9e26471d35a78862c17e467d87cddedf?size=100
}
}use AmplifiedHQ\Laravatar\Drivers\DiceBear;
use App\Http\Controllers\Controller;
class UserController extends Controller {
public function generateAvatar()
{
$dicebear = new DiceBear('Jane Doe');
$dicebear->setStyle('lorelei');
$dicebear->setSize(100);
$dicebear->setFormat('svg');
$dicebear->getUrl(); // https://api.dicebear.com/7.x/lorelei/svg?seed=Jane%20Doe&size=100
}
}use AmplifiedHQ\Laravatar\Drivers\BoringAvatar;
use App\Http\Controllers\Controller;
class UserController extends Controller {
public function generateAvatar()
{
$boringAvatar = new BoringAvatar('Jane Doe');
$boringAvatar->setSize(100);
$boringAvatar->setFormat('svg');
$boringAvatar->setVariant('marble');
$boringAvatar->setSquare(true);
$boringAvatar->getUrl(); // https://boring-avatars-api.vercel.app/api/avatar?size=100&variant=marble&name=Jane%20Doe&sqaure=1
}
}use AmplifiedHQ\Laravatar\Drivers\UiAvatars;
use App\Http\Controllers\Controller;
class UserController extends Controller {
public function generateAvatar()
{
$uiAvatars = new UiAvatars('Jane Doe');
$uiAvatars->setSize(100);
$uiAvatars->setFormat('svg');
$uiAvatars->setBackgroundColor('000000'); // Hexadecimal
$uiAvatars->setForegroundColor('ffffff'); // Hexadecimal
$uiAvatars->setRounded(true);
$uiAvatars->getUrl(); // https://ui-avatars.com/api/?name=Jane%20Doe&size=100&background=000000&color=ffffff&rounded=true
}
}
composer testPlease see CHANGELOG for more information what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.