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.