Dokumentation

count4free.de basiert auf PowerPhlogger 2.2.5
Copyright (c) 2000-2003 Philip Iezzi <php@iezzi.ch>
Dokumentation Version: $Id: doc_de.html,v 1.20 2003/08/18 19:11:46 cvs_iezzi Exp $
Deutsche Übersetzung: Carsten Albrecht, www.caits.de

count4free.de HTML Code

Mit count4free.de sind Sie in der Lage, Ihre komplette Website zu loggen. Der count4free.de HTML-Code erkennt automatisch den Namen (im Titel) und den URL jeder Unterseite, in die Sie den Code einbinden.
Dazu müssen Sie die Datei pphlogger.js auf Ihren Webserver hochladen und den count4free.de HTML-Code in jede einzelne Seite Ihrer Homepage einbinden. File und HTML-Code finden Sie beides in der Email, die Sie nach der Einrichtung Ihres Accounts automatisch erhalten haben sollten, oder - sollten Sie diese Mail verloren haben - wenn Sie sich in Ihren Statistikbereich einloggen, im Menü "Settings".

Standard Einbindung

Hier nochmal der Code, der in jede Seite einzubinden ist (dabei wird davon ausgegangen, daß die Unterseiten im selben Verzeichnis wie pphlogger.js liegen):

<!-- count4free.de Code START -->
<table width="100" border="0" cellpadding="0" cellspacing="0">
<tr> 
    <td colspan="2"><a href="http://www.count4free.de"><img src="http://www.count4free.de/img/count4free_kl.png" alt="count4free.de | Der kostenlose Besucherz&auml;hler mit umfangreicher Statistik-Funktion" width="116" height="16" border="0"></a></td>
</tr>
<tr align="left" valign="top"> 
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif">gesamt:</font></td>
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif"> 
<script>showme='y'; st='js'</script><script language="JavaScript" type="text/javascript" src="/pphlogger.js"></script>
</font></td>
</tr>
<tr align="left" valign="top"> 
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif">diesen Monat:</font></td>
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif"> 
<script>showme='y'; st='js'</script><script language="JavaScript" type="text/javascript" src="http://www.count4free.de/showhits.php?id=count4free&st=js&type=month"></script>
</font></td>
</tr>
<tr align="left" valign="top"> 
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif">heute:</font></td>
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif"> 
<script language="JavaScript" type="text/javascript" src="http://www.count4free.de/showhits.php?id=count4free&st=js&type=today"></td>
</tr>
<script language="JavaScript" type="text/javascript" src="http://www.count4free.de/showhits.php?id=count4free&st=js&type=onlineusr"></script>
</font></td>
</tr>
<tr align="left" valign="top"> 
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif">jetzt online:</font></td>
<td><font size="1" face="Verdana, Arial, Helvetica, sans-serif"> 
<script language="JavaScript" type="text/javascript" src="http://www.count4free.de/showhits.php?id=count4free&st=js&type=onlineusr"></script></font></td>
</tr>
</table>
<noscript><img alt="count4free.de | Der kostenlose Besucherz&auml;hler mit umfangreicher Statistik-Funktion" src="http://www.count4free.de/pphlogger.php?id=count4free&st=img"></noscript>
<!-- count4free.de Code END -->

Versichern Sie sich auf jeden Fall durch Testen darüber, daß der Teil src="pphlogger.js" auch wirklich auf den korrekten Pfad zur Datei pphlogger.js verweist. Sollten Sie Unterverzeichnisse verwenden oder aus sonstigen Gründen nicht in der Lage sein relative Pfadangaben zu benutzen, nehmen Sie stattdessen einen absoluten Pfad mit kompletter URL wie zum Beispiel src="http://www.Ihre_Domain.com/irgendein_Unterverzeichnis_wo_Ihre_pphlogger.js_Datei_liegt/pphlogger.js" , das funktioniert genauso und ist an sich sogar sicherer, falls Sie mal auf dem Server etwas ändern.

Bitte beachten: Sie dürfen ihren kostenlosen Zähler bei count4free.de ihren eigenen Bedürfnissen anpassen (das Layout verändern, angezeigte Daten anpassen). Achten sie aber bitte darauf, dass unser Banner () und der damit verbundene Link zu http://www.count4free.de auf ihrer Homepage zu sehen ist. Gleiches gilt, wenn sie nur die Statistik benutzen und den Besucherzähler unsichtbar machen.

