[addon] advanced visitor tracking

Post custom hacks and enhancements for phpwcms here only. Maybe some of these things will be included in official release later.
Post Reply
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

[addon] advanced visitor tracking

Post by jkn »

Auf den Wunsch einer einzelnen "pappnase" :wink: poste ich an dieser stelle nochmals ein "kurzes" tutorial zur integration von pphlogger in wcms & 4images als galerie-system! Das system kann sowohl einzeln als auch in kombination genutzt werden. soll nur die installation unter wcms erfolgen, sind nur die entsprechenden schritte im "wcms-part" der anleitung erforderlich. 4images ist für das funktionieren keine bedingung...

Der Vorteil von pphlogger ist eindeutig die leichte integration UND die möglichkeit umfangreiche statistiken auch den frontend-usern zur verfügung zu stellen...seien diese nun in tabellarischer textform wie z.b.:

Image


oder grafisch visualisiert wie z.B.:

Image


die installationsanleitung zeigt nur "einen" weg zum "erfolg" :? andere z.b. über php sind möglich, sollen aber hier nicht näher dargelegt werden


okay folks, lets go...


+++++++++++++++++++++++
/// vorwort & screenshots \\\
+++++++++++++++++++++++

das tutorial zu integration in 4images stammt von vano @ 4homepages:

http://4homepages.de/forum/viewtopic.php?t=7540


unter folgender url gibts noch einige weitere backend-screenshots:

http://www.digimade.de/index.php?id=14,31,0,0,1,0



+++++++++++++++
/// wcms part \\\
+++++++++++++++

1. in wcms ist es nur nötig ein paar zusätzliche zeilen in die index.php einzufügen. Macht dazu zuerst ein backup von diesem file!

2. Downloaded das modifizierte package von pphlogger v2.2.5

3. Entpackt dieses und ladet alle files in ein von euch gewähltes verzeichnis auf euren server (z.B. "pphlogger") und installiert das skript über den aufruf des entsprechenden pfades im browser.

4. Legt im Admin-Panel einen neuen User an! z.b. loggerman! dieser bekommt vom System eine User-ID zugeteilt! z.b. 58964! diese solltet ihr euch für die späteren änderungen notieren! ..oder merken :wink:

5. loggt euch nun mit dem neuen usernamen ein (nicht im admin-panel!), klickt auf "settings" und redownloaded das pphlogger.js file, ersetzt das alte auf eurem server. es ist zudem ratsam das file auch im root abzulegen. (weniger tipparbeit bei den pfaden! ;) )

6. editiert nun die index.php & findet:

Code: Select all

<!--

phpwcms | open source web content management system
fügt DAVOR ein:

Code: Select all

<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
<noscript><img alt="" src="http://your_own_pfad/pphlogger/pphlogger.php?id=username_here&st=img"></noscript>
<- es ist nur der pfad individuell anzupassen und für "username_here" der eben angelegte username z.b. "loggerman" einzutragen!


damit wäre die installation für wcms abgeschlossen!! zur visualisierung der logs für eure visitors im frontend noch folgende tipps zur zügigen einbindung! (steht natürlich auch alles in der docu von pphlogger .. aber wer sucht schon gern lange! :D )


7. für dynamische seiten ist es erforderlich unter "Short query" in der pphlogger admin area folgendes einzutragen:

Code: Select all

id
image_id
cat_id
(image_id, cat_id ist nur für 4images erforderlich). weitere ausführungen dazu in der pphlogger-docu! Sollen alle strings geloggt werden, sollte in das query-field * eingetragen werden.


8. legt nun einen neuen artikel im wcms-backend an und integriert folgend html-code:

Code: Select all

<body> 
<table width="60%" border="0"> 
  <tr> 
    <td><p>&nbsp;</p> 
      <p>description:<br> 
      </p></td> 
    <td>&nbsp;</td> 
    <td>&nbsp;</td> 
  </tr> 
  <tr> 
    <td>hits:</td> 
    <td>zeigt alle Hits an</td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=hits"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>pageviews:</td> 
    <td>zeigt alle Pageimpressions an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=pageviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>today: </td> 
    <td>zeigt heutige Hits an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=today"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>todayviews:</td> 
    <td>zeigt heutige Pageimpressions an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=todayviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>yesterday:</td> 
    <td>zeigt gestrige Hits an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=yesterday"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>yesterdayviews:</td> 
    <td>zeigt gestrige Pageimpressions an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=yesterdayviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>month:</td> 
    <td>zeigt Hits dieses Monats an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=month"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>monthviews:</td> 
    <td>zeigt Pageimpressions dieses Monats an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=monthviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>onlineusr:</td> 
    <td>zeigt aktuell anwesende Besucher an<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=onlineusr"></script> 
      </strong></td> 
  </tr> 
