Dokumentation Counter und Referer Script

Vielen Dank für Ihr Interesse an unserem Script. Wir empfehlen Ihnen, sich Zeit für die Lektüre dieser Anleitung zu nehmen.

Nach oben

Einleitung

Unser Counter und Referer Script erfüllt zwei Aufgaben. Zum Einen werden die Aufrufe der Seite gezählt und angezeigt, zum Anderen werden die externen Verweisseiten (Referer) mitgeloggt.

Das Script ist für den sofortigen Einsatz konfiguriert und eingerichtet. Nachdem Sie das Script auf den Server kopiert haben, können Sie es sofort verwenden. Sie können das Script direkt aufrufen oder in eine bestehende Seite einbinden. Mehr Informationen zum Einbinden des Scripts finden Sie im Kapitel "Einbinden des Scripts“.

Wenn Sie Änderungen vornehmen möchten, sollten Sie diese Schrittweise durchführen und nach jeder Änderung die Auswirkung auf das Script zu testen. Sie behalten dadurch den Überblick, welche Änderung einen eventuell auftretenden Fehler verursacht hat.

Wichtig: Stellen Sie sicher, dass das Verzeichnis "/logfiles/" schreibbar ist (chmod 777). Das gilt ebenso für alle Dateien in diesem Verzeichnis.

Die HTML-Templates wurden nach den Spezifikationen für XHTML 1.0 erstellt. Deshalb enthalten alle einfachen Tags (<br> oder <input>) einen abschließenden Slash (<br /> oder <input type=“text“ name=“feld“ />).

Nach oben

Konfiguration des Scripts

Die Datei "index.php" stellt die Konfigurationsdatei für das Script dar. Sie haben dadurch die Möglichkeit, die Datei zu duplizieren und mit anderen Konfigurationen aufzurufen und zu betreiben, trotzdem aber den selben Script-Kern zu nutzen.

Folgende Variablen können editiert werden:

$language     Hier können Sie die Sprache festlegen. Eingetragen werden muss hier das Kürzel, dass auch im Namen der Sprachdatei im Verzeichnis "languages" verwendet wurde (de bei languages.de.inc.php und en bei languages.en.inc.php).

$log_referers     Mit dieser Variable können Sie festlegen, ob die externen Verweisseiten (Referer) mitgeloggt werden sollen. Wenn Sie diese Funktion einschalten, müssen das Verzeichnis "/logfiles/" und die Datei "Referer.txt" schreibbar sein (chmod 777).

$count_visitors     Mit dieser Variable können Sie festlegen, ob die Seitenaufrufe gezählt werden sollen. Wenn Sie diese Funktion einschalten, müssen das Verzeichnis "/logfiles/" und die Datei "Referer.txt" schreibbar sein (chmod 777).

$display_errors     Bei Auslieferung des Scripts ist diese Variable standardmäßig auf "yes" gesetzt. Das hat zur Folge, dass Sie bei der Konfiguration des Scripts Fehlermeldungen und Hinweise zur Einrichtung des Download Centers erhalten. Sobald aber das System funktioniert können Sie die Ausgabe der Meldungen abschalten. So verwehren Sie allzu neugierigen Besuchern den Einblick in das System.

$script_root     Tragen Sie in diese Variable den Serverpfad zum Script ein. Der Pfad kann relativ (./counter_script / oder counter_script/) und absolut (z.B.: /usr/local/etc/httpd/.../counter_script / oder /kunden/homepages/.../.../htdocs/counter_script /) angegeben werden (immer mit Slash am Ende).

$path['templates']     Diese Variable enthält den Pfad zu den HTML-Template-Dateien.

$path['logfiles']     Diese Variable enthält den Pfad zum Verzeichnis, in dem sich die Log-Dateien befinden.

$temp['template']     Diese Variable enthält den Dateinamen der HTML-Template-Datei.

$file['referer']     In dieser Variable ist der Name der Referer-Datei gespeichert.

$file['count']     Diese Variable enthält den Namen der Datei, in der die Seitenaufrufe gezählt werden.

$add_text     Sie können weitere Werte, Text, Variablen oder andere Inhalte an dieser Stelle festlegen. Diese Inhalte können Sie dann mit Hilfe von entsprechenden Markierungen in geschweiften Klammern in die Templates übertragen.

    Wenn Sie eigene Werte in der Variable $add_text hinzufügen folgen Sie bitte dem Muster, dass durch die beiden Beispieleinträge deutlich gemacht wurde.

 
 
 $add_text = array(
                     'txt_additional' => 'Additional',
                     'txt_more'       => 'More'
                   ); 
 

Der erste Teil eines Eintrags (z.B.: txt_additional) stellt den Namen der Platzhalter im Template dar. Wenn Sie also den Wert von txt_additional im Template anzeigen möchten, tragen Sie dort den Namen umschlossen von geschweiften Klammern ein - {txt_additional}. Der Name darf keine Leer- oder Sonderzeichen enthalten. Erlaubt ist nur der Unterstrich.

Nach oben

Anpassung des HTML-Templates

