Extension:Gravatar

MediaWiki extensions manual
Gravatar
Release status: stable
Implementation User identity
Description Provides avatars based on the users email address, using the Gravatar.com service, or a libravatar instance.
Author(s) Mainframe98talk
Compatibility policy Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki 1.35.0+
Database changes No
License MIT License
Download
Readme.md
  • $wgGravatarDefaultAvatar
  • $wgGravatarIgnoredSkins
  • $wgGravatarServer
  • $wgGravatarAcceptedAvatarRating
Quarterly downloads 4 (Ranked 129th)
Translate the Gravatar extension if it is available at translatewiki.net
Issues Open tasks · Report a bug
There was an extension with the same name that was unmaintained since 2008, never moved to git and was archived in 2016. Archived extension.

The Gravatar extension provides avatars based on the user's email address, using the Gravatar.com service, or a libravatar instance.


Installation

  • Download and move the extracted Gravatar folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Gravatar
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'Gravatar' );
    
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Supported skins

Privacy concerns

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 gravatar-use-gravatar to true in $wgDefaultUserOptions , unless users have non-personal email addresses set, or a gravatar proxy is active. In that case, disabling the user preference through $wgHiddenPrefs might be desirable, as the Gravatar privacy policy no longer applies.

Configuration

  • $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.