Sichtbarkeit

count4free.de kann wahlweise als unsichtbarer Webbug oder als sichtbarer Counter auf jeder HTML-Seite eingeblendet werden. Um den Counter nutzen zu können müssen lediglich Javascript-Files abgelegt werden dürfen. Seit Version 2.1.4 wird auch die Anzeige des Counters im Textmodus - ohne Bild - unterstützt - Sie können selbst wählen, ob und wie Sie den Counter anzeigen wollen.
Da die Inbetriebnahme von Webserver zu Webserver variiert und nicht ganz ohne ist, sollten Sie diese Dokumentation sorgfältig lesen.

[1] Userprofile Settings

Wenn Sie sich in Ihren Userbereich einloggen, finden Sie eine Rubrik namens 'Userprofil'. Hier können Sie die Basiseinstellungen Ihres Accounts verändern.
Unter anderem finden Sie einen Schalter mit der Bezeichnung 'visible'. Dies ist ein globaler Schalter, mit dem Sie die generelle Möglichkeit, den Counter anzuzeigen, ein- und ausschalten können, egal ob als Grafik oder im Textmodus. Wenn Sie diesen Schalter ausschalten, wird der Counter auf keinen Fall irgendwo angezeigt und arbeitet nur als unsichtbarer Webbug. Die Defaulteinstellung ist "eingeschaltet" und sollte von den meisten Usern unangetastet gelassen werden.
Darunter finden Sie eine Dropdownliste mit allen derzeit verfügbaren TrueType-Fonts. Diese Fonts werden dazu benutzt, den Stil des sichtbaren Counters zu verändern. Im Gegensatz zu anderen Countern, die in der Regel mit fest vorgefertigten Grafiken arbeiten, bieten wir Ihnen auf diese Weise die Möglichkeit, Größe, Farbe und Schriftart Ihres Counters selbst frei festzulegen - sie erhalten mit den verschiedenen Farbgebungen, die Sie ebenfalls frei wählen können, damit eine nahezu unendliche Auswahl an Counterstilen. Falls Ihnen ein bestimmter Stil fehlt, mailen Sie uns an und schicken Sie uns den fehlenden Font - nach einer Überprüfung, ob rechtliche Bedenken gegen die Nutzung sprechen, schalten wir diesen dann für Sie frei.

Unter der Auswahl der Schriftart finden Sie zwei Farbpaletten, mit denen Sie Vorder- und Hintergrundfarbe des Counters festlegen. Sie können einfach aus der Farbtabelle einen Wert anklicken oder selbst in Form der vom HTML üblichen drei Schreibweisen einen Wert eingeben, etwa #ff0000 oder "red" für ein knalliges rot. Wenn Sie den Schalter 'transparent background' anklicken, wird Ihre Hintergrundfarbe unabhängig vom gewählten Wert auf transparent gesetzt. Dennoch sollten Sie jedoch eine sinnvolle Hintergrundfarbe vorgeben, um den Counter farblich "glatt" in Ihre Webseite zu integrieren.
Noch ein Beispiel für alle drei Notationen:

plain-text:   blue
RGB:          00+00+255
Hexadecimal:  #0000FF

