MediaWiki extensions manual

Gravatar Release status: stableCategory:Stable extensions
Implementation	User identity Category:User identity extensions
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.Category:Extensions with release branches compatibility policy
MediaWiki	1.35.0+Category:Extensions with manual MediaWiki version
Database changes	No
License	MIT License
Download	Download extension Git [?]: Browse repository (Phabricator · GitHub) Gerrit code review Git commit log Download source tarball Category:Extensions in Wikimedia version control Readme.md
Parameters $wgGravatarDefaultAvatar $wgGravatarIgnoredSkins $wgGravatarServer $wgGravatarAcceptedAvatarRating
Hooks used BeforePageDisplay Category:BeforePageDisplay extensions GetPreferences Category:GetPreferences extensions
Quarterly downloads	0
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.

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

• Vector
• Timeless
• MonoBook
• Mirage
• Minerva Neue
• Any skin that provides an element with the classes ext-gravatar-avatar ext-gravatar-user-avatar

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.