Vielen Dank für Ihr Interesse an unserem Script. Wir empfehlen Ihnen, sich Zeit für die Lektüre dieser Anleitung zu nehmen.
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“ />).
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.
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.
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.
Das Verzeichnis "logfiles" und die Dateien "count.txt" und "Referer.txt" müssen das Dateiattribut 777 besitzen (chmod 777) - also schreibbar sein.
Sie haben mehrere Möglichkeiten, das Script in Ihre bestehende Website einzubinden.
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.
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.
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.
Antworten auf Ihre Fragen und Lösungen für Probleme mit dem Script finden Sie in unserem Support-Forum.
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.