+----------------------------------+
| GTCounter 1.1 by Wladimir Palant |
| http://www.gtchat.de/            |
+----------------------------------+

Folgende Dateien sind enthalten:

counter.pl       - Das Counter-Programm
counter_xxx.html - Vorlagen
readme.txt       - Englische Anleitung
liesmich.txt     - Deutsche Anleitung (diese Datei)
Data/.htaccess   - Schutz der Daten vor Zugriffen aus dem Web
Data/count.txt   - Anzahl der gezählten Zugriffe
Data/log.txt     - Zuletzt gesichtete IP-Adressen


Dieses Programm zeigt die Gesamtzahl der Besucher der Seite sowie
die Zahl der Besucher, die gerade online sind, an. Dabei können
mehrere Templates verwendet werden.


Installation:
=============
Ändern Sie die Templates nach Ihren Bedürfnissen ab, {ONLINE}
wird später durch die Zahl der Besucher ersetzt, die gerade
online sind, und {COUNT} durch die Gesamtzahl. Mitgeliefert werden
drei Vorlagen (es können natürlich mehr erstellt werden):

 - counter.html: Für Einbindung in Frames
 - counter_ssi.html: Für Einbindung per SSI
 - counter_inv.html: "Unsichtbarer" Counter ohne Ausgabe

Sie können über die Liste @ignore in counter.pl festlegen, welche
IP-Adressen nicht gezählt werden sollen. Am besten tragen Sie dort
ihre eigene IP-Adresse ein.

Falls der Server mit Windows 95/98/ME läuft, sollte man flock() per
Parameter in counter.pl deaktivieren, weil dieser auf diesem System
nicht implementiert ist.

Kopieren Sie alle Dateien in Ihr CGI-Verzeichnis.
Setzen Sie mit Ihrem FTP-Programm die Zugriffsrechte
von counter.pl auf ausführbar für alle (CHMOD 755) und
die von count.txt und log.txt auf Schreiben für alle (CHMOD 666).

Falls Sie die Daten oder die Templates in ein anderes Verzeichnis
kopieren wollen, ändern Sie die Parameter $templ_dir und $data_dir
in counter.pl dementsprechend.


Einbinden des Counters in die Seite:
====================================
Wenn das Programm ohne Parameter aufgerufen wird, wird das Template
counter.html verwendet. Falls man aber z.B. counter.pl?param
aufruft, wird counter_param.html als Template benutzt. Auf diese
Weise können Sie bei verschiedenen Gelegenheiten verschiedene
Templates verwenden.

- Einbinden in ein Frameset:
  Erstellen Sie in Ihrem Frameset ein Frame für den Counter, z.B.:

    <frame name=counter src="/cgi-bin/counter.pl" scrolling=no>

  Alternativ kann auch <iframe> oder <layer> verwendet werden. Beim
  Aufruf ohne Parameter wie hier wird das Template counter.html
  verwendet, das die Ausgabe des Counters in der Mitte des Frames
  plaziert.

- Einbinden per SSI:
  Bei SSI ist der HTML-Kopf nicht notwendig, deswegen sollte man das
  Template counter_ssi.html verwenden. Dazu fügt man in eine HTML-Datei
  mit Dateierweiterung .shtml zum Beispiel ein:

        <!--#include virtual="/cgi-bin/counter.pl?ssi"-->

  Wenn Sie SSI als Standard verwenden wollen, benennen Sie
  counter_ssi.html in counter.html um, dann reicht counter.pl beim
  Aufruf.

- Einbindung aus einem anderen Script:
  Sie können den Aufruf eines anderen Scripts auch als Zugriff
  registrieren lassen, ohne daß der Counter angezeigt wird. Dadurch
  wird die Anzeige der Benutzer, die Online sind, realistischer.
  Fügen Sie dazu am Anfang dieses Scripts ein:

        $no_output=1; require "counter.pl";

  Dadurch registriert der Counter die IP-Adresse des Benutzers ohne
  etwas auszugeben.


Wie erkennt der Counter, wer online ist?
========================================
Der Counter speichert in der Datei log.txt die IP-Adressen der letzten
Aufrufe. Wie lange die IP-Adressen aufbewahrt werden, bestimmt der
Parameter $keep_in_log_time in counter.pl. Bei einem Aufruf wird nur
dann hochgezählt, wenn die IP-Adresse nicht gespeichert ist.

Allerdings werden nicht alle IP-Adressen in log.txt als Benutzer
betrachtet, die noch online sind. Die Zeit, die ein Benutzer inaktiv
sein darf und trotzdem noch als online angezeigt wird, wird durch
den Parameter $keep_online_time festgelegt. Es ist sinnvoll, daß diese
Zeit kürzer als $keep_in_log_time ist.