phphits v1.1 Beta :: readme

 
PHP/MySQL-gestützter Webcounter
Entwickelt von Johannes Gamba [jgamba@geekfactory.de]
Neueste Version verfügbar auf www.gamba.de
 
Hinweis
 

phphits ist Freeware für den nichtkommerziellen, persönlichen Gebrauch sowie für die Nutzung an Bildungseinrichtungen. Falls Sie phphits auf einer kommerziellen Webseite einsetzen oder as auf sonstige Weise geschäftlich nutzen möchten, müssen Sie eine Lizenz erwerben. Bitte kontaktieren Sie den Autor, um weitere Informationen darüber zu erhalten.

Der Autor haftet nicht für eventuelle Schäden, die durch den Einsatz des Scripts entstehen könnten.

 
Dateien im ZIP-Archiv
 

demo.php, index.php, install.php, liesmich.html (diese Datei), log.php, loglogin.php, phphits.inc.php, readme.html, reset.php, resetlogin.php, settings.inc.php, setup.php, stats.php, statslogin.php

/digits: 0.gif - 9.gif, /style1-5: 0.gif - 9.gif

 
System-Vorraussetzungen
 

Um phphits zu nutzen, muss

• ein Web Server [z.B. Apache: httpd.apache.org]
• PHP 4.x [www.php.net]
• MySQL [www.mysql.com]

auf Ihrem System / auf dem Server Ihres Webhosters laufen.

 
Anleitung
 
[1] Entpacken Sie alle Dateien im ZIP-Archiv und laden Sie diese per FTP auf den Server Ihres Webhosters (oder kopieren sie die Dateien in den entsprechenden Ordner, falls Sie einen Webserver lokal auf Ihrem System laufen haben).
 
[2] Öffnen Sie die Datei index.php in Ihrem Webbrowser, und klicken Sie anschließend auf den obersten Link ("Counter-Konfiguration, MySQL-Datenbank und Tabellen erstellen"). Auf der folgenden Seite können Sie die Counter-Einstellungen nach Ihren Vorstellungen editieren. Achten Sie besonders darauf, dass alle MySQL-Daten korrekt sind! Nach dem Klick auf "Install phphits!" werden Ihre Einstellungen in der Datei settings.inc.php gespeichert. Der Counter erstellt zudem automatisch die MySQL-Datenbank und die Tabellen, wo die Informationen gespeichert werden.
 
[3] Anschließend können Sie die Seite demo.php im Browser öffnen, um eine Counter-Demonstration zu sehen und um zu überprüfen, ob phphits korrekt installiert wurde.
 
[4] Um den Counter auf einer Webseite einzusetzen, öffnen Sie die Seite mit einem Texteditor und fügen Sie die folgende Codezeile am Anfang des Seiten-Quelltextes ein:

<?php include "phphits.inc.php"; ?>

Alle Dateien/Seiten, die Counter-Code enthalten, müssen diese Zeile enthalten! Vergessen Sie nicht, dass sich die Dateien phphits.inc.php und settings.inc.php im selben Ordner wie Ihre Webseite befinden müssen. Weiterhin sollten alle Dateien die Counter-Code enthalten, eine .php-Endung tragen, um von PHP geparst zu werden.

 
[5] Um Besucher auf einer bestimmten Webseite zu zählen, müssen Sie die Seite mit einem Texteditor öffnen und folgende Zeile am Anfang des Seiten-Quelltextes einfügen:

<?php phphitsAddHit(); ?>

 
[6] Um die Gesamtzahl der Besucher Ihrer Website auf einer Seite anzuzeigen, öffnen Sie diese mit einem Texteditor und fügen Sie die folgende Code-Zeile an der Stelle ein, an der der Counter angezeigt werden soll:

<?php echo phphitsShowHits(0); ?>

 
[7] Wenn Sie auch die Anzahl der Besucher während der letzten x Stunden anzeigen möchten, müssen Sie die folgende Zeile einfügen:

<?php echo phphitsShowHits(x); ?>

Das x steht für die Anzahl der Stunden, der folgende Code

<?php echo phphitsShowHits(24); ?>

