May 17, 2024

Leira Letter Avatar Plugin

Automatically generate beautiful user avatars using their initial letters.

Letters Avatar allows you to generate automatically user avatar base on their initial letters.

Fully customizable from admin area. You will be able edit avatar settings like shape, background color, etc.

Compatibility

This plugin is compatible with any properly coded theme. However, some plugins may cause conflicts with this one. If you find an issue with your theme please create a post in the community forum.
So far this plugin is compatible with:
* BuddyPress
* Ultimate Member
* wpDiscuz
* BuddyPress Profile Completion
* YITH WooCommerce Advanced Reviews
* Flyzoo Chat
* BuddyBoss

Contributors

This plugins has been possible thanks to:
* Jose Luis Chavez – Icons, banners and designs
* ivankuraev – Support for russian characters

Development

You can contribute to this plugin development on Github

Installation

Upload the plugin files to the /wp-content/plugins/leira-letter-avatar directory, or install the plugin through the WordPress plugins screen directly.
Activate the plugin through the ‘Plugins’ screen in WordPress
Use the Settings->Letter Avatar screen to configure the plugin
Happy coding 🙂

Screenshots

You will find a new menu item "Letter Avatar" under "Settings" menu.
A new option "Letter" will be available for "Default Avatar".
Comments list with generated user letter avatar.
Users list with generated user letter avatar.
Comments in Dashboard with letter avatar.
Comments in frontend with letter avatar.

FAQ

What is the format of the generated avatars?

You can select from .svg (Recommended), .png and .jpg.
To use .png and .jpg you will need GD image library installed in order to work.

Which format should I use?

The recommended format(.svg) is the best option. This option generates the images with the best quality and the resource required to generate it is very low.
However there are some cases where you will need to user .png or .jpg, for example if you are sending avatar images in your emails.
There is a know issue that email clients like gmail uses a proxy to show the images and at this point does not support .svg format.

How avatars are generated?

The plugin generates the avatar automatically using defined config.
Avatars are generated only once so your site performance wont get affected

How avatars are stored?

Avatars are stored in your uploads folder.

Will I be able to select my own letters?

No. The plugin automatically generates the image with the initial letters of you First name and Last name.

Can I use gravatar if the user has one?

Yes. There is an option in plugins settings that allows you to show user gravatar if available instead of letter avatar.

I see a black background in the avatars

Probably you are using .jpg format to generate a round avatar. This format does not support image transparency.
Use .png format instead.

Changelog

1.3.8

Use gravatar https url

1.3.7

Fix bug with php8 and $size variable (intval)

1.3.6

WordPress 5.7 compatibility check
Fix BuddyPress deprecated filter bp_core_avatar_default
Improve Gravatar image check method

1.3.5

Fix wpDiscuz issue with social avatars

1.3.4

WordPress 5.7 compatibility check
New filter leira_letter_avatar_image_content

1.3.3

Fix variable typo
Replace screenshot 4

1.3.2

Support for WP 4.9

1.3.1

Change deprecated method get_user_by_email in favor of get_user_by
Bug fix. Upon deactivation set avatar_default option back to mystery

1.3.0

Adding support for .png and .jpg image formats
Fix https avatar url issue

1.2.6

WordPress 5.6 compatibility check
Handle other plugins incorrect usage of um_user_avatar_url_filter filter

1.2.5

Fix random background color generation issue

1.2.4

Match plugin version with readme.txt version

1.2.3

Adding Github Actions automatic deploy
Adding Github Actions automatic update assets and readme file

1.2.2

Adding support for letters color
YITH WooCommerce Advanced Reviews compatibility

1.2.1

Bug fix incorrect avatar size
BuddyPress compatibility improved

1.2.0

Ultimate Member compatibility
wpDiscuz compatibility
Support for russian characters
New option to use gravatar if available
Rate us link in admin area footer
Some code refactored
Bug fixes

1.1.0

BuddyPress integration
CSS fix in admin area
Support link updated
Source code refactored
Screenshots description updated

1.0.0

The first plugin release