Sprung zum Inhalt

Webdesign nach Maß von webdesign weisshart

Das Chatscript
Häufige Fragen - FAQ

Installation, Voraussetzungen und Bedienung

  • Der Server muss PHP ab Version 5 unterstützen. Ältere Versionen von PHP (mindestens 4.3.0) ermöglichen keinen Dateiupload und keine Profile.
  • Details siehe readme.txt und Hilfe

Warum geht der Chat bei mir nicht?

Bitte grundsätzlich systematisch vorgehen!

  1. Vorab: diese FAQ gilt natürlich nur für die aktuelle Version. Aber auch für Supportanfragen jeglicher Art gilt: Immer erst die neueste, aktuelle Version installieren.
  2. Bitte vor einer Anpassung alle Dateien unverändert in ein eigenes Verzeichnis (z.B. /chat) auf den Server laden, und erst wenn's läuft, schrittweise anpassen.
  3. Die readme.txt und diese FAQ gelesen?
  4. Wenn das alles nicht hilft:
    Frage im Support Forum stellen.
    Aber bitte dran denken: "Geht nicht" ist keine Fehlerbeschreibung!
    Und am besten kann bei der Fehlersuche geholfen werden, wenn ein URL genannt wird.
  5. Hinweis:
    Kein Support per E-Mail! Support-Anfragen per E-Mail können leider nicht beantwortet werden.
  6. Vielleicht findet sich ja auch jemand im Demo-Chat, der Fragen direkt beantworten kann.
     

Was bedeutet diese Fehlermeldung?

  • 500: Server encountered an internal error

    - Der Server erlaubt keine .htaccess Dateien, oder bestimmte Anweisungen in der .htaccess.
    - Hinweise zur Behebung direkt in der Datei /chat/.htaccess, oder
    - Lösche alle .htaccess Dateien in allen Ordnern und Unterordnern des Chat (also /chat, /chat/rooms usw.).
    - ACHTUNG: Du musst dafür sorgen, dass kritische Ordner anderweitig geschützt werden. Lies dazu die readme.txt
  • Warning: fopen(clear.txt) [function.fopen]: failed to open stream: Permission denied in .../chat/chat.php on line 110

    - Gibt es die Datei clear.txt im Verzeichnis /chat?
    - Falls nein: anlegen (kann leer sein)
    - Falls ja: CHMOD 666
  • Warning: chmod() [function.chmod]: Operation not permitted in .../chat/chat.php on line xxx

    - Gibt es das Verzeichnis /xxx? (schau in der Datei chat.php in Zeile xxx, welches Verzeichnis gemeint ist)
    - Falls nein: anlegen
    - Falls ja: CHMOD 777

Ich kann nichts schreiben.

  • Wurden bei der Installation die Unterordner "rooms", "user" und "logs" angelegt? Falls nein: manuell anlegen.
  • Dateirechte setzen: (CHMOD) siehe readme.txt.
  • ACHTUNG! KEINESFALLS 777 für den Ordner /chat! Damit öffnest du Hackern Tür und Tor.
    Anm.: wenn der Chat auf deinem Webspace nur mit CHMOD 777 für den Ordner /chat läuft, dann solltest du über einen Providerwechsel nachdenken.
  • Wenn du nicht weisst, wie man Dateirechte setzt: Es gibt genügend Anleitungen hierfür im Web, z.B. für WS-FTP
  • Manchmal hilft auch folgender Trick:
    Melde dich als Admin an, und erstelle einen neuen öffentlichen Raum. Wenn du in diesem Raum schreiben kannst, dann lösche den Raum "Standard", und lege ihn neu an.
    (Wie man Räume anlegt und löscht, findest du in der Hilfe.)

Wie werde ich Admin? Wie logge ich mich als Admin ein?

  • Die Datei chat_config.php mit einem Texteditor öffnen, und dort die Namen für die Admins festlegen:
    $admins = array(
    'Admin1',
    'Admin2',
    'Admin3'
    );
  • WICHTIG! Die Admin Namen schützen:
    Rufe die Datei login.php auf. (im Browser!) Das geht auch per X...Logout im Chat, dann "zum Login ..." und dort "zur Registrierung" Jetzt jeden Admin Namen mit einem eigenen Passwort registrieren (auch nicht benutzte Admin Namen!).
  • Wenn du jetzt mit einem der oben registrierten Namen den Chat betrittst, bist du Admin.

Nach dem Login sehe ich nur eine weiße Seite