</table>
dies zeigt folgende tabelle als beispiel:

Image

9. zur besseren visualisierung können nun auch chart's wie z.b.:

Image

hinzugefügt werden!

have fun! 8)



+++++++++++++++++
/// 4images part \\\
+++++++++++++++++


1. von folgenden Files der 4images-dir sollte ein backup erstellt werden:

/includes/page_header.php
/templates/<yourtemplate>/header.html (oder anderes tamplate in dem das script aufgerufen werden soll! z.b. footer.html etc.)


2. In der config.inc.php sind 2 neue angaben für 4images vorzunehmen.


3. öffnet /includes/page_header.php

Findet:

Code: Select all

  "site_name" => $config['site_name'],
fügt danach ein:

Code: Select all

  "current_user_id" => $user_info['user_id'], 
  "current_user_name" => ($user_info['user_level'] == GUEST) ? $lang['userlevel_guest'] : addslashes($user_info['user_name']), 
4. öffnet /templates/<yourtemplate>/header.html oder footer.html, und überschreibt euer logging-skript mit folgenden zeilen:

Code: Select all

<script language="JavaScript">var user_id='{current_user_id}';var user_name='{current_user_name}';</script> 
<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
<noscript><img alt="" src="../pphlogger/pphlogger.php?id=00000&st=img&user_id={current_user_id}&user_name={current_user_name}"></noscript>
die einstellungen des pfades und der user_id (00000) sind anzupassen!


:roll: und damit wäre die installation des "advanced visitor tracking systems" beendet!


ich hoffe die anleitung war einigermassen verständlich und leicht nachzuvollziehen! eine englische übersetzung folgt im -> nächsten topic, wenn ich wieder ein wenig zeit zum schreiben finde!

:arrow: über nen kleinen support meiner seite digimade.de Image oder eine verlinkung dieser würde ich mich freuen! :oops:

by
jkn
brans

Post by brans »

As "pappnase" wished me to, I'm posting a "short" tutorial about the integration of pphlogger into wcms & 4images as a gallery system. The system can be used together for both scripts or just for one of them. If you only want to install the script for wcms you only have to read the "wcms-part" of this tutorial, 4images is not needed for the script to work!

The advantage of pphlogger is that it is very easy to integrate AND you can offer very advanced statistics, for both, backend and frontend users...you can offer the stats as a table f.e.:

Image

or as a grafic f.e.:

Image

This tut is only showing one way to success, there might exist other ways, f.e. using php, but they are not handled by me.

okay folks, lets go...


+++++++++++++++++++++++
/// preface & screenshots \\\
+++++++++++++++++++++++

the tut for the integration into 4images is written by vano @ 4homepages:

http://4homepages.de/forum/viewtopic.php?t=7540


at the following url you can find some additional backend-screenshots:

http://www.digimade.de/index.php?id=14,31,0,0,1,0



+++++++++++++++
/// wcms part \\\
+++++++++++++++

1. in wcms you simply have to add some lines to your index.php, so before you modify it, please backup your index.php!

2. download the modified package of pphlogger v2.2.5

3. unzip this file, upload all files to any directory on your server(z.B. "pphlogger") and install the script by calling the setup path of pphlogger.

4. Create a new user in your admin-panel; f.e. loggerman. This user will be given a user-id by the system. f.e. 58964. you should note this id for later use! ..(or simply keep it in mind ;-) )

5. log into pphlogger (not the admin panel, but the frontend) with your new username, click on "settings" and redownload the pphlogger.js file, replace the old one on your server. I strongly recommend to place a copy of this file in your "home" directory. (less of work when you have to type the paths later :-d ! )

6. edit your index.php and search for:

Code: Select all

<!-- 

