|
Media-Genial - FreeCounter HTML Code
Mit
FreeCounter bist du in der Lage, deine komplette Website zu loggen.
Der FreeCounter HTML-Code erkennt automatisch den Namen (im Titel) und
den URL jeder Unterseite, in den du den Code einbindest.
Dazu müsst du die Datei pphlogger.js auf deinen Webserver hochladen und
den PPhlogger HTML-Code in jede einzelne Seite deiner Homepage einbinden.
File und HTML-Code findest du beides in der Email, die du nach der
Einrichtung deines Accounts automatisch erhalten haben solltest,
oder - solltest du diese Mail verloren haben - melde dich in deinen
Statistikbereich ein,
da findest du alles noch einmal im Menü "Einstellungen".
Standard Einbindung
Hier noch
mal der Code, der in jede Seite einzubinden ist (dabei wird davon
ausgegangen, daß die Unterseiten im selben Verzeichnis wie pphlogger.js
liegen):
<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script><noscript><img alt="" src="http://www.your_domain.com/pphlogger/pphlogger.php?id=
your_username&st=img"></noscript>
Versichere dich auf jeden Fall durch Testen darüber, dass der Teil
src="pphlogger.js"
auch wirklich auf den korrekten Pfad zur Datei pphlogger.js verweist.
Solltest du Unterverzeichnisse verwenden oder aus sonstigen Gründen nicht in
der
Lage sein relative Pfadangaben zu benutzen, nehme 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 du mal auf
dem Server etwas änderst.
Wie man den FreeCounter sichtbar macht, lese bitte unter dem Abschnitt
Sichtbarkeit nach.
Sichtbarkeit
Media-Genial - FreeCounter kann wahlweise als unsichtbarer
Webbug oder als sichtbarer FreeCounter auf jeder HTML-Seite
eingeblendet werden.
Um den FreeCounter nutzen zu können muss kein PHP auf deinem Server
installiert sein, lediglich
Javascript-Files müssen abgelegt werden dürfen.
Es kann auch die Anzeige des FreeCounters im Textmodus - ohne
Bild - angezeigt werden - Du kannst selbst wählen,
ob und wie du den FreeCounter anzeigen lassen willst.
Da die Inbetriebnahme von Webserver zu Webserver variiert und nicht ganz
ohne ist, solltest du diese Dokumentation sorgfältig lesen.
Benutzerprofil - Einstellungen
Wenn du
dich in deinem Userbereich einloggst, findest du eine Rubrik namens
'Benutzerprofil'.
Hier kannst du die
Basiseinstellungen deines Accounts verändern.
Unter anderem findest du einen Schalter mit der Bezeichnung 'visible'. Dies
ist ein globaler Schalter, mit dem du die generelle Möglichkeit, den
FreeCounter anzuzeigen, ein- und ausschalten kannst, egal ob als Grafik
oder im Textmodus.
Wenn du diesen Schalter ausschaltest, wird der FreeCounter 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 findest du eine Dropdownliste
mit einigen derzeit verfügbaren TrueType-Fonts. Diese Fonts werden dazu
benutzt, den Stil des sichtbaren FreeCounters zu verändern. Im
Gegensatz zu anderen FreeCountern, die in der Regel mit fest vorgefertigten
Grafiken arbeiten,
bieten wir dir auf diese Weise die Möglichkeit, Größe, Farbe und Schriftart
deines FreeCounters
selbst frei festzulegen - du erhältst mit den verschiedenen Farbgebungen,
die du ebenfalls frei wählen kannst, eine nahezu unendliche
Auswahl an Counterstilen. Falls dir ein bestimmter Stil fehlt,,
mailto uns und schicke uns den fehlenden Font - nach einer Überprüfung, ob
rechtliche Bedenken gegen die Nutzung sprechen, schalten wir diesen
dann eventuell für dich frei.
Unter der
Auswahl der Schriftart findest du zwei Farbpaletten, mit denen du Vorder-
und Hintergrundfarbe des FreeCounters festlegen kannst.
Du kannst 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 du den Schalter
'transparent background'
anklickst, wird deine Hintergrundfarbe unabhängig
vom gewählten Wert auf transparent gesetzt. Dennoch solltest du jedoch eine
sinnvolle Hintergrundfarbe vorgeben,
um den FreeCounter farblich "glatt" in deine Webseite zu integrieren.
Noch ein Beispiel für alle drei Notationen:
plain-text: blue
RGB: 00+00+255
Hexadecimal: #0000FF
Vergesse
nicht, die '+'-Zeichen einzusetzen, wenn du das RGB-Format verwendest, und
vergesse den "Gartenzaun" (#) nicht, wenn du die hexadezimale
Schreibweise bevorzugen.
Durch einen Klick auf 'Save Konfiguration' kannst du deine Einstellungen
direkt mit dem Beispielbild am Ende der Seite überprüfen.
FreeCounter - Besucherverfolgung
Um deine
Besucher zählen zu können, müsst du das von uns per Email ausgelieferte File
"pphlogger.js" auf deinen Server hochladen.
Achte hierbei auf die korrekte Pfadangabe bei der Einbindung in deine
HTML-Seiten. Das kleine Javascript schickt nun alle
Besucherinformationen zum PowerPhlogger. Diese Informationen, die du ja
bequem mit deinem Login überprüfen kannst,
kannst du zumindest teilweise auch auf deiner Webseite sichtbar machen.
In der Folge wollen wir dir kurz erklären, wie dies funktioniert.
Standardmäßig ist der FreeCounter unsichtbar, egal welche Einstellung du in
deinem Profil vorgenommen hast!
Durch den 'visible'-Schalter in deinem Profil schaltest du lediglich die
generelle Fähigkeit ein, den FreeCounter anzuzeigen!
Um den FreeCounter auf einer spezifischen Webseite sichtbar zu machen, musst
du direkt in dieser Seite entsprechende
Parameter
in den Aufruf des FreeCounters einfügen. Alt-User des PowerPhloggers 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'.
Diese Varible darf mit folgenden Werten belegt werden:
st='js' für Textausgabe (DEFAULT)
st='img' für Bildausgabe
Willst du
den FreeCounter nun auf einer Seite sichtbar machen, müssest du showme = 'y'
setzen
showme='n' unsichtbar (DEFAULT)
showme='y' sichtbar
Ok, in
der Regel sieht der Code, den du einbindest, also wie folgt aus:
<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script><noscript><IMG alt="" src="http://www.your_domain.com/pphlogger/pphlogger.php?id=
Ihr_Accountname&st=img"></noscript>
Als
Default ist
showme = 'n'
und
st = 'js'
vorgegeben, dein FreeCounter ist also komplett unsichtbar.
Um dies zu ändern, füge den folgenden Code VOR den FreeCounter-Code
ein:
<script>showme='y'; st='js'</script>
<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script><noscript><IMG alt="" src="http://www.your_domain.com/pphlogger/pphlogger.php?id=
Ihr_Accountname&st=img"></noscript>
Dieses
Beispiel macht deinen FreeCounter sichtbar und zeigt ihn dirals Textmodus
an. Genauso funktioniert es auch als Bild, einfach st auf 'img'
setzen - schon erscheint der FreeCounter im Stil wie unter Userprofil
als Beispielbild zu sehen.
Verwenden NIE die Kombination
st='y'; showme='n',
da dies eine leere (und unnötige) 1x1 Pixel Grafik erzeugt.
Sauberer ist es, einen unsichtbaren FreeCounter auf dem Standardweg (siehe
oben) zu erzeugen.
showhits.php / Erweiterte Ausgabe
Nun weißt
du, wie du den FreeCounter selbst sichtbar machen kannst.
Nehmen wir an, du hast den PowerPhlogger-Code
am Ende jeder deiner Seiten eingebunden und du willst ihn aber an anderer
Stelle
deiner Webseite anzeigen... oder du willst
eine Anzeige, wie viele Besucher sich just in diesem Moment auf deiner
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 deinem 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='php' für Bildoutput (wenn du zum Beispiel eine Website auf unserem Host hast
`same Server´)
st='img' for image output
Die
korrekte Anwendung der 3 Modi funktioniert wie folgt:
§
JavaScript [st = 'js']:
<script language="JavaScript" type="text/javascript"
src="http://www.your_domain.com/pphlogger/
showhits.php?id=username&st=js"></script>
>> Die folgende Einstellung betrifft nur Webseiten, die von uns gehostet werden <<
§
PHP [st
= 'php']:
§ <?php
§ define('PPHL_SCRIPT_PATH', '../pphlogger/'); // relativer oder absoluter
Server Pfad
zum pphlogger-Verzeichnis
§ $id = "username";
§ $st = 'php';
§ include (PPHL_SCRIPT_PATH."showhits.php"); ?>
§
Image-Tag [st
= 'img']:
§ <img alt="" src="http://www.your_domain.com/pphlogger/showhits.php?id=username&st=img">
Die
Variable showme hat keine Wirkung auf showhits.php - sie ist immer
auf 'y' gesetzt.
Wenn du nichts sichtbar machen wollten,
würdest du 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 FreeCounters,
Download Hits etc. anzeigen. Gerade letzteres Feature ist im
Zusammenhang mit unserem integrierten
Download FreeCounter sehr interessant für Downloadarchive.
Je nach Anwendungszweck musst du 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: Du willst die aktuell anwesenden
Besucher als Text auf
deiner Webseite anzeigen:
§
JavaScript [st = 'js']:
§ <script language="JavaScript" type="text/javascript" src="http://www.your_domain.com/pphlogger/showhits.php?id=
username&st=js&type=onlineusr"></script>
§
PHP [st
= 'php']:
§ <?php
§ define('PPHL_SCRIPT_PATH', '../pphlogger/'); // relative or absolute server
path to your pphlogger-dir
§ $id = "username";
§ $type = "onlineusr";
§ $st = 'php';
§ include (PPHL_SCRIPT_PATH."showhits.php"); ?>
Nehmen
wir nun an, du willst anzeigen, wieviele Besucher die Datei /files/myfile.zip
downgeloaded haben.
Du willst diese Anzeige als Bild generieren
(selbstverständlich klappt auch dies als Text-Aufruf!):
§
Image-tag [st
= 'img']:
<IMG alt="" src="http://www.your_domain.com/pphlogger/showhits.php?id=
username&st=img&mpdl=/files/myfile.zip">
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 ie ie derderAufruf
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 du 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 muss offensichtlich DOCH zwischen verschiedenen Querystrings
unterschieden werden.
An dieser Stelle greift die Einstellung namens "short query" in Ihren
Usersettings ein. Du kannst hier einfach deinen
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 deinen Einstellungen gibst du 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 PowerPhlogger 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 du ein "*"
in das Feld "Short Query" eingibst, wird nichts abgeschnitten und der
komplette Querystring wird ausgewertet.
short query:
------------
| * |
------------
VORSICHT!
Es wird dadurch unter Umständen extrem viele Logeinträge geben, so dass 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
PowerPhlogger den kompletten
Queryteil eines URLs ab.
index.* --> /
Eine weitere
nette Ergänzung ist dieses Eingabefeld in deinen 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.
Du gibst einfach
alle deine 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 PowerPhlogger ein Downloadcounter
integriert. Um ihn nutzen zu können, mußt du deine Links wie folgt
anpassen:Nimm den folgenden Code, wenn "Ihrfile.zip" auf der in deinem
Account eingetragenen Haupt-URL liegt (die erste Adresse, die du im
Userprofil eingegeben hast):
<a href="[URL_des_Counters]/dlcount.php?id=[username]&url=/Ihrfile.zip">Ihrfile.zip</a>
Liegt die Datei
auf einem anderen Server, nimm 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.zipp</a>
Troubleshooting
§ Jede
sich um die Funktion "imagecreate" drehende Fehlermeldung deutet darauf hin,
daß deine PHP-Installation keine korrekt eingebundene GDLIB enthält.
Diese Lib wird aber vom Pphlogger zwingend benötigt.
Solltest du GD nicht anders ans Laufen bringen, versuche den imagetype
der GDLIB manuell in /admin/setup.php's Step 3 zu setzen.
Wenn du auch damit keine Anzeige des FreeCounter Bildes erreichen kannst,
deaktiviere die GDLIB komplett durch Setzen von
GD_enabled
= false
in Step 3 des Setup-Prozesses.
§
Falls du PHP
4.06 benutzt und du bekommst eine Fehlermeldung mit dem Inhalt "GD
was not built with truetype support", sollten du wissen, dass dies ein
bekanntes Problem zwischen GD + PHP 4.06 ist. Es gibt einige
Workarounds (suche im Web danach!), aber wir empfehlen vielmehr dringend
auf eine neuere PHP-Version wie etwa PHP 4.1.1 zu upgraden und dabei PHP mit
dem Parameter --with-gd-native-ttf neu zu kompilieren
(bitte beachteweiterhin, dass die eingebauten TTF-Funktionen Points für
Schriftgrößen verwenden, während Truetype 2 dafür Pixelgrößen
verwendet.)
beachte, daß wir für dieses GD-Problem keinerlei Support geben!.
Jede Mail, die dieses Problem anspricht wandert direkt und ungelesen in den
Papierkorb!
|
