Gelieferte Dateien
| Konfiguration | Script Änderungen | Konfigurationsdatei | Das Aussehen | Die EigenschaftenCommand-O Software
mail@command-o.com
http://www.command-o.com
Copyright 1997, All Rights Reserved
Lesen Sie bitte die ChatPro Lizensbestimmungen bevor Sie fortfahren. Wenn Sie nun fortfahren, erkennen Sie die Linzensbestimmungen an.
Als ersten Schritt, müssen Sie das Scritp in Ihr CGI-BIN Verzeichnis Ihres Servers kopieren. Sollte Ihr Server es zulassen, daß Scripten aus einem anderen Verzeichnis heraus aufgerufen werden, so können Sie es auch in ein anderes Verzeichnis kopieren.
Nun sollte man die drei Verzeichisse festlegen, in die das Script manche Dateien kopiert. Ein Verzeichis ist für das speichern des Chats, der gerade in den verschiedenen Räumen stattfindet, einer Liste von Leuten, die sich dort aufhalten und anderen wichtigen Informationen. Das nächste Verzeichnis ist für die persönlichen Dateien die z.B. beim privaten Plausch miteinander gespeichert werden. Es ist absolut wichtig, daß diese Verzeichnisse nicht von Außen über das Web zugänglich sind. In anderen Worten sollte es eine Area ausserhalb von "hdtocs" oder "public_html" (oder ähnlich) sein. In den meisten Fällen ist es OK, wenn man diese Verzeichnisse auch im CGI-BIN Verzeichnis erstellt.
Dann müssen Sie die Rrechte für das Script und die Verzeichnisse vergeben, die dieses benutzt. Dies können Sie an einem UNIX-Prompt, in Ihrem Telnet-Fenster oder aber auch mit Ihrem FTP-Programm vornehmen.
Die Rechte sollten lauten:
chmod 755 chatpro.cgi
Wobei "chatpro.cgi" der Name des Scriptes ist.
Dann gehen Sie zum Verzeichnis, welches die drei Unterverzeichnisse entählt, die Sie vorhin erstellt haben. Nun vergeben Sie hier folgende Rechte:
chmod 777 chatfiles
chmod 777 chatvis
chmod 777 chatplugins
Wobei "chatfiles", "chatvis", und "chatplugins" die Namen der Verzeichnisse.
Bitte laden Sie die Datei chatpro.cgi nur im ASCII-Mode auf Ihren Server. Sollte sie im BINARY-Mode geladen werden, wird das Script nicht laufen..
Die folgenden Einstellungen müssen Sie vornehmen, damit das Script ordnungsgemäß arbeitet..
#!/usr/bin/perl
Dies ist die allererste Zeile in Ihrem Script und muss auf jedenfall den Pfad zu Ihrem
PERL Interpreter angeben. Eine andere Möglichkeit wäre hier #/usr/local/bin/perl
einzutragen. Wenn Sie nicht wissen, wo sich Ihr PERL Interpreter auf Ihrem Server
befindet, so geben Sie bitte in einem Telnet-Fenster whereis perl ein und
notieren Sie die Ausgabe.Sollte dieser Pfad falsch gesetzt sein zeigt Ihnen das error_log
auf Ihrem Server folgenden Fehler "errno 2".
Dieses Script läuft unter perl4 und perl5.
Noch weitere zwei Änderungen sind im Script selbst vorzunehmen. Dies sind die Pfade zu der Konfigurationsdatei und der Sprachdatei.
$conf_file = "chatpro.conf";
Wenn die Konfigurattionsdatei im gleichen Verzeichnis wie das Script liegt, können Sie
den Pfad so stehen lassen. Wenn nicht, müssen Sie ihn entsprechend ändern.
$lang_file = "chatpro.lang";
Wenn die Sprachdatei im gleichen Verzeichnis wie das Script liegt, können Sie den Pfad so
stehen lassen. Wenn nicht, müssen Sie ihn entsprechend ändern.
Alle obengenannten Änderungen bewirken, daß die Datei selbst lauffähig ist, um damit zu chatten. Die Restlichen Einstellungen werden in der Konfigurationsdatei und in der Sprachdatei vorgenommen. Die Einstellungen in der Konfigurationsdatei sind nachfolgend beschrieben.
Eine der wichtigsten Regeln ist, wenn Sie Anführungszeichen ("), ein at-Zeichen (@) oder ein Dollar-Zeichen ($) in einigen Variablen benutzen, müssen Sie einen Backslash (\) direkt vor das Zeichen setzen. Der Text sollte auf jeden Fall in der gleichen Zeile wie die $variable = stehen. An jedem Ende einer Zeile muss mit einem Semikolon abgeschlossen werden.
@valid_referers = ("www.command-o.com","command-o.com");
Hier wird die Domäne oder die Domänen eingetragen, die dieses Script auf Ihrem Server
aufrufen dürfen. Sie können die IP des Servers eingeben oder aber auch den Namen. Jede
Domäne muß zwischen Anführungszeichen stehen und alle Domänen müssen mit einem Komme
abgetrennt sein. Wenn das Script von einer anderen Domäne aus aufgerufen wird, wird
derjenige, der sich einloggt, sofort wieder zu der Registrierseite befördert :-)
$file_dir = "chatfiles";
Dies ist der Pfad zum Verzeichnis in welches das Script am meisten wechselt. Wenn dieses
Verzeichnis am gleichen Ort wie das Script selbst steht, können Sie die Zeile $file_dir
="chatfiles"; so stehen lassen.
$vis_dir = "chatvis";
Dies ist der Pfad zum Verzeichnis aus dem das Script die Daten der Besucher ausliest. Wenn
dieses Verzeichnis am gleichen Ort wie das Script selbst steht, können Sie die Zeile $vis_dir
="chatvis"; so stehen lassen.
$plugin_dir = "chatplugins";
Dies ist der Pfad zu den optionalen Plug-In Dateien, die das Script benutzen kann. Wenn
dieses Verzeichnis am gleichen Ort wie das Script selbst steht, können Sie die Zeile $plugin_dir
="chatplugins"; so stehen lassen.
Das ist alles was Sie tun müssen, um das Script auf Ihrem Server laufen zu lassen. Stellen Sie sicher, daß die Rechte korrekt vergeben sind. Die Rechte für das Script sollten 755 sein und die der Verzeichnisse 777.
Mit den folgenden Variablen wird das Aussehen der Chatseite bestimmt.
$page_title = "Command-O ChatPro 2.1";
Dies ist der Titel Ihres Chats. Es wird auch als Titel im im Browser des Besuchers
angegeben, wenn Sie keine Titelgrafik haben.
$bgcolor = "ffffff";
Dies ist die Hintergrundfarbe für alle Seiten, die vom Script generiert werden. Der Wert
muss auf jeden Fall hexadezimal angegeben werden.
$text_color = "000000";
$link_color = "0000ff";
$vlink_color = "660099";
Dies sind die Farben des Textes, der Links, und der besuchten Links. Diese müssen
natürlich auch hexadezimal angegeben werden.
$oldcolor = "444444";
Dies ist die Farbe der Mitteilung der Person im Chat, die man schon gelesen hat.Der Wert
muss auf jeden Fall hexadezimal angegeben werden.
$one_color = "cc0000";
Dies ist die Farbe der Mitteilung, die man an jemanden direkt sendet. Der Wert muss auf
jeden Fall hexadezimal angegeben werden.
$def_title_graphic = "http://www.command-o.com/chatpro/chatpro.jpg";
$def_background = "";
Dies sind die URL´s zu den Bildern die als Titelbilder oder Hintergrundbilder einzusetzen
sind. Dies sind auf jeden Fall URL´s und müssen auf jeden Fall auch mit einem http://
beginnen. Wenn Sie eines der Felder leer lassen, wird kein Bild angezeigt. Titelgrafiken
sollten etwa 270 Pixel breit und 30 Pixel hoch sein.
$include_date = 2;
Diese Variable bewirkt, daß und wie ein Datum in die Mitteilung eingefügt wird, wenn
diese abgesendet wird. 0 besagt, daß das Datum niemals hinzugefügt wird. 1 besagt, daß
das Datum immer hinzugefügt wird. 2 besagt, daß das Datum in die Sicherungsdatei der
Raumkonversation (wenn das "admin.pl" Plug-In geladen ist9 eingefügt wird, aber
nicht in den Nachrichten angezeigt wird, die im Chat zu sehen sind.
$new_message = "--> ";
Dies zeigt an, welche Nachricht man noch nicht gesehen hat. Man kann ein <img
src=\"new.gif\"> Tag setzen, aber STELLEN SIE SICHER, daß Sie den Backslash
vor die Anführungszeichen setzen.
$border = 5;
Dies ist die Breite der Rahmen um die Tablle der Chat-Seite.
$frame_height = 165;
Dies ist die Höhe des oberen Frames, wenn das optionale frames.pl Plug-In geladen ist und
der Chatter auch Frames benutzt.
$textarea_rows = 4;
Dies ist die Nummer der Zeilen im Texteingabefeld auf der Chatseite.
$textarea_cols = 50;
Dies ist die Anzahl der Spalten im Texteingabefeld auf der chatseite.
$ad_locations = "";
Diese Variable definiert, wo Werbung plaziert werden kann, wenn das optionale
"advertise.pl" Plug-In geladen ist und Sie es modifiziert haben. Die
akzeptiereten Standpunkte sind "a" und "b" für die Startseite. Die
Standpunkte "c", "d", "e", und "f" sind auf der
Chatseite.
$ad_file = "";
Dies ist die Standpunktdatei, die die Standpunkte im Script für Werbung angibt.
Erforderlich ist auch hier das "advertise.pl" Plug-In.
Die folgenden Variablen bestimmen die Eigenschaften der Chatseite.
$schedule_file = "";
Dies ist die URL zu einer Seite die detaillierte Informationen über angekündigte Chats
enthält. Auf der Startseite wird dann ein Link zu dieser Seite erstellt. Wenn dort nix
eingetragen ist, dann ist auch kein Link zu sehen.
$help_file = "http://www.command-o.com/chatpro/help.shtml";
Dies ist die URL zu der Hilfeseite für ChatPro-Benutzer. Ein Link zu dieser Seite wird
automatisch erstellt. Wenn dort kein Eintrag zu finden ist, dann wird auch kein Link
angezeigt. Sie können den Link getrost zum Command-O Hilfecenter für ChatPro setzen.
@public_rooms = ("Lobby","Living Room","Family
Room","Kitchen","Den","Bedroom");
Dies sind die Namen der offiziellen Räume in Ihrem Chat. Sie können so viele erstellen,
wie Sie möchten. Jeder Raumname steht zwischen zwei Anführungszeichen und jeder Raum ist
getrennt mit einem Komma.
$entry = "Lobby";
Dies ist der Raum, den die Chatter zuerst betreten, wenn Sie am Chat teilnehmen wollen..
$allow_private = "1";
Setzen Sie diese Variable auf "1" um den Chattern zu erlauben, eigene
Räume innerhalb Ihres Chats zu eröffnen. Wenn sie auf "0" eingestellt ist, ist
dies nicht erlaubt.
$password_style = "0";
Dies setzt die Zugriffsprivilegien Ihres Chats. Es erfordert auf jeden Fall das optionela
"access_control.pl" Plug-In im entsprechenden Verzeichnis. "0" erlaubt
jedem den Zugang mit jedem x-beliebigen Namen. "1" bedetuet, daß zwar jeder
eintreten kann, aber Namen in der Passwortliste sind reserviert und nur für die Personen,
die das korrekte Passwort zum Namen auch eingeben. "2" bedeutet, daß jeder den
Chat betreten kann, aber nur diejenigen posten können, die sich mit einem gültigen Namen
und Kennwort angemeldet haben. "3" bedeutet, daß nur Leute, die in der
Passwortliste stehen, Zugriff zum Chat haben.
$out_link = "http://www.command-o.com";
Dies ist die voreingestellte URL zu der die Leute geschickt werden, wenn Sie den Chat
verlassen.l
$archive_dir = "/usr/local/etc/httpd/htdocs/chat-archive";
ChatPro 2.1 bietet die Möglichkeit, Diskussionen zu arichivieren. Dies geht ebenso nur
mit dem optionalen "admin.pl" Plug-In. Hier wird der Pfad zum Verzeichnis
angegeben, in welchem die Archive gespeichert werden. Dieses Verzeichnis muß die Rechte
777 haben.
$visitors_time = 10;
Die ist die Zeit, in Minuten nach der der User benachrichtigt wird, wenn er die Seite
lange nicht erneut geladen hat.
$chat_time = 60;
Dies ist die Zeit in Minuten nach der die Chatdatei erneuert wird, wenn sie nicht
verändert wird. Dies bedeutet auch, daß alle Dateien für einen Chat, die nicht mehr
gebraucht werden, gelöscht werden.
$lock_sec = 5;
Das Script erzeugt ein Lockfile, wenn jemand es ausführt und löscht es, wenn das Script
wieder beendet wird. Wenn das Script versucht, diese Datei zu erstellen und dabei auf eine
vorhandene stösst, wird es warten, bis das alte Lockfile gelöscht ist. Dies stellt
sicher, daß zwei Benutzer nicht gleichzeitig das Script aufrufen können, da es ansonsten
Probleme im Diskussionsraum geben könnte. Wenn das Script ein Problem feststellt, bevor
das Lockfile beendet ist, wird die Datei dort gelassen, wo sie ist. diese Variable ist in
Sekunden angegeben. und das Script wartet mit dem Lockfile bis diese Zeit vorüber ist.
Lassen Sie den Wert bitte auf 5 stehen.
$max_mes = 40;
Dies ist die Maximale Anzahl der Nachrichten, die angezeigt werden können. Es ist auch
ein Maximum der Anzahl der Nachrichten, die innerhalb eines Raumes in einer persönlichen
Datei gespeichert werden. Je grösser die Anzahl angegeben ist, umso mehr Speicher braucht
das Script zum laufen. Auch die Dateien werden dadurch natürlich grösser.
$def_mes = 20;
Dies ist die voreingestellte Anzahl der Nachrichten die angezeigt werden. Wenn jemand
diese Anzahl erreicht, wird nach unten gescrollt.
$all_nummes = "all";
Dies ist der Text, den die Leute in das "Nachrichten [] anzeigen" Fenster
eintragen können um alle Nachrichten zu sehen.
$new_nummes = "new";
Dies ist der Text, den die Leute in das "Nachrichten [] anzeigen" Fenster
eintragen können um nur neue Nachrichten zu sehen.
$new_time = 120;
Dies ist die Zeit in Sekunden, die die Nachrichten angezeigt werden. Sie werden nach unten
gescrollt, wenn der User nur neue Nachrichten sehen möchte.
$min_reload = 15;
Dies ist das minimum der Sekunden, nach denen die Seite automatisch wieder geladen wird.
Dieses Feature erfordert das Plug-In "frames.pl". Je kleiner die Nummer, umso
öfter wird die Seite neu aufgebaut.
$def_reload = 20;
Dies ist die voreingestellte Zeit, die eine Person ändern kann um das Script automatisch
erneut zu laden. Dieses Feature erfordert das Plug-In "frames.pl". Je kleiner
die Nummer, umso öfter wird die Seite neu aufgebaut.
Dies waren die Setup-Instruktionen. Nun sollte alles ordnungsgemäß bei Ihnen laufen und Sie sollten weiterhin keine Probleme haben. Viel Spaß mit ChatPro auf Ihrem Server.