phpwcms | open source web content management system 
insert ABOVE :

Code: Select all

<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
<noscript><img alt="" src="http://your_own_pfad/pphlogger/pphlogger.php?id=username_here&st=img"></noscript> 


<- you only have to customize the path to your script and to fill in your username at "username_here" (f.e. "loggerman")!


The installation for wcms is already done. To make the stats visible to your frontend-user follow the below hints:
(you can find them in the docu of pphlogger too, but as we are all lazy to search, I copied the most important ones ;-) )


7. If you own a dynamic site, you have to enter the below code at "shor query" in your pphlogger admin-section:

Code: Select all

id 
image_id 
cat_id 
(image_id, cat_id is only needed for 4images). read more about this subject in the pphlogger docu! If all strings should be locked, simply use a wildcard * in this field.

8. now create a new article in your wcms-backend and inser the following html-code:

Code: Select all

<body> 
<table width="60%" border="0"> 
  <tr> 
    <td><p>&nbsp;</p> 
      <p>description:<br> 
      </p></td> 
    <td>&nbsp;</td> 
    <td>&nbsp;</td> 
  </tr> 
  <tr> 
    <td>hits:</td> 
    <td>shows total hits (default)</td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=hits"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>pageviews:</td> 
    <td>shows total pageimpressions<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=pageviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>today: </td> 
    <td>shows today's hits<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=today"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>todayviews:</td> 
    <td>shows today's pageimpressions<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=todayviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>yesterday:</td> 
    <td>shows yesterday's hits<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=yesterday"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>yesterdayviews:</td> 
    <td>shows yesterday's pageimpressions<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=yesterdayviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>month:</td> 
    <td>shows current month's hits<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=month"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>monthviews:</td> 
    <td>shows current month's pageimpressions<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=monthviews"></script> 
      </strong></td> 
  </tr> 
  <tr> 
    <td>onlineusr:</td> 
    <td>shows current online users<br></td> 
    <td><strong> 
      <script language="JavaScript" type="text/javascript" src="http://your_own_pfad/pphlogger/showhits.php?id=username_here&st=js&type=onlineusr"></script> 
      </strong></td> 
  </tr> 
</table> 


this will show the following table:

Image

9. for better visualization it is now possible to add charts like
Image

have fun!


+++++++++++++++++
/// 4images part \\\
+++++++++++++++++


1. please backup the following files of your 4images directory:

/includes/page_header.php
/templates/<yourtemplate>/header.html (or any other template that you want to call the script in! f.e. footer.html)


2. in your config.inc.php you have to add 2 new settings for 4images.


3. open /includes/page_header.php

search:

Code: Select all

  "site_name" => $config['site_name'],



insert below:

Code: Select all

  "current_user_id" => $user_info['user_id'], 
  "current_user_name" => ($user_info['user_level'] == GUEST) ? $lang['userlevel_guest'] : addslashes($user_info['user_name']),  
4. open /templates/<yourtemplate>/header.html or footer.html, and overwrite your logging script with the following data:

Code: Select all

<script language="JavaScript">var user_id='{current_user_id}';var user_name='{current_user_name}';</script> 
<script language="JavaScript" type="text/javascript" src="pphlogger.js"></script> 
<noscript><img alt="" src="../pphlogger/pphlogger.php?id=00000&st=img&user_id={current_user_id}&user_name={current_user_name}"></noscript> 


please customize the path and user_id (00000)!

and now the installation of your "advanced visitor tracking systems" is finished!


I hope this tut was understandable and easy to follow!

I would really appreciate any support of my site http://www.digimade.de or maybe a link Image!

by
jkn

translation by "brans at docu dot fhss dot de" (please email me any context-affecting grammar or typo error :-) )
Last edited by brans on Wed 29. Sep 2004, 17:45, edited 2 times in total.
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Post by jkn »

hey brans,
du bist spitze! danke für die übersetzung!! und ich brech mir grad einen offline beim übersetzen ab! :twisted: ... :wink:

and here is an little screen for all english visitors :wink:
Last edited by jkn on Wed 29. Sep 2004, 18:27, edited 1 time in total.
brans

Post by brans »

hehe ;-) ich weiss auch nicht, was da in mich gefahren ist, aber ich fand das TUt so nützlich, dass ich es einfach mal übersetzt habe :-d wollte eigentlich grad die Doku weiter übersetzen ;-)...

