Jump to content

Erweiterung:Avatar

From mediawiki.org
This page is a translated version of the page Extension:Avatar and the translation is 100% complete.
MediaWiki-Erweiterungen
Avatar
Freigabestatus: ohne Wartung
Einbindung Benutzer-Schnittstelle
Beschreibung Diese Erweiterung bietet ein Avatar-System, das für andere Erweiterungen verwendet werden kann
Autor(en) Gary Guo (Nbdd0121Diskussion)
Letzte Version 1.0.0 (2016-05-24)
MediaWiki 1.25+
Datenbankänderungen Nein
Lizenz BSD-2-clause-"Simplified"-Lizenz
Herunterladen
README
$wgDefaultAvatar, $wgAllowedAvatarRest, $wgMaxAvatarResolution, $wgDefaultAvatarRes
avatarupload, avataradmin
Nicht zu verwechseln mit Extension:Avatars.

Avatar - Eine weitere Avatar-Architektur für MediaWiki. Diese Erweiterung bietet ein Avatarsystem, das für andere Erweiterungen verwendet werden kann.

Installieren

  • Installiere php-gd, die eine Abhängigkeit von dieser Erweiterung ist
  • Klone das Repository, benenne es in Avatar um und kopiere es in den Ordner extensions
  • Füge wfLoadExtension('Avatar'); zu deiner LocalSettings.php hinzu
  • Du bist fertig!

Konfiguration

  • $wgDefaultAvatar (string) - Sollte auf die URL des Standardavatars festgelegt werden.
  • $wgAllowedAvatarRes (array) - Der Standardwert ist array(64, 128). Thumbnails werden auf Antrag erstellt, wenn ihre Größe in dieser Liste steht.
  • $wgMaxAvatarResolution (integer) - Der Standardwert ist 256. Dies begrenzt die maximale Auflösung des hochzuladenden Bildes.
  • $wgDefaultAvatarRes (integer) - Der Standardwert ist 128. Dies ist die Fallback-Option, wenn die Auflösung nicht angegeben wird.
  • Du kannst die folgenden Benutzerrechte festlegen:
    • avatarupload: Nutzer brauchen dieses Recht, um ihren eigenen Avatar hochzuladen.
    • avataradmin: Nutzer brauchen dieses Recht, um die Avatare anderer zu löschen.

Anwendung

  • Nutzer können einen Avatar hochladen
  • Administrators oder andere Benutzer mit dem Recht avataradmin können den Avatar über Special:ViewAvatar löschen
  • Ein neuer Einstiegspunkt für MediaWiki wurde hinzugefügt, $wgScriptPath/extensions/Avatar/avatar.php?user=username wird auf den Avatar des Benutzers umgeleitet.
  • Du kannst auch einen Alias für diese php setzen, um sie kürzer zu machen.
  • Wenn du Gadgets verwendest
    • Wenn du den Avatar in der Navigationsleiste oben rechts anzeigen möchtest, findest du vielleicht Gadget-ShowAvatar im Beispielordner nützlich.
    • Wenn du Avatare vor dem Benutzerlink anzeigen möchtest, findest du vielleicht Gadget-UserLinkAvatar im Beispielordner nützlich.
Gadget-ShowAvatar

Ausführliche API

  • Avatar hochladen: Es existiert noch keine API, jedoch kann man Special:UploadAvatar (oder die entsprechende Sprache) hochladen. Die einzigen erforderlichen Formulardaten sind avatar, die auf die Datenuri des Bildes festgelegt werden sollten.
  • Anzeige des Avatars: Diese Erweiterung bietet einen Eintrag für MediaWiki avatar.php. Dieser Eintrag liefert das Ergebnis über eine 302-Weiterleitung. Dieser Ansatz wird verwendet, um die Leistung zu maximieren und gleichzeitig den MediaWiki-Kern zu nutzen. Derzeit existieren 4 verfügbare Argumente.
    • user: Lege den Benutzer fest, von dem du den Avatar abfragen willst.
    • res: Die bevorzugte Auflösung des Avatars. Beachte, dass dies nur ein Hinweis ist und das tatsächliche Ergebnis möglicherweise nicht der Auflösung entspricht. Dieser Parameter ist nur gültig, wenn `user` festgelegt ist.
    • ver: Eine Versionsnummer, die an das Ortsfeld der Weiterleitung angehängt wird. Kann verwendet werden, um den Browser/CDN-Cache zu umgehen.
    • nocache: Wenn dieser Parameter festgelegt ist, wird kein `cache-control`-Header ausgegeben.