Extension:Avatar

MediaWiki 拡張機能マニュアル

Avatar リリースの状態: 保守されていない
実装	ユーザー インターフェイス
説明	This extension provides an avatar system that can be used for other extensions
作者	Gary Guo (Nbdd0121トーク)
最新バージョン	1.0.0 (2016-05-24)
MediaWiki	1.25+
データベースの変更	いいえ
パラメーター $wgDefaultAvatar, $wgAllowedAvatarRest, $wgMaxAvatarResolution, $wgDefaultAvatarRes
追加する権限 avatarupload, avataradmin
使用するフック GetPreferences BaseTemplateToolbox SkinTemplateOutputPageBeforeExec
ライセンス	BSD 2 条項「簡略」ライセンス
ダウンロード	GitHub: プロジェクトのページ git リポジトリの URL コミット履歴 注: 地域化の更新は translatewiki.net からは提供されません。 README

混同しないでください: Extension:Avatars。

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 wfLoadExtension('Avatar'); to your LocalSettings.php
• You are done!

Configuration

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

How to use

• Users can upload avatar in their preference
• Administrators or other users with the avataradmin right can delete avatar via Special:ViewAvatar
• A new entry point for MediaWiki is added, $wgScriptPath/extensions/Avatar/avatar.php?user=username 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.

Gadget-ShowAvatar

Detailed API

• Uploading Avatar: No API provided yet, but one can post to Special:UploadAvatar (or its localized equivalent). The only form data required is avatar, which should be set to the data uri of the image.
• Displaying Avatar: This extension provides an entry point for MediaWiki avatar.php. 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.
  • user: Set to the user of who you want to enquery the avatar.
  • res: 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.
  • ver: A version number which will be appended to the location field of redirection. Can be used to circumvent browser/CDN cache.
  • nocache: If this parameter is set, then no `cache-control` header will be emitted.