PHPackages                             danyalds/letter-avatar - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. danyalds/letter-avatar

ActiveLibrary[Utility & Helpers](/categories/utility)

danyalds/letter-avatar
======================

Letter Avatar compatible with Persian language for PHP

11PHP

Since Jan 22Pushed 5y ago1 watchersCompare

[ Source](https://github.com/danyalstd/LetterAvatar)[ Packagist](https://packagist.org/packages/danyalds/letter-avatar)[ RSS](/packages/danyalds-letter-avatar/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

LetterAvatar
============

[](#letteravatar)

Letter Avatar compatible with Persian language for PHP

Quick use
---------

[](#quick-use)

```
require_once "LetterAvatar.php";
header("Content-Type: image/png");
createAvatar("علی محمدی");
```

Result:

[![](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/normal_circle.png)](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/normal_circle.png)

Customization
-------------

[](#customization)

### Change avatar shape

[](#change-avatar-shape)

```
$settings = array("shape"=>"square");
createAvatar("علی محمدی",$settings);
```

Result:

[![](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/normal_square.png)](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/normal_square.png)

### Change background color

[](#change-background-color)

```
$settings = array("background"=>"#da1327");
createAvatar("علی محمدی",$settings);
```

Result:

[![](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/background.png)](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/background.png)

### Add first letter of lastname

[](#add-first-letter-of-lastname)

```
$settings = array("words"=>"two");
createAvatar("علی محمدی",$settings);
```

Result:

[![](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/two_word.png)](https://raw.githubusercontent.com/danyalstd/LetterAvatar/main/images/two_word.png)

Other settings
--------------

[](#other-settings)

```
$settings = array("direction"=>"rtl", // "rtl" for RTL languages like Persian, Arabic & "ltr" for other languages [default: "rtl"]
                  "shape"=>"circle", // "circle" & "square" [default: "circle"]
                  "size"=>"180", // avatar size in px [default: 120]
                  "words"=>"two", // "one" for the first letter of firstname & "two" for the first letters of firstname and lastname [default: "one"]
                  "font"=>"vazir.ttf", // location to your ttf font [default: "vazir.ttf"]
                  "fontSize"=>"60", // font size of the text [default: 1/3*(image size) (recommended)]
                  "background"=>"#da1327" // background color of avatar [default: random by user name]
                  );
```

###  Health Score

16

—

LowBetter than 4% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity31

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7250589?v=4)[danyalds](/maintainers/danyalds)[@danyalds](https://github.com/danyalds)

---

Top Contributors

[![danyalstd](https://avatars.githubusercontent.com/u/54025318?v=4)](https://github.com/danyalstd "danyalstd (8 commits)")

### Embed Badge

![Health badge](/badges/danyalds-letter-avatar/health.svg)

```
[![Health](https://phpackages.com/badges/danyalds-letter-avatar/health.svg)](https://phpackages.com/packages/danyalds-letter-avatar)
```

###  Alternatives

[kartsims/easysvg

PHP library to generate SVG XML

101497.0k3](/packages/kartsims-easysvg)[monsieurbiz/sylius-rich-editor-plugin

A Rich Editor plugin for Sylius.

75416.2k6](/packages/monsieurbiz-sylius-rich-editor-plugin)[devmarketer/easynav

Making managing navigation in Laravel easy.

105160.5k](/packages/devmarketer-easynav)[stillat/proteus

Provides utilities for parsing and updating Laravel-style PHP configuration files.

18326.3k38](/packages/stillat-proteus)[experius/module-formselect2

2735.3k](/packages/experius-module-formselect2)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)