Chat_XH – ein CMSimple_XH Plugin

Sprechblasen

Chat_XH ermöglicht es, eine beliebige Anzahl von einfachen Chats oder Shoutboxen auf Ihrer Website zu haben. Benutzer die mittels Memberpages_XH oder Register_XH eingeloggt sind, werden als solche erkannt; andere Besucher können anonym Nachrichten schicken.

Bitte lesen Sie diese Dokumentation bevor Sie auf Probleme stoßen!

Wichtiger Hinweis

Chat_XH wurde bisher nicht in diversen Umgebungen getestet. Es ist ein so genannter Release-Candidate. Vorsicht bei der Verwendung!

Voraussetzungen

Chat_XH ist ein Plugin für CMSimple_XH. Es benötigt CMSimple_XH ≥ 1.6 und PHP ≥ 5.1.2.

Installation

Die Installation erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch. Im CMSimple_XH-Wiki finden Sie weitere Details.

  1. Sichern Sie die Daten auf Ihrem Server.
  2. Entpacken Sie die ZIP-Datei auf Ihrem Rechner.
  3. Laden Sie das ganze Verzeichnis chat/ auf Ihren Server in CMSimple_XHs Plugin-Verzeichnis hoch.
  4. Machen Sie die Unterverzeichnisse config/, css/ und languages/ beschreibbar.
  5. Gehen Sie zu "Chat" im Administrationsbereich, um zu prüfen, ob alle Voraussetzungen erfüllt sind.

Einstellungen

Die Plugin-Konfiguration erfolgt wie bei vielen anderen CMSimple_XH-Plugins auch im Administrationsbereich der Website. Wählen Sie Plugins → Chat.

Sie können die Voreinstellungen von Chat_XH unter "Konfiguration" ändern. Hinweise zu den Optionen werden beim Überfahren der Hilfe-Icons mit der Maus angezeigt.

Die Lokalisierung wird unter "Sprache" vorgenommen. Sie können die Sprachtexte in Ihre eigene Sprache übersetzen, falls keine entsprechende Sprachdatei zur Verfügung steht, oder diese Ihren Wünschen gemäß anpassen.

Das Aussehen von Chat_XH kann unter "Stylesheet" angepasst werden.

Verwendung

Zum Einbinden eines Chats auf einer Seite verwenden Sie folgenden Pluginaufruf:

{{{chat('%CHAT_ROOM%', %PURGE_TIME%);}}}

Um einen Chat im Template einzubinden, fügen Sie dort folgendes ein:

<?php echo chat('%CHAT_ROOM%', %PURGE_TIME%);?>
%CHAT_ROOM%
Der Name des Chats. Dieser kann beliebig gewählt werden, aber er darf nur Kleinbuchstaben (a-z), Ziffern (0-9) und Bindestriche enthalten. Ein paar Beispiele:
%PURGE_TIME%
Die Zeitdauer in Sekunden nachdem ein inaktiver Chat gelöscht wird. \"0\" bedeutet: nie löschen. Dieses Argument ist optional; wird es ausgelassen (einschließlich des vorangehenden Kommas), wird die Standardeinstellung aus der Konfiguration genommen.

Beispiele:

{{{chat('chat');}}}
{{{chat('chat17');}}}
{{{chat('quick-chat', 120);}}}
{{{chat('shoutbox', 0);}}}

Sie können auf jeder einzelnen Seite so viele Chats einbinden wie sie wollen – diese sind unabhängig voneinander solange sie unterschiedliche Namen haben.

Nach einer einstellbaren Zeit der Inaktivität (d.h. es wurden keine neuen Nachrichten geschickt) wird der Chatverlauf automatisch gelöscht.

Wenn Sie die Chat-Dateien bearbeiten wollen, müssen Sie dies per FTP tun.

Einschränkungen

Wenn JavaScript oder Cookies im Browser des Besuchers deaktiviert sind, oder falls der Browser das nötige JavaScript nicht unterstützt (z.B. IE 7 und älter), funktioniert der automatische Abruf von neuen Nachrichten nicht. Statt dessen muss der Besucher seinen Browser aktualisieren, um diese zu sehen.

Die Anzeige der aktuell angemeldeten Benutzer ist noch nicht implementiert. Ein Workaround für Memberpages_XH ist im CMSimple_XH Forum zu finden.

Lizenz

Chat_XH kann unter Einhaltung der GPLv3 verwendet werden.

© 2012-2015 Christoph M. Becker

Tschechische Übersetzung © 2012 Josef Němec
Slovakische Übersetzung © 2012 Dr. Martin Sereday

Credits

Chat_XH wurde von scriptshows MiniChat angeregt.

Das Plugin-Icon wurde von Alessandro Rei entworfen. Vielen Dank für die Veröffentlichung dieses Icons unter GPL.

Dieses Plugin verwendet freie Anwendungs-Icons von Aha-Soft. Vielen Dank für die freie Nutzbarkeit dieser Icons.

Vielen Dank an die Community im CMSimple_XH Forum für Hinweise, Anregungen und das Testen. Besonders möchte ich snafu für sein schnelles Feedback danken.

Und zu guter letzt vielen Dank an Peter Harteg, den "Vater" von CMSimple, und allen Entwicklern von CMSimple_XH ohne die es dieses phantastische CMS nicht gäbe.