PHPackages                             coldtrick/avatar\_service - 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. coldtrick/avatar\_service

ActiveElgg-plugin

coldtrick/avatar\_service
=========================

Provides a service to get an Elgg avatar in a Gravatar like way

v3.0(7y ago)11.4k1[1 issues](https://github.com/ColdTrick/avatar_service/issues)GPL-2.0-onlyPHP

Since Mar 10Pushed 7y agoCompare

[ Source](https://github.com/ColdTrick/avatar_service)[ Packagist](https://packagist.org/packages/coldtrick/avatar_service)[ RSS](/packages/coldtrick-avatar-service/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (6)Dependencies (3)Versions (7)Used By (0)

Avatar Service
==============

[](#avatar-service)

[![Elgg 3.0](https://camo.githubusercontent.com/ede530ff6a03250d58d4e9e84e86733b6bcbf760b9127b5b4e011cf649ad7e8e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f456c67672d332e302d677265656e2e737667)](https://camo.githubusercontent.com/ede530ff6a03250d58d4e9e84e86733b6bcbf760b9127b5b4e011cf649ad7e8e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f456c67672d332e302d677265656e2e737667)[![Build Status](https://camo.githubusercontent.com/d01988d065bc6d8d4d828cee1341a05abd66f626ae92b696a0c29b18f71049da/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f436f6c64547269636b2f6176617461725f736572766963652f6261646765732f6275696c642e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ColdTrick/avatar_service/build-status/master)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/e4100d14268803f0555bba0cfdb93f8a3ebb5b4d1c0790d472a7f433645133b5/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f436f6c64547269636b2f6176617461725f736572766963652f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/ColdTrick/avatar_service/?branch=master)[![Latest Stable Version](https://camo.githubusercontent.com/1fae5a943f43163fa338fa206fd172de089b4cd99dc12e286680171b2c2a4443/68747470733a2f2f706f7365722e707567782e6f72672f636f6c64747269636b2f6176617461725f736572766963652f762f737461626c652e737667)](https://packagist.org/packages/coldtrick/avatar_service)[![License](https://camo.githubusercontent.com/b9eae76b6c43eb182a12290adc1aedad9c9a773bccae90d80f0402fb5b4c3676/68747470733a2f2f706f7365722e707567782e6f72672f636f6c64747269636b2f6176617461725f736572766963652f6c6963656e73652e737667)](https://packagist.org/packages/coldtrick/avatar_service)

Provides a service to get an Elgg avatar in a Gravatar like way

How to use
----------

[](#how-to-use)

### Base Request

[](#base-request)

Avatar images may be requested just like a normal image, using an IMG tag. To get an image specific to a user, you must first calculate their email hash.

The most basic image request URL looks like this:

`http://www.yoursite.com/avatar_service/HASH`

where HASH is replaced with the calculated hash for the specific email address you are requesting. The hash is an md5 of the lowercased version of an emailaddress.

For example, here is the base URL for the  emailaddress:

`http://www.yoursite.com/avatar_service/dfb0624735f6756ede0693f1c8e94a8c`

If you require a file-type extension (some places do) then you may also add an (optional) .jpg extension to that URL:

`http://www.yoursite.com/avatar_service/dfb0624735f6756ede0693f1c8e94a8c.jpg`

### Size

[](#size)

By default, images are presented at 80px by 80px if no size parameter is supplied. You may request a specific image size, which will be dynamically delivered by using the s= or size= parameter and passing a single pixel dimension (since the images are square):

`http://www.yoursite.com/avatar_service/dfb0624735f6756ede0693f1c8e94a8c?s=200`

You may request images anywhere from 1px up to 2048px, however note that many users have lower resolution images, so requesting larger sizes may result in pixelation/low-quality images.

### Default Image

[](#default-image)

What happens when an email address has no matching user or user avatar? You will get the default user icon of the community.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 69.2% 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.

###  Release Activity

Cadence

Every ~222 days

Recently: every ~231 days

Total

6

Last Release

2602d ago

Major Versions

v0.1 → v1.02016-09-15

v1.0 → v2.02017-01-26

v2.1 → v3.02019-03-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/a4ac1d6abe137b2a78bd0527b3c1f085be51c6a8f70e2fd81fcd7fac3d8d59bf?d=identicon)[jeabakker](/maintainers/jeabakker)

---

Top Contributors

[![jeabakker](https://avatars.githubusercontent.com/u/881958?v=4)](https://github.com/jeabakker "jeabakker (18 commits)")[![jdalsem](https://avatars.githubusercontent.com/u/861833?v=4)](https://github.com/jdalsem "jdalsem (8 commits)")

---

Tags

pluginelggavatar

### Embed Badge

![Health badge](/badges/coldtrick-avatar-service/health.svg)

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

PHPackages © 2026

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