Vergessen SIe nicht, die '+'-Zeichen einzusetzen, wenn Sie das RGB-Format verwenden, und vergessen Sie den "Gartenzaun" (#) nicht, wenn Sie die hexadezimale Schreibweise bevorzugen.
Durch einen Klick auf 'Save configuration' können Sie Ihre Einstellungen direkt mit dem Beispielbild am Ende der Seite überprüfen.

[2] pphlogger.js - Besucherverfolgung

Um Ihre Besucher zählen zu können, müssen Sie das von uns per Email ausgelieferte File "pphlogger.js" auf Ihren Server hochladen. Achten Sie hierbei auf die korrekte Pfadangabe bei der Einbindung in Ihre HTML-Seiten. Das kleine Javascript schickt nun alle Besucherinformationen zum count4free.de.
Diese Informationen, die Sie ja bequem mit Ihrem Login überprüfen können, können Sie zumindest teilweise auch auf Ihrer Webseite sichtbar machen. In der Folge wollen wir Ihnen kurz erklären, wie dies funktioniert.

Standardmäßig ist der Counter unsichtbar, egal welche Einstellung Sie in Ihrem Profil vorgenommen haben!
Durch den 'visible'-Schalter in Ihrem Profil schalten Sie lediglich die generelle Fähigkeit ein, den Counter anzuzeigen! Um den Counter auf einer spezifischen Webseite sichtbar zu machen, müssen Sie direkt in dieser Seite entsprechende Parameter in den Aufruf des Counters einfügen.
Alt-User des count4free.des kennen schon lange die Variable 'showme=1'. Diese funktioniert nach wie vor, ist aber durch vielseitigere Möglichkeiten ergänzt und ersetzt worden. Mittlerweile verwenden wir die folgenden zwei Variablen: showme = 'y|n' und st = 'js|img'.
Die st Varible darf mit folgenden Werten belegt werden:

st='js'      für Textausgabe (DEFAULT)
st='img'     für Bildausgabe

Wollen Sie den Counter nun auf einer Seite sichtbar machen, müssen Sie showme = 'y' setzen

showme='n'   unsichtbar (DEFAULT)
showme='y'   sichtbar

Ok, in der Regel sieht der Code, den Sie einbinden, also wie folgt aus:

 <script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
 <noscript><IMG alt="" src="http://www.count4free.de/pphlogger.php?id=Ihr_Accountname&st=img"></noscript>

Als Default ist showme = 'n' und st = 'js' vorgegeben, Ihr Counter also komplett unsichtbar. Um dies zu ändern, fügen Sie den folgenden Code VOR den Countercode ein:

 <script>showme='y'; st='js'</script>
 <script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
 <noscript><IMG alt="" src="http://www.count4free.de/pphlogger.php?id=Ihr_Accountname&st=img"></noscript>

Dieses Beispiel macht Ihren Counter sichtbar und zeigt ihn im Textmodus an. Genauso funktioniert es auch als Bild, einfach st auf 'img' setzen - schon erscheint der Counter im Stil wie unter Userprofil als Beispielbild zu sehen.
Verwenden Sie NIE die Kombination st='y'; showme='n', da dies eine leere (und unnötige) 1x1 Pixel Grafik erzeugt. Sauberer ist es, einen unsichtbaren Counter auf dem Standardweg (siehe oben) zu erzeugen.

[3] showhits.php

Nun wissen Sie, wie Sie den Counter selbst sichtbar machen können. Nehmen wir an, Sie haben den count4free.de-Code am Ende jeder Ihrer Seiten eingebunden und Sie wollen ihn aber an anderer Stelle Ihrer Webseite anzeigen... oder Sie wollen eine Anzeige, wieviele Besucher sich just in diesem Moment auf Ihrer Seite befinden oder die Anzahl der heutigen Besucher.
Mit "showhits.php" ist all dies und noch viel mehr möglich!
Die Aufgabe dieses Scripts ist lediglich die Wiedergabe bestimmter Werte ohne selbst mitzuzählen - eine reine Anzeige also. showhits.php verändert KEINEN Wert in Ihrem Account, es wird ausschließlich lesend auf die Daten zugegriffen.
Es gibt derzeit 2 verschiedene Möglichkeiten showhits.php zu nutzen:

st='js'      für Textoutput (DEFAULT)
st='img'     for image output

Die korrekte Anwendung der 3 Modi funktioniert wie folgt:

Die Variable showme hat keine Wirkung auf showhits.php - sie ist immer auf 'y' gesetzt. Wenn Sie nichts sichtbar machen wollten, würden Sie das Script nicht aufrufen gell? ,-)

Es gibt eine Reihe von Daten, die showhits.php anzeigen kann. Das Script kann heutige Hits, heutige Pageimpressions, Hits diesen Monat/Pageimpressions diesen Monat, aktuell anwesende Besucher, komplett alle Pageimpressions seit Installation des Counters, Download Hits etc. anzeigen. Gerade letzteres Feature ist im Zusammenhang mit unserem integrierten Downloadcounter sehr interessant für Downloadarchive.
Je nach Anwendungszweck müssen Sie einfach eine andere Variable in den schon beschriebenen Code einfügen: type

