chCounter v2.3 ReadMe |
Willkommen! chCounter ist ein Besucherzähler mit Textausgabe und umfangreicher Statistik. Die Features:
|
Systemvoraussetzungen |
|
Installation |
|
1. Konfigurations-Datei |
Zuerst müssen Konfigurations-Einstellungen in der Datei config.inc.php im Ordner /include vorgenommen werden, die Daten solltest du von deinem Hoster bekommen haben:
$chCounter_dbconfig['server'] $chCounter_dbconfig['user'] $chCounter_dbconfig['passwort'] $chCounter_dbconfig['database'] Des weiteren finden sich in der Konfigurations-Datei noch die Namen für die zu erstellenden Datenbank-Tabellen, und Umgebungs-Variablen. Wenn du nicht weißt, was du damit anfangen sollst, lass die Standard-Werte einfach stehen. |
3. Templates anpassen |
Gehe in den Ordner /templates im Counter-Verzeichnis und ändere das Aussehen des Counters / der Statistik nach deinen Wünschen.
|
4. Dateien hochladen |
Lade jetzt alle Dateien (bis auf die Dateien update.php und analyse_useragents.php) per FTP auf deinen Webspace in ein beliebiges Verzeichnis hoch. |
5. Online-Installation |
Jetzt kommt die eigentliche Installation per Webinterface:
Öffne die Datei install.php im Counter-Verzeichnis mit deinem Internetbrowser und folge einfach der Installations-Routine. |
6. Administration |
Log dich in der Administration unter z.B.
http://www.deinedomain.de/pfadzumscript/administration/index.php ein und ändere bei Bedarf die Einstellungen. |
2. Einfügen des Counters in deine Website. |
In der Administration kannst du dir einen schon individuell angepassten Code zum Einbinden des Counters ausgeben lassen, hier ist aber auch noch eine Anleitung: Einbinden per PHPDie Seite, in der du den Counter einfügen willst, muss die Endung *.php besitzen, damit sie vom PHP-Interpreter beachtet wird. <?php include("PFAD_ZUM_SCRIPT/counter.php"); ?> PFAD_ZUM_SCRIPT ist durch den Pfad zum Counter (relativ oder vom Server-Root, keinen absoluten Pfad mit "http://"!) zu ersetzen. Dadurch wird der Counter eingebunden, das Aussehen wird durch die Template-Datei counter.tpl.htm bestimmt. $chCounter_visible = "0"; Soll der Counter nicht aktiv sein, wird an gleicher Stelle folgende Zeile benötigt: $chCounter_status = "inactive"; Soll der Counter in einem anderen Erscheinungsbild als dem des globalen Templates angezeigt werden, so kann "vor Ort" ein individuelles Template angegeben werden: <?php $chCounter_template = <<<TEMPLATE Hier steht das individuelle Template, z.B.: Besucher: {TOTAL_VISITORS}<br> gerade online: {VISITORS_ONLINE} TEMPLATE; include("PFAD_ZUM_SCRIPT/counter.php"); ?> Die entsprechenden Platzhalter können dem Template counter.tpl.htm entnommen werden. TEMPLATE; darf nichts anderes stehen (die Zeile darf auch nicht mit Leerzeilen eingerückt sein)!! Einbinden per JavaScriptAlternativ kann der Counter auch mit JavaScript eingebunden werden (die Datei, in die der Counter auf diese Weise eingebunden wird, muss dann nicht die Endung *.php besitzen). Wann immer möglich, sollte aber PHP zum Einbinden des Counters benutzt werden. Das war's dann auch schon, |
Administrationsoberfläche |
Folgende Unterseiten gibt es:
|
Dokumentationen |
Hier werden ein paar Funktionen und/oder Eigenschaften des Counters genauer vorgestellt. |
Templates |
Die Templates befinden sich im Ordner "templates/". Die Templates bestimmen das Layout der Dateien counter.php, statistics.php und onlineusers.php, du kannst diese (fast) vollständig an deine Homepage anpassen. Platzhalter für die späteren Inhalte sind die geschweiften Klammern mit deren Inhalt. Es können ohne Probleme solche Platzhalter aus dem Template entfernt werden, um zum Beispiel die Ausgabe eines Wertes zu unterdrücken. Templates können auch beim Include mit PHP angebeben werden, eine genauere Information steht hier. Für die dort angegebenen Templates gilt das gleiche wie hier beschrieben. |
Seitentitel |
Um bei der Anzeige der online befindlichen Besucher und der Seitenstatistik nicht einen Pfad anzuzeigen, durchsucht der Counter standardmäßig auf dem Server die Seite, in die er eingebunden wurde, nach folgenden Tags:
Alternativ kann auch bei der Einbindung per PHP direkt ein Seitentitel angegeben werden, nach Titel-Tags wird dann nicht mehr gesucht.Um diese Funktion zu nutzen, muss vor dem include-Befehl folgende Zeile notiert werden: $chCounter_pagetitle = "HIER_MUSS_DER_SEITENTITEL_EINGEFÜGT_WERDEN"; |
Homepage-URL |
In der Administration muss die Adresse der Homepage angegeben werden. Besitzt du eine eigene Domain, so wäre die URL z.B: http://www.domainname.tld/ Für den Fall, dass deine Homepage allerdings nicht unter www.domain.tld erreichbar ist, sondern unter www.domain.tld/members/name/, dann muss die Homepage-URL so aussehen: http://www.domain.tld/members/name/. Es ist also wichtig, dass nicht nur die Domain, sondern auch der Pfad zum Homepage-Verzeichnis mit angeben wird. Solltest du eine Umleitung wie www.meinehomepage.de.vu verwenden, gib in der Administration nicht diese Umleitung an, sondern die wahre Adresse deine Homepage! |
Diverses |
FAQ's |
Der Counter wird nicht angezeigt, im Quellcode der angezeigten Seite steht nur der PHP-Code! Reicht es, den Counter nur auf einer Seite einzufügen? Werden dann trotzdem alle andern Seiten der Homepage mitgezählt? |
Update von Version 2.1.0 oder höher auf 2.3 |
|
Versionen |
v2.3 - 07.03.2004 v2.2.1 - 19.08.2003 v2.2.0 - 17.08.2003 v2.1.1 - 05.04.2003 v2.1 - 07.03.2003 v2.0 - 18.02.2003 v1.03 - 07.01.2002 v1.02 - 06.01.2003 v1.01 - 04.01.2003
v1.0 - 03.01.2003 |
Lizenz |
chCounter, Copyright by Christoph Bachner, 2004
chCounter is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. chCounter is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with chCounter; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA |
Kontakt |
|
(c) by Christoph Bachner, 2004 |