Table of Contents

Schnellstart

Überprüfen Sie zunächst, ob die Systemvoraussetzungen erfüllt werden.

Automatische Installation per Setup-Script

(nicht für alle Versionen verfügbar)

  1. Laden Sie das selbstentpackende Setup-Script (phpfreechat-x.x-setup.php) der gewünschten Version von der Downloadseite herunter.
  2. Laden Sie diese Datei in ein öffentlich zugängliches Verzeichnis auf Ihrem Webserver hoch.
  3. Rufen Sie die Datei in Ihrem Browser auf und führen Sie die einzelnen Schritte des Setups aus. Hinweis: Löschen Sie aus Sicherheitsgründen das Setup-Script nach Abschluss der Installation.

Manuelle Installation

(wenn das GZIP-Modul unter PHP nicht zur Verfügung steht oder kein Setup-Script vorhanden ist)

  1. Laden Sie die Archivdatei der gewünschten Version von der Downloadseite herunter (zip bzw. tar.gz für Linux-Anwender).
  2. Entpacken Sie das Archiv lokal auf Ihrem Computer und laden Sie dann das “phpfreechat-x.x”-Verzeichnis in ein öffentlich zugängliches Verzeichnis auf Ihrem Webserver hoch. Tipp: Wenn Sie einen SSH-Zugang besitzen, wird empfohlen, das Archiv direkt auf dem Server zu entpacken mittels “tar xzf phpfreechat-x.x.tar.gz”.
  3. Setzen Sie die Schreibrechte der Verzeichnisse “phpfreechat-x.x/data/public” und “phpfreechat-x.x/data/private”. Entweder mittels FTP-Client:
    CHMOD 777 phpfreechat-x.x/data/private
CHMOD 777 phpfreechat-x.x/data/public

    oder über SSH: 

    chmod 777 phpfreechat-x.x/data/*

    Hinweis: Unter Umständen erhalten Sie die Fehlermeldung “Error: the chat cannot be loaded!…” beim Start des Chats. Versuchen Sie es dann mit chmod 755.

  4. Rufen Sie das “phpfreechat-x.x”-Verzeichnis über Ihren Browser auf, um den Chat zu starten.

Konfiguration des Chats

Die Konfiguration wird direkt in der Datei “phpfreechat-x.x/index.php” vorgenommen, die auch den Chat startet. Sie enthält standardmäßig eine Beispielseite, die Sie Ihren Bedürfnissen entsprechend anpassen oder deren Inhalt Sie komplett überschreiben können. Ebenso können Sie eine ganz neue Datei dafür anlegen.

Die Chat-Datei muss mindestens folgenden Inhalt haben: 

<?php
 
require_once ('src/phpfreechat.class.php');
$params['serverid'] = md5(__FILE__); // eindeutige ID zur Identifizierung des Chats
// ... weitere Optionen hier einfügen ...
$chat = new phpFreeChat($params);
 
?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
  <head>
    <meta http-equiv="content-type" content="text/html; charset=utf-8" />
    <title>phpFreeChat</title>
  </head>
  <body>
    <?php $chat->printChat(); ?>
  </body>
</html>

Weitere Optionen werden über das Array $params festgelegt. Eine Übersicht finden Sie in der Parameterliste. Beispiele zeigen die Demos im “phpfreechat-x.x/demo”-Verzeichnis.

Um z.B. die Sprache auf deutsch umzustellen, fügen Sie eine der folgenden Zeilen zur Chat-Datei hinzu: 

$params['language'] = 'de_DE-informal'; // für Deutsch-Du
$params['language'] = 'de_DE-formal';   // für Deutsch-Sie

Achtung: Wenn ein Parameter geändert, hinzugefügt oder gelöscht wird, muss der /rehash-Befehl ausgeführt werden, damit die Änderungen wirksam werden.