friendica
/
friendica-addons
7
2
Fork 13
Code Issues 3 Pull Requests 2 Releases 16 Wiki Activity
friendica-addons/gravatar/README.md

49 lines
2.1 KiB
Markdown
Raw Normal View History

Update strings update strings to contain addon
2018-01-20 17:01:59 +01:00
# Gravatar Addon
Add Gravatar plugin. This plugin provides the default gravatar lookup feature that has been in friendica's core before. In addition it lets you choose the default avatar image type and select the allowed image rating.
2012-04-09 00:50:48 +02:00
by [Klaus Weidenbach](http://friendica.dszdw.net/profile/klaus)
This addon allows you to look up an avatar image for new users and contacts at [Gravatar](http://www.gravatar.com). This will be used if there have not been found any other avatar images yet for example through OpenID.
Gravatar is a popular, but centralized and proprietary service where people can store an avatar image for their email-addresses. It is widely used on many pages, for example to display an avatar for comment functions, profile pages, etc.
* * *
# Configuration
## Default Avatar Image
If no avatar was found for an email Gravatar can create some pseudo-random generated avatars based on an email hash. You can choose between these presets:
* __Gravatar__: default static Gravatar logo
* __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 [Gravatar][1].
## Avatar Rating
Gravatar lets users self-rate their images to be used at appropriate audiences. Choose which are appropriate for your friendica site:
* __g__: suitable for display on all wesites with any audience type
* __pg__: may contain rude gestures, provocatively dressed individuals, the lesser swear words, or mild violence
* __r__: may contain such things as harsh profanity, intense violence, nudity, or hard drug use
* __x__: may contain hardcore sexual imagery or extremely disurbing violence
See more information at [Gravatar][1].
## Alternative Configuration
[gravatar] Update config file style/name
2018-11-25 08:12:24 +01:00
Open the `config/local.config.php` file and add "gravatar" to the list of activated addons:
Add Gravatar plugin. This plugin provides the default gravatar lookup feature that has been in friendica's core before. In addition it lets you choose the default avatar image type and select the allowed image rating.
2012-04-09 00:50:48 +02:00
[gravatar] Update config file style/name
2018-11-25 08:12:24 +01:00
'system' => [
...
'addon' => '...,gravatar'
...
]
Add Gravatar plugin. This plugin provides the default gravatar lookup feature that has been in friendica's core before. In addition it lets you choose the default avatar image type and select the allowed image rating.
2012-04-09 00:50:48 +02:00
[gravatar] Update config file style/name
2018-11-25 08:12:24 +01:00
You can add two configuration variables for the addon to the `config/addon.config.php` file:
Add Gravatar plugin. This plugin provides the default gravatar lookup feature that has been in friendica's core before. In addition it lets you choose the default avatar image type and select the allowed image rating.
2012-04-09 00:50:48 +02:00
[gravatar] Update config file style/name
2018-11-25 08:12:24 +01:00
'gravatar' => [
'default_avatar' => 'identicon',
'rating' => 'g',
],
Add Gravatar plugin. This plugin provides the default gravatar lookup feature that has been in friendica's core before. In addition it lets you choose the default avatar image type and select the allowed image rating.
2012-04-09 00:50:48 +02:00
[1]: http://www.gravatar.com/site/implement/images/ "See documentation at Gravatar for more information"