wp-Monalisa – Handbuch
wp-Monalisa ist das WordPress-Plugin, das dich anlächelt wie Monalisa. Mit wp-Monalisa können eigene Smilies einfach per Klick oder Shortcode in Artikel, Seiten und Kommentare eingefügt werden.
Diese Dokumentation bezieht sich auf wp-Monalisa Version 1.0. Das Plugin ist getestet bis WordPress Version 2.9.1. Es funktioniert mit den aktuellen Versionen von Firefox, Opera und Safari sowie mit dem Internet Explorer 6, 7 und 8.
Inhalt:
1. Einstellungen
2. wp-Monalisa updaten
3. Import von Smilie-Paketen
4. Smilies verwalten
5. Das Smilie-Layout ändern
1. Einstellungen
Nach der Installation und Aktivierung des Plugins erscheint im Menü ein neuer Unterpunkt wp-Monalisa. Hier können die Einstellungen geändert werden, Smilies hinzugefügt und gelöscht werden und die Reihenfolge der Smilies geändert werden:
Das voreingestellte Smilie-Verzeichnis ist wp-content/plugins/wp-monalisa/icons, darin befinden sich bereits diverse Smilies. In dieses Verzeichnis können beliebig viele weitere Smilies per FTP hochgeladen werden. Alternativ kann auch ein anderes Verzeichnis innerhalb von WordPress benutzt werden, dazu muss der Pfad unter Icon-Verzeichnis angepasst werden. Wenn man z.B. bereits ein Smilie-Verzeichnis namens “my-smilies” im Verzeichnis wp-content hat, wird der Pfad geändert in wp-content/my-smilies. Anschließend wird “Einstellungen speichern” angeklickt, daraufhin erscheint eine Warnmeldung, die aufmerksam gelesen und bestätigt werden sollte, und zum endgültigen Speichern wird “Einstellungen speichern” nochmals angeklickt.
Smilies im Edit-Dialog anzeigen wird markiert, wenn eine neue Auswahlbox, die die Smilies enthält, neben/unter dem Schreibfenster von Artikeln oder Seiten erscheinen soll. Die Position dieser Box kann per Drag & Drop beliebig geändert werden. Der gewünschte Smilie wird dann einfach per Klick in den Text übernommen:
Smilies im Kommentarformular anzeigen wird markiert, wenn auch unter dem Kommentareingabefeld Smilies erscheinen sollen, die dann per Klick in den Kommentar übernommen werden können:
Damit dies automatisch funktioniert, muss die Zeile <?php do_action(’comment_form’, $post->ID); ?> in der Datei comments.php vorhanden sein. Die ID des Kommentarfeldes heißt standardmäßig “comment”. Wenn ein Theme verwendet wird, in dem die ID eine andere Bezeichnung hat, muss diese Bezeichnung neben ID des Kommentar-Textfelds eingetragen werden.
Wenn die Smilies nicht automatisch unter dem Kommentarfeld, sondern manuell an einer anderen Stelle erscheinen sollen, muss das Häkchen bei Smilies im Kommentarformular anzeigen entfernt werden und in der comments.php an entsprechender Stelle eingefügt werden: <?php if(function_exists(wpml_comment)) { wpml_comment(); } ?>
Ist Ersetze Emoticons durch HTML Images markiert, wird jedem Smilie die entsprechende Grafik hinterlegt, das heißt, im Quelltext der Seite steht dann anstatt des shortcodes : – ) der Pfad zur Grafik <img class=”wpml_ico” src=”http://deine-seite.de/wp-content/plugins/wp-monalisa/icons/smile.gif” alt=”" />. Vorteil: Sollte das Plugin einmal deinstalliert werden, steht der Smilie trotzdem noch im Text bzw. Kommentar. (Aber warum sollte man das Plugin deinstallieren wollen? 
) Nachteil: Der Quellcode wird bei Verwendung vieler Smilies etwas unübersichtlich.
Unter Zeige Emoticons in der Auswahl als kann ausgewählt werden, ob die Smilies im Adminbereich neben dem Schreibfenster und unter den Kommentaren nur als Smilie-Grafik (Icon) angezeigt werden, oder nur als Shortcode (Text), oder sowohl mit dem Icon als auch mit dem jeweiligen Text.
Smilies als Tabelle ausgeben sollte markiert werden, wenn man Smilies benutzt, die sehr unterschiedliche Größen haben, damit sie sich nicht überlappen. Im Feld Smilies pro Zeile wird dann angegeben, wieviele Smilies pro Tabellenzeile erscheinen sollen.
2. wp-Monalisa updaten
wp-Monalisa kann entweder manuell, also durch Löschen der alten Dateien im Verzeichnis wp-monalisa und anschließendes Hochladen der neuen Dateien, oder innerhalb der Pluginverwaltung von WordPress mit der automatischen Updatefunktion upgedated werden. In beiden Fällen sollte das Plugin anschließend einmal deaktiviert und wieder reaktiviert werden, da ansonsten eventuelle Datenbankänderungen nicht durchgeführt werden.
Wenn vor dem Update eine Version älter als 0.9 verwendet wurde und Änderungen an der Datei wp-monalisa.css durchgeführt wurden, sollte von dieser Datei zunächst eine Sicherungskopie gemacht und nach dem Update hochgeladen werden. Ab Version 1.0 wird diese Datei nicht mehr beim Update überschrieben. (Siehe auch 5. Das Smilie-Layout ändern)
3. Import von Smilie-Paketen
Ab der Version 0.2 unterstützt wp-Monalisa den Import von phpbb-Smiley-Paketen. Verschiedene Smiley-Pakete gibt es beispielsweise unter www.greensmilies.com, mit bis zu 3600 Smilies.
Zum Einlesen eines neuen Smiley-Pakets geht man wie folgt vor:
- Herunterladen des Smiley-Pakets (.zip-Datei)
- Entpacken in ein Verzeichnis auf dem Server (z.B. wp-content/smilies)
- Sicherstellen, dass die .pak-Datei und die Smilies sich in diesem Verzeichnis befinden. Die .pak-Datei enthält neben der Zuordnung von Emoticon zu Smiley-Image auch ein Kennzeichen, ob der Smiley aktiv ist oder nicht, sowie Größenangaben und Beschreibung (beide werden von wp-Monalisa zur Zeit nicht verwendet)
- Ggf. Anpassen des Icon-Verzeichnisses auf das gewünschte Verzeichnis
- Aufruf des Import-Dialogs über den Link “Smiley-Paket einlesen”
- Auswahl der gewünschten .pak-Datei in der Selektionsliste
- Zum Löschen der vorhandenen Smilies vor dem Einlesen aktiviert man die Option “Smilies vor dem einlesen löschen”
- Der Import wird mit “Einlesen starten” gestartet
- Die Ergebnisse des Import und/oder evtl. Fehlerhinweise werden dann direkt im Log-Bereich unter den Schaltflächen ausgegeben
- Nach Abschluß des Imports kann der Importdialog über die Schaltfläche “Schließen” beendet werden.
Zur Erstellung einer eigenen .pak Datei kann man einen beliebigen Texteditor verwenden oder eine gängige Tabellenkalkulation (z.B. oo-calc). Das Format der .pak-Dateien ist CSV (=Character Separated Value). Bei der Verwendung einer Tabellenkalkulation ist darauf zu achten, die Daten per CSV-Export zu speichern und anschließend die Dateiendung von .csv in .pak zu ändern.
Die mit wp-Monalisa ausgelieferte default.pak sieht wie folgt aus:
'bye.gif', 29, 24, 1, 'Bye', ':bye:'
'good.gif', 26, 23, 1, 'Good', ':good:'
'negative.gif', 29, 28, 1, 'Negative', ':negative:'
'scratch.gif', 27, 24, 1, 'Scratch', ':scratch:'
'wacko.gif', 20, 24, 1, 'Wacko', ':wacko:'
'yahoo.gif', 42, 27, 1, 'Yahoo', ':yahoo:'
'cool.gif', 21, 21, 1, 'Cool', 'B-)'
'heart.gif', 28, 25, 1, 'Heart', ':heart:'
'rose.gif', 30, 26, 1, 'Rose', ':rose:'
'smile.gif', 20, 24, 1, 'Smile', ':-)'
'whistle3.gif', 26, 25, 1, 'Whistle', ':whistle:'
'yes.gif', 20, 20, 1, 'Yes', ':yes:'
'cry.gif', 31, 22, 1, 'Cry', ':cry:'
'mail.gif', 36, 26, 1, 'Mail', ':mail:'
'sad.gif', 20, 24, 1, 'Sad', ':-('
'unsure.gif', 32, 20, 1, 'Unsure', ':unsure:'
'wink.gif', 20, 20, 1, 'Wink', ';-)'Der Zeilenaufbau ist dabei nach folgenden Muster abzubilden:
Spalte 1: Dateiname
Spalte 2: Breite
Spalte 3: Höhe
Spalte 4: Aktiv ja=1/nein=0
Spalte 5: Beschreibung
Spalte 6: Emoticon / Shortcode
Möchte man innerhalb einer Spalte ein ‘ verwenden, so muss dieses mit \ escaped werden (z.B. :\’\-( ).
4. Smilies verwalten
Im unteren Bereich der wp-Monalisa-Administration werden die Smilie-Grafiken verwaltet. Direkt nach der Installation sind hier alle mitgelieferten Smilies bereits aufgelistet und mit einem Shortcode versehen. Wenn ein weiterer Smilie in das Verzeichnis kopiert wird, muss anschließend zunächst ein Shortcode für ihn in das Feld neben Neuer Eintrag eingegeben werden, dann wird er aus der Dropdownliste ausgewählt und markiert, ob er in Posts und/oder in Kommentaren erscheinen soll und das ganze durch Klick auf Speichern bestätigt. Er erscheint dann zunächst als letzter in der Liste der Smilies. Mit den Aufwärts- und Abwärts-Pfeilen können die Smilies nach Belieben sortiert werden – zum Schluss das Speichern nicht vergessen.
Seit Version 0.9 werden Smilies, denen noch kein Shortcode zugeordnet wurde, in der Dropdownliste mit einem Sternchen * markiert, so dass sie sich leicht von den Smilies unterscheiden lassen, bei denen schon ein Shortcode hinterlegt wurde.
Bei der Benutzung der Smilies ist folgendes zu beachten:
Wenn die Original-WordPress-Smilies unter Einstellungen -> Schreiben -> “Wandele Emoticons in Grafiken um” mit einem Häkchen aktiviert sind, dann wird bei Verwendung eines Original-WordPress-Shortcodes wie z.B. : – ) der Original-WordPress-Smilie verwendet anstatt des eigenen Smilies. Wer das nicht möchte, muss das Häkchen in der Einstellung entfernen.
5. Das Smilie-Layout ändern
Wer Änderungen am Layout der Smilies vornehmen möchte, sollte die Datei wp-monalisa-default.css kopieren, umbenennen in wp-monalisa.css und dann die gewünschten Änderungen durch Editieren der wp-monalisa.css vornehmen. Ab der Version 1.0 werden beim Autoupdate von WordPress sowohl die Datei wp-monalisa.css, als auch eventuell vorhandene eigene Smilies im Unterverzeichnis “icons” geschützt und nicht mehr durch das Autoupdate gelöscht. Dieses Feature greift erstmalig mit dem Update auf die Version 1.1 (mit 1.0 sind die entsprechenden Funktionen eingebaut worden).
Die Datei wp-monalisa-default.css ist folgendermaßen aufgebaut:
div.wpml_commentbox bestimmt das Aussehen des Smilie-Containers unter dem Kommentarformular. Dieser kann z.B. eingerahmt werden, indem bei “border” der Wert von 0 auf 1 oder höher gesetzt wird.
div.wpml_commentbox_text dient hauptsächlich entwicklungstechnischen Zwecken, Änderungen an den einzelnen Werten wirken sich im “Normalbetrieb” nicht auf die Smilie-Darstellung aus.
div#wpml_metabox ist zuständig für den Smilie-Container im Edit-Bereich, also neben bzw. unter dem Schreibfenster.
div.wpml_ico_both Wenn in den Plugineinstellungen unter “Zeige Emoticons in der Auswahl als” der Wert “beide” gewählt ist, können hier Änderungen bei “font-size” gemacht werden, um die Schriftgröße der Shortcodes zu ändern, bei “border”, um einen Rahmen um jeden Smilie mit Shortcode zu ziehen, bei “padding”, um die Abstände der Smilies zueinander zu verändern, und bei “height”, um bei mehrzeiliger Darstellung der Smilies ihren horizontalen Abstand zu bestimmen. Wenn Smilie-Pakete benutzt werden, die auch sehr große Smilies beinhalten, sollte der Wert unter “height” mindestens so groß sein wie die Höhe des größten Smilies.
div.wpml_ico_icon funktioniert analog zum vorherigen Punkt, wenn in den Plugineinstellungen unter “Zeige Emoticons in der Auswahl als” der Wert “Icon” gewählt ist.
div.wpml_ico_text funktioniert analog zu den beiden vorherigen Punkten, wenn in den Plugineinstellungen unter “Zeige Emoticons in der Auswahl als” der Wert “Text” gewählt ist.
img.wpml_ico beeinflusst das Aussehen der <img>-Tags. Hier kann z.B. durch eine “height”-Angabe die Größe der Smilies verändert werden oder eine Hintergrundfarbe definiert werden.
Artikel, die auch interessant sein könnten:
- wp-monalisa in dmsGuestbook integrieren
- wp-monalisa – Manual
- wp-Monalisa Version 1.0
- wp-greet Dokumentation
- Similar-Posts und Post-Plugin-Library in deutsch