Mögliche Ursachen:

  • Du hast die chat_config.php mit dem Editor von Windows bearbeitet. Der Windows Editor schreibt beim Speichern von utf-8-Dateien ein sogenanntes BOM. Und das macht die Datei kaputt.
  • Lösung 1: Verwende einen richtigen Editor. Z. B. den Notepad++
  • Lösung 2: Speichere die chat_config.php als ISO-8859-1

Das Upload Feld wird nicht angezeigt

Die Upload Funktion erfordert mindestens PHP Version 5. Bitte kontaktiere deinen Webspace Hoster, um PHP 5 freizuschalten.

Der Chat ist sehr langsam. Nach dem Abschicken dauert es mehrere Sekunden, bis meine Nachricht angezeigt wird.

Wahrscheinlichste Ursache: Dein Browsercache.

Abhilfe: Leere den Cache deines Browsers, und lade die Seite neu.

1 bis 2 Sekunden Verzögerung nach dem Abschicken einer Nachricht sind systembedingt. Die gesendete Nachricht erscheint erst dann in deinem eigenen Browser, wenn auch alle anderen sie sehen können. Viele Chats täuschen hier Schnelligkeit vor, indem sie die eigene Nachricht sofort anzeigen.

Wie kann ich den Chat in ein Forum/Board einbinden?

Das Script ist vorbereitet zur direkten Übernahme des Usernamens aus anderen Anwendung (CMS, Foren, Boards), und zur Beschränkung des Zugangs auf registrierte Forum-/Board User.
Hier gibt es Eine Schritt für Schritt Anleitung
Viele Details zu diesem Thema auch im Support Forum

Wie kann ich ein Webradio einbinden?

Was kann eigentlich der Admin? Siehe auch Hilfe

  1. (öffentliche) Räume anlegen und löschen.
  2. Einzelne, mehrere oder alle Nachrichten löschen
  3. In moderierten Räumen: Nachrichten freischalten
  4. bannen (kicken) und Maulkorb für beliebigen Zeitraum
  5. alle Räume einsehen - auch private Räume
  6. alle privaten Nachrichten sehen. Befehl: /peep
  7. lauschen, ohne gesehen zu werden. Befehl: /ghost
  8. Smileys zu more smileys hinzufügen. Befehl: /add
  9. Chat offline schalten. Befehl: /offline
  10. und natürlich die Anzeige des Chats anpassen, bis herunter zum Chat light (nur noch Chatfenster und Eingabefeld)

Benachrichtigung, wenn User den Chat betritt

Es gibt mehrere Benachrichtigungsmöglichkeiten. Da dürfte für jeden Bedarf das Passende dabei sein.

  1. Die Datei whoson.php im Browser laufen lassen. Z. B. in einem angepinnten Tab. Informiert per Sound. Nach Öffnen des Tabs werden die User pro Raum aufgelistet.
  2. Die Option "Popup aktivieren" im Chat aktivieren. Öffnet ein Popup und aktualisiert jedesmal, wenn ein User etwas postet. Sinnvoll beispielsweise, wenn eine Soundbenachrichtigung nicht möglich oder nicht gewünscht ist.
  3. Eine Push-Nachricht aufs Smartphone oder auf den Rechner. Nutzt den Messenger Telegram. Und funktioniert auch, wenn der Chat nicht geöffnet ist, ja sogar, wenn kein Browser geöffnet ist. (Nur mit Lizenz. Bitte anfragen.)

Wie schaltet man den Wortfilter aus?

Einfach die Datei badwords.txt löschen.
Oder einzelne Wörter in der Datei löschen (oder hinzufügen).

Bei manchen Usern wird immer "Willkommen im Chat" oder eine ähnliche Begrüßung angezeigt.
oder:
User kann lesen, aber nicht schreiben.

Du hast den Chat auf einem anderen Server installiert als deine Seite (Drittanbieter), und per Frame / iframe eingebunden.

Abhilfe: Dein Besucher muß Cookies von Drittanbietern zulassen
im Internet Explorer:
die Sicherheitsstufe auf niedrig stellen, oder:
Extras --> Internetoptionen --> Datenschutz --> Sites jetzt tippt man die domain des Drittanbieters ein (z.B. funpic.de) und dann auf zulassen klicken.
Wenn du oder dein Besucher das nicht wollen:
Lass die Sache mit dem Frame / iframe bleiben, und biete den Chat in einem eigenen Fenster an.

Kann ich das Script an das Layout meiner eigenen Seiten anpassen?

Ja!

Das ist eine der Stärken dieses Scripts. Brauchbare HTML und CSS Kenntnisse sind dazu aber erforderlich.

Um den Chat in ein eigenes Template einzubauen, sollten auch PHP Kenntnisse vorhanden sein. Hinweise finden sich in der Datei chat.php in den Kommentaren.

