Inhalt:

	1. Systemvoraussetzungen

	2. Installation
		2.1 Konfigurationsdatei & Upload
		2.2 Installationsroutine

	3. Einbau des Counters
		3.1 Allgemeines
		3.2 Einbau mit PHP
			3.2.1 Sichbarkeit
			3.2.2 aktiv/inaktiv
			3.2.3 Seitentitel
			3.2.4 individuelles Template
			3.2.5 vorhandene Datenbankverbindung bernehmen / neue Verbindung erzwingen
			3.2.6 Anwendungsbeispiel
		3.3 PHP-Code in .html-Dateien
		3.4 Einbau mit JavaScript





1. Systemvoraussetzungen
==================
Der chCounter bentigt auf dem Webspace
- PHP in der Version 4.2.0 oder hher 
- eine MySQL-Datenbank





2. Installation
==================


2.1: Konfigurationsdatei & Upload
--------------------------------
Zunchst mssen in der Datei "includes/config.inc.php" die Zugangsdaten
fr die MySQL-Datenbank angegeben werden.
Des Weiteren kann hier das Prfix der Tabellennamen gendert werden
(=die Zeichen, die allen Namen vorangestellt werden) - wenn
mehrere chCounter-Installationen die selbe Datenbank benutzen sollen,
muss jede Installation ein eigenes Prfix besitzen, damit sich die
Tabellennamen nicht berschneiden.
Ist die Datei "config.inc.php" ausgefllt, speichere bitte und lade dann
smtliche Verzeichnisse und Dateien des chCounters in ein beliebiges
Verzeichnis deines Webspaces hoch. 


2.2: Installationsroutine
--------------------------------
Bitte rufe nach dem Hochladen der Dateien nun auf deinem Webspace (nicht
lokal auf deinem Rechner!) die Installationsdatei "install.php" im
Verzeichnis "/install/" des Counters auf und folge den Anweisungen.

Nach erfolgreichem Abschluss ist der Counter installiert. Du kannst
nun die Online-Administration ("Pfad_zum_Counter/administration")
aufrufen, um den Counter fr deine Bedrfnisse anzupassen.

WICHTIG:
Lsche nach Abschluss der Onlineinstallation UNBEDINGT das Verzeichnis
"install", um Missbrauch zu verhindern!









3. Einbau des Counters
==================


3.1: Allgemeines
===========
Jede chCounter-Installation kann nur jeweils eine einzige Homepage
zhlen - deren URL ist in der Administration vernderbar.

Der Counter muss in alle Dateien eingefgt werden, die gezhlt werden
sollen. Nur wenn der Counter in eine Datei eingefgt ist, wird das
Counter-Script bei einem Aufruf der Datei ausgefhrt und der Besucher
somit gezhlt.

Es gibt zwei verschiedene Mglichkeiten, den chCounter in eine Seite zu
integrieren: ber einen PHP- oder einen JavaScript-Code. Wann immer
mglich, sollte der Counter mit PHP eingebunden werden - JavaScript ist
nur als Notlsung anzusehen.




3.2: Einbau mit PHP
=============
ACHTUNG: Damit PHP-Code in einer Datei ausgefhrt werden kann, muss die
Datei die Endung ".php" haben. ".html"-Dateien knnen einfach in ".php"-
Dateien umbenannt werden - Konsequenzen fr deren Inhalt hat dies
nicht.
Es gibt eine Lsung, PHP-Code auch in Dateien ohne ".php"-Endung
ausfhren zu lassen - mehr dazu im Kapitel 3.3.

Der bentigte PHP-Code zum Einbau des Counters kann in der
Administration in der Rubrik "Hilfe & Kontakt" schnell und einfach
generiert werden, hier jedoch noch eine kleine Anleitung zum
"Selberbasteln": ;-)

Folgender Code fgt den chCounter in eine Datei ein:

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

