Turn name, email, and any other string into initial-based avatar or gravatar.

#Laravolt Avatar

Laravolt Avatar is a dynamic avatar generation package for Laravel, ideal for creating unique avatars based on user names or initials. This versatile tool can be integrated into any PHP project, providing a range of customization options to generate avatars that fit seamlessly into your applications.

#Key Features

• Versatile Output Formats: Generate avatars as base64, save to files (PNG, JPG), and even output as SVGs.
• Gravatar Support: Easily convert email addresses into Gravatar URLs with optional parameters.
• Customization: Extensive configuration options including font, colors, size, shape, and themes.
• Real-Time Config Overrides: Modify avatar properties on the fly without altering global settings.
• Non-ASCII Character Support: Handles international characters by using appropriate fonts or converting them to ASCII.

#Installation

Install via composer for Laravel >= 5.2:

composer require laravolt/avatar

For Laravel 5.1, use an older version:

composer require laravolt/avatar ~0.3

Laravel 5.5 and above benefits from package auto-discovery, eliminating the need for manual service provider registration.

#Usage Examples

Output a base64 avatar:

<img src="{{ Avatar::create('Joko Widodo')->toBase64() }}" />

Save as a file:

Avatar::create('Susilo Bambang Yudhoyono')->save('sample.png');

#Configuration

Publish the configuration file to customize default settings:

php artisan vendor:publish --provider="Laravolt\Avatar\ServiceProvider"

This will allow adjustments to aspects like image driver, dimensions, fonts, colors, and more within the config/laravolt/avatar.php file.

#Integration with Other PHP Projects

For non-Laravel PHP projects:

require 'vendor/autoload.php';
use Laravolt\Avatar\Avatar;
 
$avatar = new Avatar($config);
$avatar->create('John Doe')->toBase64();

This package supports a broad range of applications, from simple blogs to complex web applications, ensuring users always have a personalized avatar.