Kann ich eigene/andere Töne einbauen?

Ja!

Um Töne auszutauschen, einfach in der Datei chat_config.php die Datei einsetzen.

Unterstützt das Script auch Fremdsprachen?

Ja!

Durch die Verwendung des Zeichensatzes UTF-8 werden viele Zeichensätze unterstützt.

Alle Programmmeldungen sind aus dem Code ausgegliedert, und in Sprachdateien hinterlegt.
Bisher unterstützte Sprachen: Deutsch (langDE_inc.php) und Englisch (langEN_inc.php).
Diese Sprachdateien können sehr leicht mit einem Texteditor bearbeitet werden, und so das Programm für weitere Sprachen abgewandelt werden.
Die zu verwendenden Sprachdatei werden in der Datei chat_config.php mit der Variablen $languages eingestellt.

Ich würde mich freuen, falls sich jemand findet, der Sprachdateien für weitere Sprachen erstellt.

Werden die Beiträge irgendwann gelöscht oder beiben sie für immer stehen?

Die Beiträge werden im Unterverzeichnis "rooms" gespeichert, und können von Betreiber des Chat mit einem Texteditor gelesen und bearbeitet werden. Bei mehr als 80 Beiträgen (konfigurierbar) in einem einzelnen Chatraum werden die ältesten Beiträge automatisch archiviert (Unterverzeichnis /logs). Die Archivdateien können mit einem Reader komfortabel gelesen werden (nur Lizenzversion).

Der Admin kann die angezeigten Inhalte jederzeit löschen (die Inhalte werden dabei automatisch ins Archiv verschoben). Befehl: /clear. In privaten Räumen (Flüsterräumen) gibt es diese Löschfunktion für alle.

Der Chat kann aber auch so konfiguriert werden, dass user nur Nachrichten sehen, die geschrieben wurden, nachdem sie den Raum betreten haben.

Kann man Profile erstellen? Kann man Avatare einbinden?

Ja. In der Lizenzversion ist dieses Feature enthalten.

Funktioniert das Script auch bei viel Verkehr im Chat?

Auf einem einigermaßen schnellen Server sind 10 bis 15 user in einem Raum kein Problem (eventuell auch mehr).
Zur Verbesserung der Performance (insbesondere auf schwachen Servern) können in der chat_config.php entsprechende Einstellungen vorgenommen werden. Die einzelnen Funktionen sind dort genau kommentiert.

Hinweis: Deutlich bessere Performance bringt das Script, wenn PHP als Apache Modul, und nicht im CGI Bin läuft. Der Serveradministrator kann hier eventuell helfen.

Verursacht das Script viel Traffic?

Ja.
Jeder Chat produziert mehr oder weniger viel Traffic. Die Datenmenge, die mit diesem Script ausgetauscht wird, ist zwar begrenzt, weil nicht die ganze Seite regelmäßig refreshed wird, sondern nur der Inhalt des Nachrichtenfensters, und auch dies nur, wenn neue Nachrichten vorliegen. Darüber hinaus wird das refresh-Intervall bei Inaktivität kontinuierlich erhöht, bis zum disconnect.
Dennoch solltest du das Transfervolumen im Auge behalten, falls du diesen Chat auf deinem Webserver betreiben willst.

Das Gleiche gilt natürlich auch für Teilnehmer am Chat. Wenn du stundenlang im Chat online bist, können schon einmal einige 10 MB Datenvolumen zusammen kommen.

Speicherplatz: Werden die hochgeladenen Dateien auf dem Server irgendwann gelöscht?

  • Dateien im Ordner /upload (hochgeladene Bilder, mp3 usw.) werden nach 14 Tagen automatisch gelöscht.
  • Dateien im Ordner /tn_upload (das sind zwischengespeicherte thumbnails von großen Bildern) werden nach 30 Tagen gelöscht
  • Archiv-Dateien werden nach 180 Tagen gelöscht.

Wer das unbedingt ändern will: cleanup.php

Ist das Script sicher? Welche Sicherheitsmechanismen sind eingebaut?

  1. Das Script läuft auch mit sehr sicherer PHP-Konfiguration:
    safe_mode=on, allow_url_include=off, register_globals=off
  2. Die Eingabe von Code, und damit das Einschleusen von Schadcode, ist nicht möglich.
  3. Flooding-Sperre: zwischen 2 Eingaben vom gleichen User muß eine - konfigurierbare - minimale Zeitspanne liegen.
  4. Eine Badword-Liste bietet Schutz gegen Schmierer. Die Liste kann individuell erweitert werden.
  5. Mehr zum Thema "Sicherheit im Chat" auf der Seite Bundesamt für Sicherheit in der Informationstechnik.

