History

Tobias Diekershoff 40ba3c3e57 PL translation libravatar THX waldis		2018-08-06 14:24:07 +02:00
..
config	Move addon-specific config to config/addon.ini.php	2018-07-11 22:56:52 -04:00
lang	PL translation libravatar THX waldis	2018-08-06 14:24:07 +02:00
Services	Updated Services_Libravatar 0.2.1	2012-07-14 21:09:50 +02:00
templates	update addons template dir layout	2013-04-23 08:48:19 -04:00
libravatar.php	[multiple] Rename dbesc to DBA::escape	2018-07-23 15:35:22 -04:00
README.md	Move addon-specific config to config/addon.ini.php	2018-07-11 22:56:52 -04:00

README.md

Libravatar Addon

by Klaus Weidenbach

Please note that the Libravatar service will shut down on 2018-09-01:. You maybe want to switch to the catavatar or gravatar addon.

This addon allows you to look up an avatar image for new users and contacts at Libravatar. It will be used if there have not been found any other avatar images yet for example through OpenID.

Libravatar is a free and open replacement for Gravatar. It is a service where people can store an avatar image for their email-addresses. These avatar images can get looked up for example in comment functions, profile pages, etc. on other sites. There exists a central installation at www.libravatar.com, but you can also host it on your own server. If no avatar was found Libravatar will look up at Gravatar as a fallback. There is no rating available, as it is on Gravatar, so all avatar lookups are g-rated. (Suitable for all audiences.)

You can not use the Libravatar and Gravatar addon at the same time. You need to choose one. If you need other ratings than g you better stay with Gravatar, otherwise it is safe to use Libravatar, because it will fall back to Gravatar if nothing was found at Libravatar.

Configuration

Default Avatar Image

If no avatar was found for an email Libravatar can create some pseudo-random generated avatars based on an email hash. You can choose between these presets:

MM: (mystery-man) a static image
Identicon: a generated geometric pattern based on email hash
Monsterid: a generated 'monster' with different colors, faces, etc. based on email hash
Wavatar: faces with different features and backgrounds based on email hash
Retro: 8-bit arcade-styled pixelated faces based on email hash

See examples at Libravatar.

Alternative Configuration

Open the config/local.ini.php file and add "libravatar" to the list of activated addons:

    [system]
	addon = ...,libravatar

You can add one configuration variables for the addon to the config/addon.ini.php file:

    [libravatar]
	default_avatar = identicon