README

TYPO3 extension typo3_letter_avatar

This TYPO3 extension generates colorful backend user avatars using name initials letter.

Note

TYPO3's default backend shows the same silhouette for every user without an uploaded avatar — making large user lists hard to scan. This extension generates a colored letter avatar per user automatically: no uploads, no external services, deterministic colors per name.

✨ Features

• Generates out-of-the-box colorful avatars for backend users
• Easily customizable and flexible configuration
• Provides different predefined color modes and themes
• Supports frontend user avatars with an additional viewhelper

🔥 Installation

Requirements

• TYPO3 13.4 LTS or 14.x
• PHP 8.2, 8.3, 8.4, or 8.5

Compatibility

Composer

composer require konradmichalik/typo3-letter-avatar:^2.0

TER

Download the zip file from TYPO3 extension repository (TER).

Setup

Set up the extension after the installation:

vendor/bin/typo3 extension:setup --extension=typo3_letter_avatar

The extension will automatically generate avatars for all existing backend users.

🧰 Configuration

See Configuration Documentation for detailed setup instructions including:

• Extension settings configuration
• Custom themes and color modes
• Code-based configuration examples

⚡ Usage

See Usage Documentation for comprehensive usage examples including:

• Backend user avatars (automatic)
• Programmatic avatar generation
• Fluid ViewHelper usage
• Console commands
• Event listener customization

🧑‍💻 Contributing

Please have a look at CONTRIBUTING.md.

💎 Credits

This project is highly inspired by similar open source projects like avatar and letter-avatar.

The fonts used in the extension are licensed under SIL Open Font License and Apache License, Version 2.0.

⭐ License

This project is licensed under GNU General Public License 2.0 (or later).