Rozšíření:Avatar

Příručka k rozšířením MediaWiki

Avatar Stav rozšíření: neudržované
Implementace	Uživatelské rozhraní
Popis	Toto rozšíření poskytuje systém avatarů, které lze použít pro další rozšíření
Autoři	Gary Guo (Nbdd0121diskuse)
Nejnovější verze	1.0.0 (2016-05-24)
MediaWiki	1.25+
Změny v databázi	Ne
Parametry $wgDefaultAvatar, $wgAllowedAvatarRest, $wgMaxAvatarResolution, $wgDefaultAvatarRes
Přidaná práva avatarupload, avataradmin
Použité háčky (hooks) GetPreferences BaseTemplateToolbox SkinTemplateOutputPageBeforeExec
Licence	Dvoupodmínková „zjednodušená“ licence BSD
Stáhnout	GitHub: stránka projektu URL úložiště git zobrazit historii Poznámka: translatewiki.net neposkytuje žádné aktualizace lokalizace. README

Nesmí se zaměňovat s: Extension:Avatars.

Avatar - Další architektura avatarů pro MediaWiki. Toto rozšíření poskytuje systém avatarů, který lze použít pro jiná rozšíření.

Instalace

• Nainstalujte php-gd, což je závislost tohoto rozšíření.
• Naklonujte repozitář, přejmenujte ho na Avatar a zkopírujte do složky extensions
• Přidejte wfLoadExtension('Avatar'); k vašemu LocalSettings.php
• Hotovo!

Nastavení

• $wgDefaultAvatar (string) – mělo by být nastaveno na URL adresu výchozího avatara.
• $wgAllowedAvatarRes (array) – výchozí hodnota je array(64, 128). Miniatury budou vytvořeny na vyžádání, pokud je jejich velikost v tomto seznamu.
• $wgMaxAvatarResolution (integer) – výchozí hodnota je 256. Toto omezuje maximální rozlišení nahraného obrázku.
• $wgDefaultAvatarRes (integer) – výchozí hodnota je 128. Toto je záložní možnost, pokud není zadáno rozlišení.
• Můžete nastavit následující uživatelská práva:
  • avatarupload: uživatel potřebuje toto právo k nahrání vlastního avatara.
  • avataradmin: uživatel potřebuje toto právo k odstranění avatarů ostatních.

Jak používat

• Uživatelé si mohou nahrát avatara dle vlastních preferencí
• Administrators nebo jiní uživatelé s právem avataradmin mohou smazat avatara přes Special:ViewAvatar.
• Byl přidán nový vstupní bod pro MediaWiki, $wgScriptPath/extensions/Avatar/avatar.php?user=username bude přesměrován na avatar uživatele.
• Můžete také nastavit alias pro toto PHP, aby bylo kratší.
• Pokud používáte Gadgety (miniaplikace)
  • Pokud chcete zobrazit avatara v pravém horním navigačním panelu, může se vám hodit Gadget-ShowAvatar ve složce s příklady.
  • Pokud chcete zobrazit avatary před odkazem uživatele, může se vám hodit Gadget-UserLinkAvatar ve složce s příklady.

Gadget-ShowAvatar

Podrobné API

• Nahrávání avatara: API zatím není k dispozici, ale je možné přispívat na Special:UploadAvatar (nebo jeho lokalizovaný ekvivalent). Jedinými požadovanými daty formuláře je avatar, které by měly být nastaveny na datové uri obrázku.
• Zobrazení avatara: Toto rozšíření poskytuje vstupní bod pro MediaWiki avatar.php. Tento vstupní bod generuje výsledek prostřednictvím přesměrování 302. Tento přístup se používá k maximalizaci výkonu při současném využití jádra MediaWiki. Aktuálně jsou k dispozici 4 argumenty.
  • user: Nastavte uživatele, od kterého chcete dotazovat avatara.
  • res: Preferované rozlišení avatara. Upozorňujeme, že se jedná pouze o nápovědu a skutečný výsledek nemusí odpovídat danému rozlišení. Tento parametr je platný pouze tehdy, je-li nastavena hodnota `user`.
  • ver: Číslo verze, které bude připojeno k poli location přesměrování. Lze použít k obcházení mezipaměti prohlížeče/CDN.
  • nocache: Pokud je tento parametr nastaven, nebude vygenerována žádná hlavička `cache-control`.