Mit Hilfe von HTML und CSS können Sie die Templates, die sich im Verzeichnis "/templates/" befinden, komplett Ihren Wünschen anpassen.

Sollten Sie für die Anpassung WYSIWYG-Editoren wie Macromedia Dreamweaver, MS Frontpage oder NetObjects Fusion verwenden, achten Sie bitte darauf, dass die Software keine eigenmächtigen Veränderungen vornimmt. Die Funktionsweise des Scripts könnte dadurch beeinträchtigt werden. Auf jeden Fall ist es empfohlen, zur Bearbeitung der HTML-Templates einen Text-Editor zu nutzen.

In den Templates befinden sich Markierungen/Platzhalter in geschweiften Klammern, wie zum Beispiel {txt_name}. Die werden beim Aufruf des Scripts durch die entsprechenden Wörter ersetzt. Diese Wörter finden Sie in der Datei "/languages/language.de.inc.php". Natürlich können Sie diese Wörter auch ändern oder an eine andere Position innerhalb des Templates verschieben. Es spricht auch nichts dagegen, wenn Sie die Markierungen durch richtige Wörter ersetzen. Ebenso können Sie die Sprachdatei nach dem vorgegebenen Muster erweitern.

Neben den Platzhaltern für die Wörter existieren die so genannten Loops. Ähnlich wie HTML-Tags gehört immer ein Paar zusammen und darf auch nicht getrennt werden (<LOOP ...>...</LOOP>). Sie haben aber die Möglichkeit, die Position des gesamten Blocks zu verändern.

Der Loop-Block für die Anzeige der Seitenaufrufe heißt "visits". Innerhalb des Loop-Block befindet sich ein Image-Tag mit dem Pfad zum Verzeichnis mit den Zahlengrafiken. Der Platzhalter {image_name} wird durch die entsprechende Zahl ersetzt. Wenn Sie eigene Grafiken erstellen und nutzen möchten, können Sie den Pfad im Image-Tag entsprechend anpassen.

Nach oben

Dateien auf den Webserver kopieren - Upload

Erstellen Sie auf dem Server folgende Verzeichnisse (bei den meisten FTP-Programmen ist es auch möglich, alle Dateien und Verzeichnisse zu markieren und zusammen auf den Server hoch zu laden):

 /counter_script/
 /counter_script/inc/
 /counter_script/languages/
 /counter_script/logfiles/
 /counter_script/templates/
 

Kopieren Sie alle Dateien in ihre entsprechenden Verzeichnisse auf den Server. Alle Bilddateien (.gif, .jpg, .png) müssen im Binär-Modus (Binary) auf den Server übertragen werden. Alle restlichen Dateien müssen im ASCII-Modus (Text-Modus) hoch geladen werden.

Achten Sie bitte darauf, dass sich im Verzeichnis "templates" ein Verzeichnis mit Bilddateien darin befindet.

Nach oben

Die Log-Dateien

Das Verzeichnis "logfiles" und die Dateien "count.txt" und "Referer.txt" müssen das Dateiattribut 777 besitzen (chmod 777) - also schreibbar sein.

Nach oben

Einbinden des Scripts

Sie haben mehrere Möglichkeiten, das Script in Ihre bestehende Website einzubinden.

Direkt verlinken

Sie können das Script direkt verlinken und wie eine eigene Seite innerhalb Ihrer Website behandeln. Dazu können Sie auch das HTML-Template komplett an das Layout Ihrer Website anpassen.

SSI Include

Wenn Ihr Server SSI (Server Side Includes) unterstützt, können Sie das Script mit folgender Zeile SSI-Code in Ihre bestehende HTML-Seite einbinden:

<!--#include virtual="./counter/index.php" -->

Ersetzen Sie "./counter/index.php " durch den korrekten Pfad zu Ihrem Script.

Sollte das Einbinden auf diese Weise nicht funktionieren, benennen Sie bitte die HTML-Seite in .shtml um. Fragen Sie bitte auch bei Ihrem Webspace-Provider nach, ob SSI unterstützt wird.

PHP Include

Sie können das Script auch in eine bestehende PHP-Datei einbinden. Nutzen Sie dazu die include() Anweisung von PHP:

 <?php
   
     include('./counter/index.php');
 
 ?>
 

Ersetzen Sie "./counter/index.php " durch den korrekten Pfad zu Ihrem Script.

Nach oben

Support und Hilfe

Antworten auf Ihre Fragen und Lösungen für Probleme mit dem Script finden Sie in unserem Support-Forum.

Nach oben

Informationen zur Script-Lizenz

Das Script können Sie kostenlos nutzen. Wenn Sie das Script ohne Hinweis und Link auf STADTAUS.com betreiben möchten, können Sie die Vollversion online erwerben.

Kontakt: http://www.stadtaus.com/

Weitere Scripts auf STADTAUS.com:

Besuchen Sie unser neuestes Projekt MetaCollection. Die Seite ist ein Verzeichnis deutscher und internationaler Script-Archive.

http://www.metacollection.com/

Nach oben