PHPackages                             prodrigestivill/gravatar - 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. [Image & Media](/categories/media)
4. /
5. prodrigestivill/gravatar

ActiveRoundcube-plugin[Image & Media](/categories/media)

prodrigestivill/gravatar
========================

Fetch avatar image on view e-mail (using Gravatar and/or custom API).

v1.7(1mo ago)232.3k11[1 issues](https://github.com/prodrigestivill/roundcube-gravatar/issues)GPL-3.0+PHPPHP >=5.2.0

Since Jun 2Pushed 1mo ago5 watchersCompare

[ Source](https://github.com/prodrigestivill/roundcube-gravatar)[ Packagist](https://packagist.org/packages/prodrigestivill/gravatar)[ Docs](https://github.com/prodrigestivill/roundcube-gravatar)[ RSS](/packages/prodrigestivill-gravatar/feed)WikiDiscussions master Synced today

READMEChangelog (8)Dependencies (2)Versions (9)Used By (0)

Roundcube Gravatar
==================

[](#roundcube-gravatar)

Non official plug-in showing [Gravatar](https://www.gravatar.com/) profile images inside the [Roundcube webmail](https://roundcube.net/) client, it also supports custom avatars API.

It has been implemented as Roundcube readonly hidden addressbook. You have to ensure this plugin is added into the latest entry in the main config (`$config['plugins']`). If so and any address book (LDAP, Google, etc...) already has a photo for a contact it will use first the other pictures and lastly if none reported it will use gravatar (Roundcube will use it in following the order listed in the main config).

Tested in roundcube 1.7.0.

Installation
============

[](#installation)

Intallation steps:

- Via composer:
    - Run `php composer.phar require "prodrigestivill/gravatar":"dev-master"`
- Via git:
    - Clone the repository: `cd roundcube/plugins && git clone git@github.com:prodrigestivill/roundcube-gravatar.git gravatar`
- Via tarball:
    - Download and extract the tarball into `roundcube/plugins` directory and rename the extracted directory to `gravatar`

For the expected behaviour **ensure** it is always the latest plugin (or at least addressbook plugin) in the `$config['plugins']` list at `config/config.inc.php`. Also consider **cleaning the browser cache** when changing from disabled to enabled or vice versa.

To enable per user: Login to Roundcube and enable/disable plugin by navigating to the Settings page, clicking on Preferences, click on Address Book, and Enable Gravatar, and Save.

To configure/change default values:

- Copy `config.inc.php.dist` to `config.inc.php` in `plugins/gravatar/` directory.
- Modify the values you are interested into change and comment the rest with '//'

Custom API
==========

[](#custom-api)

You can define your custom API for photos at 'gravatar\_custom\_photo\_api' in `config.inc.php` in `plugins/gravatar/` directory. With the following substitutions.

- %%: literal '%'
- %s: schema ('http', 'https') depending of 'gravatar\_https' config
- %e: contact email (escaped with urlencode)
- %m: hashed md5(email)
- %a: hashed sha1(email)
- %z: configured avatar size (in px)
- %r: configured rating ('g', 'pg', 'r', 'x')

Usage for default Gravatar API is: `%s://www.gravatar.com/avatar/%m?s=%z&r=%r&d=404`

You can use local files, it is not needed to be an URL. But if you plan to use it for direct filesystem access, for security reasons it is best to only use hashed email substitutions, even that all parameters are escaped with urlencode.

Examples:

```
$config['gravatar_custom_photo_api'] = 'http://www.example.com/directory/%e.jpg?s=%z';
//OR//
$config['gravatar_custom_photo_api'] = '/path/%m.jpg';
```

###  Health Score

54

—

FairBetter than 96% of packages

Maintenance92

Actively maintained with recent releases

Popularity32

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 75% 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 ~520 days

Recently: every ~685 days

Total

8

Last Release

35d ago

### Community

Maintainers

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

---

Top Contributors

[![prodrigestivill](https://avatars.githubusercontent.com/u/1381592?v=4)](https://github.com/prodrigestivill "prodrigestivill (15 commits)")[![532910](https://avatars.githubusercontent.com/u/14617699?v=4)](https://github.com/532910 "532910 (1 commits)")[![adam-runcode-pl](https://avatars.githubusercontent.com/u/83067004?v=4)](https://github.com/adam-runcode-pl "adam-runcode-pl (1 commits)")[![MalteKiefer](https://avatars.githubusercontent.com/u/59220985?v=4)](https://github.com/MalteKiefer "MalteKiefer (1 commits)")[![nicrame](https://avatars.githubusercontent.com/u/5872054?v=4)](https://github.com/nicrame "nicrame (1 commits)")[![saschaludwig](https://avatars.githubusercontent.com/u/12997980?v=4)](https://github.com/saschaludwig "saschaludwig (1 commits)")

---

Tags

photogravataravataraddressbook

### Embed Badge

![Health badge](/badges/prodrigestivill-gravatar/health.svg)

```
[![Health](https://phpackages.com/badges/prodrigestivill-gravatar/health.svg)](https://phpackages.com/packages/prodrigestivill-gravatar)
```

###  Alternatives

[creativeorange/gravatar

A Laravel Gravatar package for retrieving gravatar image URLs or checking the existance of an image.

5608.0M64](/packages/creativeorange-gravatar)[lasserafn/php-initial-avatar-generator

A package to generate avatars with initials for PHP

4404.4M17](/packages/lasserafn-php-initial-avatar-generator)[yzalis/identicon

Generate unique identicon avatars from any string

6101.2M23](/packages/yzalis-identicon)[multiavatar/multiavatar-php

Multicultural Avatar Generator

657171.0k6](/packages/multiavatar-multiavatar-php)[gravatarphp/gravatar

Gravatar URL builder which is most commonly called as a Gravatar library

16653.6k2](/packages/gravatarphp-gravatar)[jdenticon/jdenticon

Render PNG and SVG identicons.

62422.5k6](/packages/jdenticon-jdenticon)

PHPackages © 2026

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