https://github.com/renfordt/larvatar
Larvatar is a PHP package for different types of avatars
https://github.com/renfordt/larvatar
avatar gravatar identicon initials initials-avatar laravel php
Last synced: about 1 year ago
JSON representation
Larvatar is a PHP package for different types of avatars
- Host: GitHub
- URL: https://github.com/renfordt/larvatar
- Owner: renfordt
- License: mit
- Created: 2023-01-17T15:22:55.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-03-17T10:44:57.000Z (about 1 year ago)
- Last Synced: 2025-03-24T23:41:23.304Z (about 1 year ago)
- Topics: avatar, gravatar, identicon, initials, initials-avatar, laravel, php
- Language: PHP
- Homepage:
- Size: 507 KB
- Stars: 4
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Contributing: contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# Larvatar
[](https://github.com/renfordt/Larvatar)
[](https://packagist.org/packages/renfordt/larvatar/)
[](https://codeclimate.com/github/renfordt/larvatar/test_coverage)
[](https://codeclimate.com/github/renfordt/larvatar/maintainability)
Larvatar is a package that combines different avatar styles, like Gravatar, Initials Avatar.
## Installation
The recommended way of installing Larvatar is to use [Composer](https://getcomposer.org/). Run the following command to
install it to you project:
```
composer require renfordt/larvatar
```
## Upgrading to 2.0
Version 2.0 brings many breaking changes. Check the [Upgrade Guide](UPGRADING.md) to avoid any issues.
## Basic Usage
Include the LarvatarTrait with `use Renfordt\Larvatar\Traits\LarvatarTrait;` in your user class and add the following method:
```php
/**
* Generate and retrieve the avatar URL or HTML for the user.
*
* @param int $size The size of the avatar in pixels.
* @param bool $encoding Whether to return the encoded image as HTML.
* @return string The avatar as a string URL or encoded HTML.
*/
public function getAvatar(int $size = 100, bool $encoding = true): string
{
$larvatar = $this->getLarvatar($this->name, $this->email);
$larvatar->setSize($size);
$larvatar->setWeight('600');
return $larvatar->getImageHTML(true);
}
```
Adjust the method as you please, only requirement is that the methods name is `getAvatar()`.
## Advanced Usage
The general usage is simple. Create a new Larvatar class, insert name and email and the avatar type you wish.
```php
setFont('Roboto,sans-serif', './font/Roboto-bold.ttf');
$larvatar->setSize(100);
// Get the SVG Code for embedding directly in your page
echo $larvatar->getImageHTML();
// if you need base64 encryption, currently this works only for InitialsAvatar
echo $larvatar->getImageHTML('base64');
// or if you need just the base64 string:
echo $larvatar->getBase64();
```
Alternatively you can create an instance of the `Name` class, which provides you more possibilities.
```php
$name = \Renfordt\Larvatar\Name::make('Test Name');
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: $name
);
```
There are currently nine different types of avatars available:
```php
// 1) Microsoft Teams like avatar with initials
\Renfordt\Larvatar\Enum\LarvatarTypes::InitialsAvatar;
// 2) Identicons with more possibilities to adjust
\Renfordt\Larvatar\Enum\LarvatarTypes::IdenticonLarvatar;
// 3) Gravatar
\Renfordt\Larvatar\Enum\LarvatarTypes::Gravatar;
// 4) (Gravatar) MysticPerson, simple cartoon-style silhouette (default)
\Renfordt\Larvatar\Enum\LarvatarTypes::mp;
// 5) (Gravatar) A geometric pattern based on an email hash
\Renfordt\Larvatar\Enum\LarvatarTypes::identicon;
// 6) (Gravatar) A generated monster different colors and faces
\Renfordt\Larvatar\Enum\LarvatarTypes::monsterid;
// 7) (Gravatar) generated faces with differing features and backgrounds
\Renfordt\Larvatar\Enum\LarvatarTypes::wavatar;
// 8) (Gravatar) 8-bit arcade-style pixelated faces
\Renfordt\Larvatar\Enum\LarvatarTypes::retro;
// 9) (Gravatar) A generated robot with different colors, faces, etc
\Renfordt\Larvatar\Enum\LarvatarTypes::robohash;
```
## InitialsAvatar
### Forms
The InitialsAvatar gives you the possibility to choose between three different forms. A circle, which is the default, a
hexagon and a square. Choose it by using the `setForm()` method. The input is either a string or a value of the
Enum `FormTypes`.
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: 'Test Name'
);
$larvatar->initialsAvatar->setForm('circle');
$larvatar->initialsAvatar->setForm('square');
$larvatar->initialsAvatar->setForm('hexagon');
$larvatar->initialsAvatar->setForm(FormTypes::Circle);
$larvatar->initialsAvatar->setForm(FormTypes::Square);
$larvatar->initialsAvatar->setForm(FormTypes::Hexagon);
```
If you are using the hexagon form, you have additionally the possibility to rotate the form:
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: 'Test Name'
);
$larvatar->initialsAvatar->setForm(FormTypes::Hexagon);
$larvatar->initialsAvatar->setRotation(30);
```
### Colors
Usually the colors will be automatically selected by the provided name.
If you for some case want to manually set the contrast of the colors, you can use the methods `setBackgroundLightness()`
and `setTextLightness()`. The parameter is a float with a value range `0` to `1` where `0` means a darker color and `1`
is a lighter color.
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: 'Test Name'
);
$larvatar->initialsAvatar->setBackgroundLightness(0.1);
$larvatar->initialsAvatar->setTextLightness(0.8);
```
Additionally, you can change the offset which will generate a different color.
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: 'Test Name'
);
$larvatar->initialsAvatar->setOffset(4);
```
### Font Weight
You can also change the font weight with the method `setFontWeight()`.
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::InitialsAvatar,
name: 'Test Name'
);
$larvatar->initialsAvatar->setFontWeight('bold');
```
## Identicons (Larvatar Style)
```PHP
$larvatar = Larvatar::make(
type: LarvatarTypes::IdenticonLarvatar,
name: 'Test Name'
);
// optional settings
$larvatar->identicon->setSymmetry(false);
$larvatar->identicon->setPixels(8);
```