Der chCounter von Christoph Bachner bietet dem User die Möglichkeit, Seitenzugriffe detailliert auszuwerten. Dabei stehen eine Vielzahl von Features, wie z.B. die häufigsten Seitenaufrufe oder die Referrerseiten, zur Verfügung.

Außerdem ist der chCounter einfach zu installieren und zu administrieren sowie in die Seite zu integrieren. PHP und eine MySQL-Datenbank ist für das Funktionieren des Counters Voraussetzung.

Bereits auf der Seite von pixelgraphix.de wurde beschrieben, wie der chCounter in Movable Type übernommen werden kann.

Davon angeregt, möchte ich an zwei Beispielen erläutern, wie er in die Seiten von WordPress eingebaut werden kann.

Beispiel 1:

Der chCounter soll in die Datei “single.php” eingebaut werden. Diese Datei steht dabei stellvertretend für alle Dateien, in denen das Template-Tag “the_title()” vorkommt.

Anstelle von <?php the_title(); ?>

  1. <h2>
  2. <?php the_title(); ?>
  3. </h2>
  4.  

Die Datei: single.php (vorher)

ist nun folgender Code einzusetzen:

  1. <h2>
  2. <?php
  3. $chCounter_visible = 0;
  4. $chCounter_status = 'active';
  5. $chCounter_page_title = the_title();
  6. include( 'pfad_zum_counter/counter.php' );
  7. ?>
  8. </h2>
  9.  

Die Datei: single.php (nachher)

Die einzelnen Variablen sollen kurz erklärt werden:

  • $chCounter_visible = 0;
  • Der Counter kann sowohl sichtbar als auch unsichtbar in eine Seite
    eingebunden werden, unabhängig davon, wie die Standardeinstellung ist.
  • Dabei steht die 0 für unsichtbar und die 1 für sichtbar. Wird hier nichts angegeben, so wird die im Administrationsbereich eingestellte Standardeinstellung verwendet.
  •  
  • $chCounter_status = 'active';
  • Der Counter kann inaktiv in eine Datei eingebunden werden, d.h. die Besucher dieser bestimmten Datei werden nicht mitgezählt. Wird hier nichts angegeben, so wird die Standardeinstellung ‘active‘ verwendet.
  • Im Administrationsbereich besteht zudem die Möglichkeit, den Administrator per Cookie von der Zählung auszuschließen.
  •  
  • $chCounter_page_title = the_title();
  • Mit dieser Variable wird dem chCounter der Titel der Seite mitgeteilt. Bei dynamisch generiertem Titel, wie im vorliegenden Fall, ohnehin die einzige Möglichkeit.
  • Wird nichts weiter mitgeteilt, durchsucht chCounter die Datei in folgender Reihenfolge:
    1. <!-- BEGIN CHCOUNTER_PAGE_TITLE -->Titel...<!-- END
      CHCOUNTER_PAGE_TITLE -->
    2. <title>Titel...</title>
  • Der Seitentitel kann, wie im Beispiel 2, auch direkt angegeben werden. Grundsätzlich wird zur Titelsuche immer die aufgerufene Datei zu Grunde gelegt. Werden Titel in andere Dateien ausgelagert, kann keine Titelangabe erfolgen.
  •  
  • include( 'pfad_zum_counter/counter.php' );
  • Hier muss der Pfad zur Datei counter.php eingetragen werden. Entweder als relativer oder absoluter Pfad. Wichtig ist hierbei, dass keine URL, sondern immer nur einen Pfad des Dateisystems des Webservers anzugeben ist.
  • Die drei oben genannten Variablen können auch weggelassen oder kombiniert werden. Der include-Befehl muss jedoch immer zuletzt eingetragen werden.

So sieht die Ausgabe der häufigsten Seitenaufrufe bei chCounter aus:

Ausgabe der häufigsten Seitenaufrufe dann bei chCounter

Beispiel 2:

Auf der Startseite soll in der Sidebar eine Ausgabe der Statistik erfolgen, wobei angezeigt werden soll, wieviele Besucher

  1. gerade online sind,
  2. heute und
  3. insgesamt diese Webseite besucht haben.

Zudem soll die Indexseite in der Statistik miterfasst werden. In diesem Fall braucht der Code aus dem Beispiel 1 nicht in die Datei “index.php” eingefügt werden, da diese über die eingebundene Sidebar bereits mitgezählt wird.

Folgender Code ist hierfür in die Datei “sidebar.php” einzufügen:

  1. <?php if(is_home()) {
  2. echo "<li class=\"sidebox\">";
  3. echo "<h2>Statistik</h2>";
  4. echo "<ul>";
  5. $chCounter_visible = 1;
  6. $chCounter_status = 'active';
  7. $chCounter_page_title = 'Startseite';
  8. $chCounter_template = <<<TEMPLATE
  9. <li>Besucher online: <strong>{V_VISITORS_CURRENTLY_ONLINE}</strong></li>
  10. <li>Besucher heute: <strong>{V_VISITORS_TODAY}</strong></li>

  11. <li>Besucher gesamt: <strong>{V_TOTAL_VISITORS}</strong></li>
  12. TEMPLATE;
  13. include( 'pfad_zum_counter/counter.php' );
  14. echo "</ul>";
  15. echo "</li>";
  16. } ?>
  17.  

Die Datei: sidebar.php

In diesem Quelltext steht eine weitere Variable zur Verfügung:

  • $chCounter_template = <<<TEMPLATE [eigenes Template] TEMPLATE;
  • Beim Einbinden des Counters kann, unabhängig vom globalen Template (Layoutvorlage), ein eigenes Template definiert werden.
  • Wird auf diese Weise ein Template angegeben, so darf die Zeile "TEMPLATE;" niemals eingerückt oder anderweitig verändert werden!

Der Vollständigkeit halber sei noch erwähnt, dass bei einer bestehenden Datenbankverbindung folgende Variable von Nutzen sein kann:

  • $chCounter_force_new_db_connection = FALSE;
  • Der chCounter baut standardmäßig immer eine neue Datenbankverbindung auf. Wird er aber in eine PHP-Datei eingebaut, die bereits eine Datenbankverbindung unterhält, so kann ein erneuter Verbindungsaufbau unterbunden und die bereits bestehende genutzt werden.
  •  

Die Wertvariablen {V_VISITORS_CURRENTLY_ONLINE}, {V_VISITORS_TODAY} und {V_TOTAL_VISITORS} dienen der Ausgabe.

Auf der Seite von chCounter erhaltet Ihr einen vollständigen Überblick aller 20 Counterwerte.