naja kannst den Screenshot wieder aus deinem post ausbaun, habe ihn oben in meine englische Version eingebaut... und zusätzlich meine Übersetzungen im HTML-Quelltext angepasst...
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Post by jkn »

:arrow: anpassung für v1.2.1 dev:

anleitung behält eigentlich wie oben ihre gültigkeit, ausser das es bei den neueren versionen noch einfacher ist den pphlogger-code zu integrieren :)

schritt 6.) edit der index.php ist nicht mehr erforderlich! tragt einfach den code:

Code: Select all

<script language="JavaScript" type="text/javascript" src="http://www.eure_url.nix/pphlogger.js"></script> 
<noscript>
<img alt="" src="http://your_own_pfad/pphlogger/pphlogger.php?id=username_here&st=img">
</noscript>
bei "html head:" beim vorlagen-edit ein! bei mir sieht der spass dann z.b. so aus:


Image

das ist alles! der logger sollte damit wieder problemlos und SEHR einfach funktionieren!!!

viel spass wuenscht euch:
jkn!

:)


p.s. vielleicht könnte das wieder jemand so klasse ins engl. übersetzen!?? brans? :oops:
brans

Post by brans »

translation:

Addition for DEV 1.2.1: You won't have to edit your index.php anymore, as it is mentioned in my first tutorial. You only have to add the above mentioned JAVA-Script Code (mentioned by JKN) into your head-section of the template (as shown on the screenshot).
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Post by jkn »

danke brans! Image
oli
Posts: 46
Joined: Thu 6. May 2004, 23:58

download doesn´t work

Post by oli »

download
2. Downloaded das modifizierte package von pphlogger v2.2.5
doesn´t work anymore :cry:
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Post by jkn »

:oops:

sooorry! it was also a little problem after upgrading from wcms rc4 -> 1.2.1!

it's now fixed!

:)

jkn
Adi
Posts: 32
Joined: Thu 20. Jul 2006, 09:22

pphlogger

Post by Adi »

ich möchte den pphlogger gern mal ausprobieren. hab mir das paket bereits heruntergeladen. aus irgendeinem grund funktioniert es mit der installation nicht. warum geht das mit http://www.meineseite.de/pphlogger/admin/setup.php in meinem browser nicht?
oder gibt es da noch einen Trick, weil du schreibst, dass man das modifizierte package von pphlogger v2.2.5 downloaden soll?
ich habe das ganze paket von http://pphlogger.phpee.com/ geholt.

vielleicht kann mir ja jemand auf die sprünge helfen?

adi
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Post by jkn »

hi,
besser ist das modifizierte package .. aber was bekommst du denn für eine fehlermeldung!???

by
jkn
Adi
Posts: 32
Joined: Thu 20. Jul 2006, 09:22

Post by Adi »

hallo jkn,
danke für deine nachricht. ich kriege error 404, url nicht gefunden .... vielleicht liegt es ja daran, dass ich das pphlogger-paket zuerst in das phpwcms-unterverzeichnis geladen habe. daraufhin gab es diverse nebeneffekte, vermutl. weil bestimmte dateien gleichnamig sind. daraufhin hab ich alles in mein rootverzeichnis verschoben, nachdem ich es vorher noch mit umsetzen diverser pfade im setup.php probiert habe. also ein ziemliches durcheinander!! ich werde wohl das ganze runterschmeißen und alles nochmal von vorne machen.
was meinst du denn für ein modifiziertes package und woher krieg ich das?
lg adi
jkn
Posts: 58
Joined: Mon 23. Aug 2004, 20:00

Re: [addon] advanced visitor tracking

Post by jkn »

Vielleicht dieses aus meinem ersten Post!??? :D :shock: :D
jkn wrote: 2. Downloaded das modifizierte package von pphlogger pphlogger v2.2.5
:lol:

eine neuinstallation scheint bei deinem "wilden" zustand sicher die beste lösung zu sein! :!:

by
jkn
Adi
Posts: 32
Joined: Thu 20. Jul 2006, 09:22

Post by Adi »

hallo jkn,
ok ok, ich habs gesehen!!! danke nochmal für deine info.
lg adele
Post Reply