Barrierefrei?

Der Chat ist barrierefrei, und auch mit AT, d.h. mit Screenreadern zugänglich. Getestet bisher mit Jaws 5.1, 6.1, 6.2, 7.1 und 9.0, Virgo4 mit WebFormator, Window Eyes, Supernova 10, HPR 3.02 und HPR 3.04 und mit dem kostenlosen Screen Reader NVDA (Version 0.6p3.2) mit Firefox. Die Verwendung einer Braille-Zeile erleichtert die Bedienung.
Anm.: Der Chat funktioniert nur, wenn Javascript verfügbar und aktiviert ist. Bisher war dies ein Ausschlußkriterium für Barrierefreiheit. Die neuen Web Content Accessibility Guidelines (WCAG) 2.0 erlauben die Verwendung von Javascript ausdrücklich.

Wichtigste Features zur Unterstüzung der Barrierefreiheit:

  • Der Chat ist vollständig per Tastatur bedienbar.
  • Übersichtlicher und strukturierter Aufbau
  • Die Aktualisierung der Nachrichten kann vorübergehend deaktiviert werden. Befehl /stop bzw. /go siehe Hilfe
  • Ohne Farben nutzbar
  • neue Nachrichten und andere Ereignisse erzeugen wahlweise einen Hinweis per Klang.
  • verschiedene Farbschemata durch Nutzer wählbar.
  • die Hilfe enthält ausführliche Hinweise zur Bedienung des Chats mit verschiedenen Screen Readern. (Diese Hinweise sind nur mit deaktiviertem CSS oder mit Screen Readern sichtbar.)

Ein nur scheinbarer Mangel des Demo-Chat im Sinne von Barrierefreiheit sind mangelhafte Kontraste bei bestimmten Nickfarben.
Dieser Mangel kann jedoch leicht behoben werden. Der User kann Farben ausschalten (Anzeigeoptionen - Kontrast), oder einen geeigneten Skin, z. B. "Invers" wählen.

Eine Diskussion zum Thema in meinem Weblog.

Wie funktioniert das Upgrade auf eine neuere Version?

Ganz einfach.
Mache ein Sicherheitsbackup aller Dateien.
Aktuellen Download entpacken, und alles auf den Server laden. Dabei alte Dateien überschreiben lassen. Der eventuelle Inhalt von Räumen bleibt erhalten - außer dem Raum Standard (diesen Raum gegebenenfalls vorher sichern).
Es empfielt sich, alle Cookies - zumindest im Verzeichnis /chat - zu löschen.
Solltest du spezielle Anpassungen in der chat_config.php vorgenommen haben, diese Datei eventuell vorher sichern oder ausdrucken, damit die Übernahme leichter ist.
Fertig.
Eine elegantere Möglichkeit, die eigenen Anpassungen in der Konfiguration beizubehalten, ist als Kommentar am Ende der Datei chat_config.php beschrieben.

Die registrierten User stehen in der Datei /user/user.txt. Wenn du die alten Registrierungen behalten willst, dann lade diese Datei aus deinem Backup wieder auf den Server hoch.

Falls du noch weitere Dateien angepasst hast, musst du diese Änderungen natürlich manuell nachvollziehen.

Wenn es nach dem Update unerwartete Probleme gibt, dann hast du möglicherweise nicht alle Dateien neu auf den Server hochgeladen.

Gibt es zusätzliche Features in der Lizenzversion?

Ja. Mit der Lizenzversion sind folgende Extras möglich:

  • Moderation (Beiträge müssen von einem Moderator freigeschaltet werden. Z. B. für Promi-Chat.)
  • Profile und Avatare
  • Komfortabler Reader für die Logfiles
  • Konfigurierbar: Flüstern nur wenn ein Admin beteiligt ist
  • Konfigurierbar: nur Admin darf Flüsterräume erstellen
  • Konfigurierbar: registrierte User dürfen schreiben, Gäste nur lesen
  • Nicknamen an Stelle von "Gast_xxx" auch ohne Registrierung
  • Popup mit neuester Nachricht, auch wenn Chatfenster / -tab nicht aktiv
  • Konfigurierbar: Dereferer Service - Was ist das?
  • Chat nur zu bestimmten Uhrzeiten öffnen

Smiley Vor allem vermittelt der Erwerb einer Lizenz natürlich das gute Gefühl, dem Entwickler für seine Arbeit eine Anerkennung zukommen zu lassen.