Wie integriere ich Piwik in TYPO3?
Kategorie: CMS, Webentwicklung | Autor: Mirko Kaufmann
Letzte Woche haben wir hier im Mittwald Blog von den Vorteilen des kostenlosen Analyse-Tools Piwik berichtet. Mit dem heutigen Beitrag möchten wir Ihnen aufzeigen, wie Sie die nützliche Anwendung ganz einfach in Ihre TYPO3-Installationen integrieren können.
Piwik in TYPO3 integrieren
Als Mittwald-Kunde können Sie Piwik bequem über den Softwaremanager zusätzlich zu TYPO3 installieren. Im Folgenden zeigen wir Ihnen, wie einfach das Analyse-Tool im Anschluss in Ihr TYPO3-Projekt integriert werden kann.
1. Piwik Konfiguration vornehmen
Nach abgeschlossener Piwik-Installation rufen Sie das Piwik-Backend auf und konfigurieren Sie im Menüpunkt Einstellungen → Webseiten Ihre Webseite. Der Übersicht entnehmen Sie bitte die Website-ID, die im späteren Verlauf im TYPO3-Backend eingetragen werden muss (siehe Screenshot).
Sinnvolle Piwik Einstellungen
Um den Datenschutzbestimmungen zu entsprechen, kann unter Einstellungen → Plugins die Erweiterung AnonymizeIP aktiviert werden. Wenn Sie außerdem Ihren eigenen Traffic nicht mitzählen wollen, dann können Sie unter Einstellungen → Benutzereinstellungen ein Cookie setzen oder auch bestimmte IPs filtern. GET-Parameter, die nicht ausgewertet werden sollen, können unter Einstellungen → Webseiten definiert werden, z. B. cHash, phpsessid, debug.
2. Piwik und TYPO3 bequem mit Hilfe einer TYPO3-Extension koppeln
Wenn Sie die TYPO3-Erweiterung Piwik – web analytics, new API (piwik) verwenden, können Sie mit 4 Zeilen TYPOScript-Code die beiden Systeme miteinander koppeln. Im root-Template brauchen Sie dann nur im config-Bereich die entsprechende Piwik-Website-ID und die URL hinzufügen. Die URL zeigt dabei auf Ihre Piwik-Installation. Beim Anlegen der Subdomain im Mittwald-Kundencenter bitte darauf achten, dass die Subdomain auf das Verzeichnis /piwik/piwik/ zeigt.
config.tx_piwik {
piwik_idsite = 1
piwik_host = http://statistiken.ihre-domain.de/
}
Die Erweiterung fügt den benötigten JavaScript-Code für Piwik automatisch an der richtigen Stelle in Ihre TYPO3-Webseite ein. Sie brauchen sich hierbei um nichts Weiteres kümmern.
Hinweis:
Piwik wertet sämtliche Aufrufe im TYPO3-Backend sowie die aus dem Backend heraus aufgerufene Seitenvorschau nicht aus, um die Ergebnisse nicht durch redaktionelle Arbeiten zu verfälschen. Achten Sie daher darauf, dass Sie beim Test der TypoScript-Konfiguration nicht im TYPO3 Backend angemeldet sind. Ansonsten wird der JavaScript-Code im Frontend nicht hinzugefügt. Bei unseren Tests führte dies zu einigen Verzögerungen, weswegen wir die Info gerne weitergeben möchten 
Piwik ohne Erweiterung im TYPO3-Backend integrieren
Was die oben vorgestellte Erweiterung automatisch für Sie übernimmt, können Sie natürlich auch selbst im TYPO3-Backend durchführen. Loggen Sie sich in das Backend der zu analysierenden Webseite ein. Öffnen Sie das root-Template. Ein möglicher Weg die Koppelung ohne zusätzliche Erweiterung zu realisieren, ist, den JavaScript-Code direkt in das Template zu integrieren.
Für diese Lösung muss an passender Stelle der kopierte JavaScript-Code aus der Piwik-Installation eingefügt werden. Wichtig dabei ist, das der JavaScript-Code als letztes auf der Webseite ausgegeben wird, um das Laden der Webseite nicht negativ zu beeinflussen. Fügen Sie einfach in Ihrem PAGE-Objekt nach dem Template Ihren JavaScript-Code, wie im folgenden Beispiel zu sehen, ein:
page = PAGE
page {
10 = TEMPLATE
10 {
# Hier ist das eigentliche Template der Webseite hinterlegt.
}
20 = TEXT
20.value (
<!-- Piwik -->
<script type="text/javascript">
var pkBaseURL = (("https:" == document.location.protocol) ? "https://statistiken.domain.tld" : "http://statistiken.domain.tld");
document.write(unescape("%3Cscript src='" + pkBaseURL + "piwik.js' type='text/javascript'%3E%3C/script%3E"));
</script><script type="text/javascript">
try {
var piwikTracker = Piwik.getTracker(pkBaseURL + "piwik.php", 1);
piwikTracker.trackPageView();
piwikTracker.enableLinkTracking();
} catch( err ) {}
</script><noscript><p><img src="http://statistiken.domain.tld/piwik.php?idsite=1" style="border:0" alt="" /></p></noscript>
<!-- End Piwik Tag -->
)
}
Hinweis:
Der verwendete Host kann selbstverständlich bei beiden Wegen der Implementierung angepasst werden. Wenn Sie z. B. eine Piwik-Installation als Agentur für mehrere Kunden-Webseiten mit verschiedenen Benutzerkonten betreuen, können Sie eine Subdomain statistiken.ihre-agentur.de anlegen, welche auf Ihre Piwik-Installation zeigt und bei allen Kunden eingetragen wird.
Eine neutrale Lösung ohne einen Hinweis auf die Agentur oder den entsprechenden Administrator zu geben, wäre, einen Account mit einer Piwik-Installation anzulegen und diesem Account jeweils eine eigene Kunden-Subdomain z. B. statistiken.kunden-domain.de hinzuzufügen.
oputz
mvorlaender