Release status: stable
|Description||Provides avatars based on the users email address, using the Gravatar.com service, or a libravatar instance.|
|Compatibility policy||Snapshots releases along with MediaWiki. Master is not backwards compatible.|
|Translate the Gravatar extension if it is available at translatewiki.net|
|Issues||Open tasks · Report a bug|
The Gravatar extension provides avatars based on the user's email address, using the Gravatar.com service, or a libravatar instance.
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'Gravatar' );
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
- Any skin that provides an element with the classes
The use of gravatar avatars is guarded by the
gravatar-use-gravatar preference. Users have to explicitly opt-in to allow their email address to be used for retrieving an avatar.
Site administrators should not set
$wgDefaultUserOptions, unless users have non-personal email addresses set, or a gravatar proxy is active.
In that case, disabling the user preference through
$wgGravatarServer- This setting specifies the avatar service to connect to. By default, this is //gravatar.com.
$wgGravatarDefaultAvatar- This setting controls the default avatar for users who have not opted-in or have no valid email address set. It can either be the url to an image, or one of the keywords supported by gravatar.
$wgGravatarAcceptedAvatarRating- This setting controls the rating that avatars should have.
$wgGravatarIgnoredSkins- This setting allows excluding certain skins from having the user's avatar displayed in the interface.