Der Pfad zu der Datei counter.php muss dabei jeweils angepasst werden:
es wird entweder ein relativer Pfad von der jeweiligen Datei aus (z.B.
"chCounter/counter.php" oder "../pfad_zum_counter/counter.php", ...)
oder aber ein absoluter Pfad bentigt (dies ist die bessere Variante, da
hier der eine (absolute) Pfad berall angewendet werden kann, unabhngig
vom Ort der jeweiligen zu zhlenden Datei.
Die Administration generiert den Code mit absoluten Pfad.

WICHTIG: Bitte gib niemals eine URL an, sondern immer nur einen Pfad
des Dateisystems des Webservers!



Es gibt noch einige zustzlichen Einstellungsmglichkeiten, die nun
vorgestellt werden. Alle diese lassen sich auch kombinieren - wichtig
ist nur, dass der "include"-Befehl immer zuletzt kommt.


3.2.1: Sichbarkeit
----------------
Der Counter kann sowohl sichtbar als auch unsichtbar in eine Seite
eingebunden werden. Unabhngig von der standardmigen Einstellung
(siehe Administration -> Einstellungen -> Counter -> Einstellungen) kann
individuell im PHP-Code mittels der Variable $chCounter_visible
angegeben werden, wie der Counter scheinen soll. 0 steht fr unsichtbar,
1 fr sichtbar. Ist diese Variable nicht angegeben , wird die
standardmige Einstellung genutzt.
Beispiel:

<?php
$chCounter_visible = 0;
include('pfad_zum_counter/counter.php');
?>



3.2.2: aktiv/inaktiv
-----------------
Auf Wunsch kann der Counter inaktiv in eine Datei eingebunden werden: Es
werden dann die Counterwerte angezeigt, die Besucher dieser bestimmten
Datei jedoch nicht mitgezhlt.

Beispielcode:

<?php
$chCounter_status = 'inactive';
include('pfad_zum_counter/counter.php');
?>

Wird die Variable $chCounter_status nicht angegeben, ist der Counter
automatisch aktiv - wer mchte, kann aber $chCounter_status = 'active';
notieren.
Damit der Administrator nicht vom Counter mitgezhlt wird, gibt es in
der Administration die Mglichkeit, ein Cookie zu erhalten, welches das
Zhlen sodann verhindert (siehe Administration -> Einstellungen ->
Counter -> Einstellungen).



3.2.3: Seitentitel
--------------
Es kann dem Counter auch ein Seitentitel der jeweiligen Datei ber den
PHP-Code mitgeteilt werden, so dass der Counter nicht mehr nach dem
Titel suchen muss. Dies ist zum einen schneller, zum anderen bei
dynamisch generiertem Titel fr den Counter die einzige Mglichkeit, den
Seitentitel zu erhalten.
Beispiel:

<?php
$chCounter_page_title = 'Dies ist der Titel der Datei - er wird in den Statistiken an Stelle des Dateipfades angezeigt.';
include('pfad_zum_counter/counter.php');
?>

Fr weitere Informationen zu Seitentiteln siehe readme_de.txt




3.2.4: individuelles Template
----------------------------
Unabhngig von dem globalen Template (=Layoutvorlage) kann beim
Einbinden des Counters ein eigenes Template definiert werden.
Beispiel:

<?php
$chCounter_template = <<<TEMPLATE
Mit dieser Zeile beginnt das Template... z.B.:
Besucher: {V_TOTAL_VISITORS}<br />
gerade online: {V_VISITORS_CURRENTLY_ONLINE}
... und nach dieser Zeile endet das Template.
TEMPLATE;
include('pfad_zum_counter/counter.php');
?>

GANZ WICHTIG: Wird auf diesem Weg ein Template angegeben, darf die Zeile
"TEMPLATE;" niemals eingerckt werden, noch anderweitig verndert
werden!





3.2.5: vorhandene Datenbankverbindung bernehmen / neue Verbindung erzwingen
-----------------------------------------------
Standardmig baut der chCounter immer eine neue Datenbankverbindung
auf. Wird der Counter in einem PHP-Script an einer Stelle eingebunden,
an der bereits eine Verbindung zur DB aufgebaut wurde, muss der
Counter jedoch keine zustzliche Verbindung aufbauen, sondern kann die
bereits existierende ebenfalls nutzen. Dadurch wird die
Ausfhrungsgeschwindigkeit etwas verringert. Um dies zu ermglichen,
muss vor dem include()-Befehl folgende Zeile hinzugefgt werden:

$chCounter_force_new_db_connection = FALSE;





3.2.6: Beispiel
-------------------
Abschlieend hier der Code, um den Counter unsichtbar, aktiv, mit
Seitentitel "Testseite" und eigenen Template einzubinden:

<?php
$chCounter_visible = 0;
$chCounter_page_title = 'Testseite';
$chCounter_template = <<<TEMPLATE
bisherige Besucher: {V_TOTAL_VISITORS}
TEMPLATE;
include('pfad_zum_counter/counter.php');
?>





3.3 PHP-Code in .html-Dateien (Apache Webserver)
==================================

ACHTUNG: folgendes Methode ist nur auf dem Apache Webserver mglich!

Mit folgender Lsung kann PHP-Code auch in Dateien ohne .php-Endung
ausgefhrt werden: Erstelle eine reine Textdatei mit dem Dateinamen
".htaccess" und diesem Inhalt:

AddType application/x-httpd-php .html .php .htm

Fr Benutzer von Windows: Wenn Windows sich weigert, eine Datei namens
".htaccess" zu erstellen ("Bitte geben Sie einen Dateinamen an."), ffne
den Texteditor Notepad, und gehe auf "Datei -> Speicher unter...". Hier
wird der Dateiname ".htaccess" akzeptiert.

Lade diese .htaccess-Datei nun in dein Homepage-Hauptverzeichnis hoch.
Smtliche Dateien mit den Endungen .html und .htm werden nun ebenfalls
nach PHP-Code durchsucht.







3.4 Einbau mit JavaScript
=================

WICHTIG: Wann immer mglich, sollte JavaScript nicht zum Einbau des
Counters benutzt werden. Wird JavaScript genutzt, knnen smtliche
Besucher, welche JavaScript deaktiviert haben (zum Beispiel aus
Sicherheitsgrnden), nicht mehr gezhlt werden. Auch alle Robots (bspw.
die Indexierungsprogramme von Suchmaschinen) werden dann nicht mehr
registriert.

Der JavaScript-Code wird an dieser Stelle nicht vorgestellt, in der
Administration ("Hilfe & Kontakt") kann der JS-Code schnell erzeugt werden.