zeigt z.B. die Anzahl der Besucher während der letzten 24 Stunden an.

 
[8] Vielleicht möchten Sie Ihren Besuchern auch die Möglichkeit geben, zu sehen, wie viele User gerade auf Ihrer Website surfen. Um dieses Feature hinzuzufügen, müssen Sie nur die folgende Zeile einfügen:

<?php echo phphitsShowOnlineUsers(); ?>

 
[9] Falls Sie das Logfile von phphits (eine sortierbare Liste mit Detailinformationen zu allen bis jetzt gezählten Hits) sehen möchten, öffnen Sie die Seite loglogin.php in Ihrem Webbrowser und geben Sie den korrekten Benutzernamen und zugehörige Passwort ein.
 
[10] Um die Counter-Statistiken anzuzeigen, müssen Sie die Seite statslogin.php im Webbrowser öffnen und die korrekten Login-Informationen angeben.
 

[11] Eines Tages möchten Sie vielleicht den Counter zurücksetzen oder das interne Log löschen. Um dies zu tun, müssen Sie die Seite resetlogin.php in Ihrem Webbrowser öffnen und - wie gewohnt - den korrekten Benutzernamen und das Passwort eingeben. Es gibt 3 verschiedene Arten, um phphits zurückzusetzen:

• Log löschen, und Counter auf 0 zurücksetzen.
• Log löschen, aber den Counterstand unberührt lassen (nützlich, wenn Sie Platz in der Datenbank schaffen, die Anzahl der Besucher aber beibehalten möchten).
• Log beibehalten, und Counter auf 0 zurücksetzen.

 
Das war's auch schon - viel Spass mit phphits!
 
Versionen
 

v1.1 Beta (2002.08.11)

• Benutzerfreundliche Counter-Installation (setup.php)
• phphits funktioniert nun auch mit der PHP-Einstellung 'register_globals = off'
• Benutzer kann festlegen, welche Infos in der Log-Tabelle gespeichert werden (COUNTER_REC_... Einstellungen)
• Counter-Einstellungen werden nun in settings.inc.php gespeichert
• MySQL-Code optimiert
• Counter speichert Name der Seite, die der User besucht (neue Tabellenspalte!)
install.php: Neuer Check ob DB/Tabellen schon existieren
• Einige Dateien umbenannt (phphits.inc.php, resetlogin.php, reset.php)
• Liesmich nun als HTML-Seite verfügbar
• Kleinere Änderungen und Verbesserungen

v1.01 Beta (2002.08.07)

stats.php, statslogin.php: Einfache Counter-Statistiken
install.php: phphits prüft, ob DB/Tabellen schon existieren
phphits.php: neu strukturierter Einstellungs-Teil
phphits.php: neue Einstellung SQL_LOG_HITS (kann DB-Platz sparen)
• Kleinere Änderungen

v1.00 Beta (2002.07.23)

• Seperate MySQL-Tabelle zum Speichern des Counterstands
reset.php: Verschiedene Modi beim Zurücksetzen des Counters
install.php: Eigene Seite zum Erstellen der MySQL-Datenbank/-Tabellen
index.php: "Kontrollzentrum" für Counter
• Logfile: Referrer werden als Hyperlinks angezeigt
• Logfile: Anzahl der angezeigten Rows einstellbar (STATS_NUM_HITS)
• Logfile: Kleinere Dateigröße durch Verwendung von CSS
• Kleinere Bugfixes und Designänderungen

v0.99 Beta (2002.02.08)

• Counter speichert jetzt auch Info über den Referrer
• MySQL-Tabellenstruktur geändert
• Code (speziell Datenbankzugriffe) optimiert
• DNS Host Lookup kann deaktiviert werden
• Logfile kann nun nach verschiedenen Kritierien sortiert werden
• Kleinere Designänderungen

v0.951 Beta (2001.10.11)

• Kleinere Bugfixes
• HTTP_X_FORWARDED-Bug gefixt

v0.95 Beta (2001.06.04)

• phphits unterstützt jetzt 2 Modi (Text / Grafik)
• Kleinere Bugfixes

v0.92 Beta (2001.06.01)

• Seiten zum Zürucksetzen des Counters (reset.php, reset_action.php)

v0.91 Beta (2001.02.13)

• COUNTER_HITS_OFFSET-Fehler gefixt

v0.9 Beta

• Erste öffentliche Version

 

Coded by Johannes Gamba