----------------------------------------------------------------------------
 type=   hits | pageviews | today | todayviews | yesterday | yesterdayhits |
         month | monthviews | onlineusr | customers | mpdl
 mpdl=   /your_url


         description:
         hits:           zeigt alle Hits an (default)
         pageviews:      zeigt alle Pageimpressions an
         today:          zeigt heutige Hits an
         todayviews:     zeigt heutige Pageimpressions an
         yesterday:      zeigt gestrige Hits an
         yesterdayviews: zeigt gestrige Pageimpressions an
         month:          zeigt Hits dieses Monats an
         monthviews:     zeigt Pageimpressions dieses Monats an
         onlineusr:      zeigt aktuell anwesende Besucher an
----------------------------------------------------------------------------

Zur Veranschaulichung ein weiteres Beispiel: Sie wollen die aktuell anwesenden Besucher als Text auf Ihrer Webseite anzeigen:

Nehmen wir nun an, Sie wollen anzeigen, wieviele Besucher die Datei /files/myfile.zip downgeloaded haben. Sie wollen diese Anzeige als Bild generieren (selbstverständlich klappt auch dies als Text-Aufruf!):

 

URL handling

Dynamische Websites

Ein URL kann in die folgenden Komponenten aufgeteilt werden: <scheme>://<user>@<host>:<port>/<path>?<query>#<fragment>
Normalerweise wollen die meisten User nicht den kompletten URL in ihre Logfiles einspeichern. Im Multipage-Listing will man in der Regel keine Unterscheidung nach Querystring machen, z.B. abc.php?f=4&i=2136&t=2066 wird genauso behandelt wie der Aufruf abc.php oder abc.php?f=4&i=2000&t=2015. Daher trennen wir normalerweise den Querystring vom Rest des URL.

Anders sieht es aus, wenn Sie eine dynamische Webseite betreiben, die sich ihren Inhalt aus einer Datenbank holt - meistens wird das über eine einzige Seite und mit Querystrings erledigt, etwa eine index.php, an die dann Parameter wie zum Beispiel

index.php?artikel=123&absatz=2

angehängt werden.
Hier muß offensichtlich DOCH zwischen verschiedenen Querystrings unterschieden werden.
An dieser Stelle greift die Einstellung namens "short query" in Ihren Usersettings ein. Sie können hier einfach Ihren Querystring eintragen, der geloggt werden soll und darf. Jeder String kommt dabei in eine eigene Zeile, getrennt wird mit der <ENTER>-Taste


Ein Beispiel:

http://www.abc.com/abc.php?date=200111&s=d46df4e47043bfab5d08fee9d24e0146&threadid=100&page=news

Date und Page sind die Teile die wir loggen wollen, s= ist eine Session-ID, die sich ja bei jedem Benutzer ändert und die uns aus diesem Grund nicht interessiert. In Ihren Einstellungen geben Sie nun ein

short query:
------------
| date     |
| page     |
------------

Das Ergebnis in den Logs sieht dann so aus:
http://www.abc.com/abc.php?date=200111&page=news

Durch die Angabe von "date" und "page" schneidet der count4free.de den Querystring auf diese beiden Werte zusammen und wirft allen nicht erwünschten Ballast kurzerhand weg - so zum Beispiel die erwähnte Session-ID.

Wenn Sie ein "*" in das Feld "Short Query" eingeben, wird nichts abgeschnitten und der komplette Querystring wird ausgewertet.

short query:
------------
| *        |
------------

VORSICHT! Es wird dadurch unter Umständen extrem viele Logeinträge geben, so daß eine sinnvolle Auswertung nicht mehr möglich ist - wir empfehlen daher dringend, die Querystrings wie beschrieben zu verkleinern!

Defaultmäßig ist das "short query"-Feld komplett leer. Auf diese Weise schneidet count4free.de den kompletten Queryteil eines URLs ab.

 

index.* --> /

