############################## yChat.de SETUP ###############################
##      Copyright by Paul C. Btow 2000 -  2001 (mail@paulbuetow.de)       ##
#############################################################################

yChat findest Du im Internet unter der Adresse www.yChat.de. Bei Kritik,
Anregungen oder Fragen bitte in das dort vorhandene Board posten oder eine
E-Mail an die oben stehende Adresse senden. Ich bemhe mich, yChat so gut wie
mglich zu machen und bin ber Ratschlge immer sehr erfreut :-) ...

Die Installation kann auf Unix-Systemen voll automatisch duchgefhrt werden.
Allerdings ist dafr ein Telnet-Zugang notwendig. Kopiere alle vorhandenen
Dateien in das Verzeichnis cgi-bin/yChat und fhre dann das Shellskript
setup.sh mit dem Befehl ./setup.sh aus. Alle Verzeichnisse werden
automatisch erstellt. Dies wurde allerdings nur auf SuSE Linux Systemen
mit root-Zugriff getestet. Solltest Du ein anderes System verwenden oder
den Chat auf einen virtuellen Webserver installieren wollen, dann mut Du
unter Umstnden das Verzeichnis "../../htdocs/yChat" nach "../../yChat"
in der setup.sh umbenennen. Ansonsten werden die dazugehrigen Grafikdateien
falsch oder garnicht kopiert.

Wenn Du keinen Telnet-Zugang hast, kannst Du hier die Verzeichnisse manuell
einrichten:

Folgende Basis-Dateien sind im Chat enthalten und mssen in das cgi-bin
Verzeichnis kopiert werden. Z.B. nach ./cgi-bin/yChat/:

config.pm	=> Configurationsdatei ("Shared subs")
htdocs.pl	=> Generiert dynamische HTML-Inhalte
index.pl	=> Startskript (Registrierung, Login, Chatframeset)
input.pl	=> Skript fr das Chateingabeframe
main.pl		=> Hauptskript (Alle Hauptfunktionen des Chats)
main2.pl	=> Skript fr editieren der Benutzerdaten etc
online.pl       => Anzeige und berprfung der eingelogten Benutzer
push.pl		=> Server-Push-Routine
ranking.php4    => Dieses Skript erstellt die Top 20 Ranking-List
setup.sh	=> Dient zur automatischen Einrichtung des Chats
README.txt	=> Beinhaltet wichtige Informationen
UPDATES.txt     => Updateliste der verschiedenen Versionen
CREDITS.txt	=> Personen, die geolfen haben yChat zu proggen
SETUP.txt	=> Dieses Dokument
colors.sno	=> Datei beinhaltet alle Farben in hex. fr die Chatoptionen
help.sno        => Datei beinhaltet alle Chatbefehle

Folgende Verzeichnisse mssen erstellt werden (chmod 777 sollte
funktionieren):

- Hier befinden sich alle fr den Chat notwenidgen Daten:
   ./cgi-bin/yChat/data/*

- Hier befinden sich alle Logdateien, die vom Chat erstellt werden:
   ./cgi-bin/yChat/data/logs/*

- Hier befinden sich die Message-Dateien der eingelogten Benutzer:
   ./cgi-bin/yChat/data/msgs/*

- Hier befinden sich alle Daten der registrierten Benutzer:
   ./cgi-bin/yChat/data/user/*

- Hier wird abgespeichert, wie oft ein Benutzerprofil insgesant schon
  aufgerufen wurde und wie lange die Chatter schon online waren:
   ./cgi-bin/yChat/data/user/counts/*

- Hier werden alle Memos abgespeichert.
   ./cgi-bin/yChat/data/user/memos/*

- Hier befinden sich alle Chat-Optionen und Passwrter der registrierten
  Benutzer:
   ./cgi-bin/yChat/data/user/options/*

- Hier befinden sich alle Benutzerprofile der Benutzer:
   ./cgi-bin/yChat/data/user/profiles/*

- Hier befinden sich alle Gstebucheintrge der Benutzer:
   ./cgi-bin/yChat/data/user/gbooks/*

- Hier wird abgespeichert, wann der der jew. benutzer zum letzten mal das
  System betreten hat.
   ./cgi-bin/yChat/data/user/lastlogin/*

- Hier befinden sich alle Daten zu den aktuellen Chatrumen und User die
  online sind
   ./cgi-bin/yChat/data/online/*

- Hier befinden sich alle offnenen Rume
   ./cgi-bin/yChat/data/online/rooms/*

- Hier befinden sich die Chatter, die sich in den jew. Rumen befinden. Die
  Verzeichnisse der Rume werden automatisch erstellt.
   ./cgi-bin/yChat/data/online/rooms/RAUMNAME/*

- Hier befinden sich alle PIDs (Process IDs) der Chatter in den jew. Rumen.
   ./cgi-bin/yChat/data/online/pids/RAUMNAME/*

- Hier befinden sich alle Chatter, die sich z.Z. im System befinden
   ./cgi-bin/yChat/data/online/users/*

- Hier befinden sich alle IP-Nummern und TempIDs der eingelogten Chatter
   ./cgi-bin/yChat/data/online/ident/*

Alle Grafik- und Multimediadateien (*.gif, *.jpg, *.swf) sollten in ein 
nicht-CGI-BIN-Verzeichnis
 kopiert werden. Z.B. nach ./yChat/.

Zum schlu sollte die config.pm-Datei nach wnschen editiert werden.
Allerdings sollten die Copyright Hinweise und die Versionsnummern nicht
manipuliert werden.

Im Folgendem werde ich ein wenig auf die im yChat-Sourcecode oft verwendeten .
Variablen eingehen:

 $var 		=> Sagt dem Skript, wie es gestartet werden soll.
 $alias 	=> Teilt dem Skript den Benutzername mit.
 $tmpid		=> Beim einloggen in den Chat wird fr den Benutzer eine
                   temporre ID generiert. Diese wird so wohl in der Variable
                   $tmpid als auch in eine Datei geschrieben. Handelt der
                   Benutzer, so wird vom Skript die  Variable $tmpid mit dem
                   Eintrag in der Datei verglichen. Sind beide  Werte
                   identisch, dann wird die Handlung des Benutzers
                   ausgefhrt.  Stimmen die Werte nicht berein, dann wird
                   die Fehlermeldung, da der Benutzer die falsche $tmpid hat
                   um mit $alias zu handeln,ausgegeben und das Skript beendet
                   sich. Dies ist eine Sicherheitsmanahme welche verbietet,
                   mit fremden Benutzernamen im  System zu handeln.
 $room		=> Sagt dem Skript, wie der aktuelle Raumname lautet.
 $col		=> Sagt dem Skript, wie die aktuelle Chatfarbe des Nicks von
                   $alias lautet.
 $seccol	=> Sagt dem Skript, wie die aktuelle Chatfarbe der Schrift von
                   $alias lautet.
 $msg		=> Beinhaltet den von $alias zu postenden Text im Chat.
                   Hiervon wird auch  in den Benutzergstebchern und im
                   Benutzerboard Gebrauch gemacht.
 $whisper	=> Beinhaltet den Benutzernamen, zu dem $alias zuletzt
                   geflstert hat.
 $id und $tmp 	=> Temporre Variablen zwecks bermittlung diverser Daten.
 $pw            => Wird im Skript index.pl verwendet um das Zugangspassword
                   zu bermitteln.

Viel Spa beim Chatten ...