====== avatar plugin ======

---- plugin ----
Bechreibung: Benutze einen gravatar auf einer wiki-seite, wird auch vom discussion plugin benötigt. (ehemalige Autoren: Esther Brunner)
Autor      : Gina Häußge, Michael Klier
email      : dokuwiki@chimeric.de
Art        : syntax, helper
lastupdate : 2008-04-20
compatible : >= 2006-11-06, Hrun
depends    : 
conflicts  : 
similar    : 
tags       : avatar, gravatar
----

^ Download | [[http://www.chimeric.de/_src/plugin-avatar.tgz|plugin-avatar.tgz]] |

===== Syntax =====
  {{avatar>[user|mail]?[size]|[title]}}
  {{gravatar>[user|mail]?[size]|[title]}}

^ [user]  | der registrierte Benutzer, für den ein Avatar angezeigt werden soll | vorausgesetzt |
^ [mail]  | die e-mail Adresse, für welche man ein Avatar Bild darstellen möchte | vorausgesetzt |
^ [size]  | either s(mall) = 20×20 pixel, m(edium) = 40×40 pixel, l(arge) = 80×80 pixel, xl (extra large) = 120×120 pixel | optional; Standart ist medium |
^ [title]  | der Name der Person, zu welcher die e-mail Adresse gehört oder ein anderer Titel | optional; Standart ist die verschleierte e-mail Adresse |

Mit Leerzeichen um die e-mail Adresse, kann man die Ausrichtung bestimmen mit [[syntax#images_and_other_files|images]].

Die %%{{gravatar>...}}%% Syntax wird immer noch unterstützt, wird aber nicht empfohlen. 

===== Lokale Avatare =====
Wenn man weder das monsterid Skript, noch die gravatars von http://gravatar.org verwenden möchte, besteht die Möglichkeit eigene Avatare in das ''user'' Namespace-Verzeichnis hochzuladen. Für einen Benutzer mit dem Namen ''foo'', wäre ''user:foo.jpg'' das Bild und man würde folgende Syntax verwenden:

  {{gravatar>foo}}

Der Benutzername muss klein geschrieben sein und den Regeln der Seiten-Benennung folgen. Wenn man sich unsicher ist, bekommt man den Benutzernamen z.B. aus den Log-Dateien kürzlich vorgenommener Änderungen. Die Bildformate jpg/png/gif werden unterstützt.

===== Demo =====
Man kann das Plugin [[http://chimeric.de/_demo/avatar|hier]] testen.


===== Resources =====
  * [[http://darcs.chimeric.de/darcsweb.cgi?r=avatar|Darcs Repository]]
  * [[http://www.chimeric.de/_dev/codereference/nav.html?plugins/avatar/index.html|Source Code Documentation]]

===== Diskussion =====

FIXME: Bei gemeinsamer Benutzung mit dem Discussion-Plugin , wird username.jpg nicht gefunden weil _getAvatarURL($user, ...) (und getXHTML) die e-mail Adresse des Benutzers, anstelle seines Login-Namens erhält. (Höchstwahrscheinlich muss das Discussion-Plugin gefixt werden).

> WUrde im Discussion-Plugin vom 2008-08-08 gefixt.  --- //[[chi@chimeric.de|Michael Klier]] 2008/08/08 19:44//