Eine weitere nette Ergänzung ist dieses Eingabefeld in Ihren usersettings - speziell für all jene, die Aufrufe wie http://www.abc.com/index.html als Treffer auf http://www.abc.com/ gewertet haben wollen.

Sie geben einfach alle Ihre Index-Dateien Zeile für Zeile an, die als Treffer auf / gewertet werden sollen:

---------------
| index.html  |
| index.php   |
| index.phtml |
---------------

Download Counter - dlcount.php

Als kleines Addon ist in count4free.de ein Downloadcounter integriert. Um ihn nutzen zu können, müssen Sie Ihre Links wie folgt anpassen:

Nehmen Sie den folgenden Code, wenn "Ihrfile.zip" auf der in Ihren Account eingetragenen Haupt-URL liegt (die erste Adresse, die Sie im Userprofil eingegeben haben):


 <a href="[URL_des_Counters]/dlcount.php?id=[username]&url=/Ihrfile.zip">Ihrfile.zip</a>

Liegt die Datei auf einem anderen Server, nehmen Sie entsprechend die komplette URL der Datei: 


 <a href="[URL_des_Counters]/dlcount.php?id=[username]&url=http://www.server_mit_dem_file.com/Ihrfile.zip">Ihrfile.zip</a>

Ersetzen Sie [username] durch Ihren Accountnamen (auch die '[]'-Klammern müssen weg!) und [URL_des_Counters] durch den korrekten URL unseres Counterdienstes!

FAQ - Frequently Asked Questions

Wann muß ich auf den [ clean-up ] Link unten rechts im Kalender klicken?
Der [ clean-up ] Knopf wird nur dann benutzt, wenn Ihr Kalender offensichtlich durcheinandergeraten ist und falsche oder unsinnige Werte anzeigt. Normalerweise sollte dies also NIE nötig sein, so daß Sie den Button einfach ignorieren können.
Wenn Sie auf den Link klicken, werden sämtliche Informationen des Kalenders aus den vorhandenen Logs neu berechnet (ohne dabei Logeinträge zu ändern, keine Sorge :). Wenn Sie sehr viele Logeinträge in Ihrer Logtabelle haben (mit "sehr viele" meinen wir zum Beispiel 200 Logs/Tag im Verlauf eines ganzen Jahres...), kann das Neuberechnen sehr lange dauern. Aufgrund der üblicherweise auf 30 Sekunden begrenzten AUsführungszeit von PHP-Skripten kann es dabei zum vorzeitigen Abbruch des Skripts kommen. Starten Sie das Skript in diesem Fall einfach so lange immer wieder und wieder, bis Sie den Kalender wieder sehen können. Solange das Skript läuft, RELOADEN SIE NICHT! Warten Sie IMMER, bis die Seite komplett geladne ist und der Browser dies anzeigt.
Aufgrund der sehr starken Serverbelastung dieser Funktion ist der [ clean-up ] Link für Gastuser gesperrt.

Was bedeutet "mp"?
"mp" steht für "multi-page" und ist die Anzahl aller Pageimpressions pro User. Dieser Wert zeigt an, wieviele Seiten Ihrer Homepage sich ein einzelner Besucher nacheinander angesehen hat und wieviele Reloads er dabei gemacht hat.

Wofür ist showhits.php gut?
showhits.php macht Ihren Counter sichtbar. Lesen Sie dazu den Abschnitt showhits.php

Ich benutze ein Frameset. Wie erhalte ich korrekte Referrer?
Editieren Sie ihr pphlogger.js :
Aktivieren Sie die folgende Zeile (entfernen Sie die '//'): pp_frames = TRUE;
WARNUNG: Falls Sie ein Frameset einer fremden Domain benutzen, kann das Verwenden von pp_frames zu einem JavaScript-Error führen. Benutzen Sie einen "stealth frame" wie es z.B. Namezero oder MyDomain anbieten, wird es für Sie unmöglich, Referrer zu loggen!

Wie kann ich Download-Hits auf meiner Homepage sichtbar machen?
Verwenden Sie showhits.php und rufen Sie diese Datei als IMG-Tag, PHP oder JavaScript auf.
Lesen Sie dazu den Abschnitt showhits.php
Anstelle von type=[type] geben Sie aber einfach den URL-der Datei an: mpdl=/your_url/...