Extension:Avatar

Avatar - Yet another avatar architecture for MediaWiki. This extension provides an avatar system that can be used for other extensions.

Install

 * Install php-gd, which is a dependency of this extension
 * Clone the respository, rename it to Avatar and copy to extensions folder
 * Add  to your LocalSettings.php
 * You are done!

Configuration

 * (string), should be set to the URL of the default avatar.
 * (array), default value is array(64, 128). Thumbnails will be created upon request when their size is in this list.
 * (integer), default value is 256. This limits maximum resolution of image to be uploaded.
 * (integer), default value is 128. This is the fallback option if resolution is not specified.
 * You can set user rights:
 * : User need this right to upload ones' own avatar.
 * : User need this right to delete others' avatars.

How to use

 * Users can upload avatar in their preference
 * Sysops or other users with  right can delete avatar via Special:ViewAvatar
 * A new entry point for MediaWiki is added,  will be redirected to user's avatar.
 * You can also set alias for this php to make it shorter.
 * If you are using Gadgets
 * If you want to display the avatar on the top-right navigation bar, you may find Gadget-ShowAvatar in example folder useful.
 * If you want to display avatars before user link, you may find Gadget-UserLinkAvatar in example folder useful.



Detailed API

 * Uploading Avatar: No API provided yet, but one can post to  (or its localized equivalent). The only form data required is , which should be set to the data uri of the image.
 * Displaying Avatar: This extension provides an entry point for MediaWiki . This entry point produces result via a 302 redirect. This approach is used to maximize performance while still utilizing MediaWiki core. There are currently 4 available arguments.
 * set to the user of who you want to enquery the avatar.
 * the preferred resolution of the avatar. Note that this is only a hint and the actual result might not be of the resolution. This parameter is valid only if `user` is set.
 * a version number which will be appended to the location field of redirection. Can be used to circumvent browser/CDN cache.
 * if this parameter is set, then no `cache-control` header will be emitted.

MediaWiki 1.39.x LTS Test Plan
The items listed here are general issues related to MediaWiki 1.39.x LTS. They are not addressing any issues that are specific to this extension.


 * Extension considered active for MediaWiki 1.39.x LTS