summaryrefslogtreecommitdiff
path: root/0.6.0/SETUP.txt
blob: 700b229823b2ce6660076527d179757d47f78c3c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
############################## yChat.de SETUP ###############################
##      Copyright by Paul C. Bütow 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 bemühe mich, yChat so gut wie
möglich zu machen und bin über Ratschläge immer sehr erfreut :-) ...

Die Installation kann auf Unix-Systemen voll automatisch duchgeführt werden.
Allerdings ist dafür ein Telnet-Zugang notwendig. Kopiere alle vorhandenen
Dateien in das Verzeichnis cgi-bin/yChat und führe 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 mußt Du
unter Umständen das Verzeichnis "../../htdocs/yChat" nach "../../yChat"
in der setup.sh umbenennen. Ansonsten werden die dazugehörigen 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 müssen 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 für das Chateingabeframe
main.pl         => Hauptskript (Alle Hauptfunktionen des Chats)
main2.pl        => Skript für editieren der Benutzerdaten etc
online.pl       => Anzeige und Überprüfung der eingelogten Benutzer
push.pl         => Server-Push-Routine
setup.sh        => Dient zur automatischen Einrichtung des Chats
stat.pl         => Erstellt diverse Statistiken
README.txt      => Beinhaltet wichtige Informationen
UPDATES.txt     => Updateliste der verschiedenen Versionen
CREDITS.txt     => Personen, die geolfen haben yChat zu proggen
SETUP.txt       => Dieses Dokument
chatiq.sno      => Datei beinhaltet die Chatiquette
colors.sno      => Datei beinhaltet alle Farben in hex. für die Chatoptionen
help.sno        => Datei beinhaltet alle Chatbefehle

Folgende Verzeichnisse müssen erstellt werden (chmod 777 sollte
funktionieren):

- Hier befinden sich alle für 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 Passwörter 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 Gästebucheinträge 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 Chaträumen und User die
  online sind
   ./cgi-bin/yChat/data/online/*

- Verzeichnis für die Raumstatusdateien. Hier wird abgespeichert:
  Raumbesetzer, Away (inkl. Away-Nachricht)und das Raumthema.
   ./cgi-bin/yChat/data/online/rstat/*

   - Hier befinden sich die Chatter, die sich in den jew. Räumen befinden. Die
  Verzeichnisse der Räume werden automatisch erstellt.
   ./cgi-bin/yChat/data/online/rooms/*

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

- 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 wünschen 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 für den Benutzer eine
                   temporäre 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
                   ausgeführt.  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 Sicherheitsmaßnahme 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 Benutzergästebüchern und im
                   Benutzerboard Gebrauch gemacht.
 $whisper        => Beinhaltet den Benutzernamen, zu dem $alias zuletzt
                   geflüstert hat.
 $id und $tmp         => Temporäre Variablen zwecks Übermittlung diverser Daten.
 $pw            => Wird im Skript index.pl verwendet um das Zugangspassword
                   zu übermitteln.

Viel Spaß beim Chatten ...