PiwikCharts im Backend

Aus Contao Community Documentation


Erweiterungs-Übersicht
Name des Entwicklers maTh
Version der Erweiterung 1.1.X
Kompatibilität mit Contao Version 2.9.0 - 3.0.0
Link zum Extension Repository http://contao.org/de/extension-list/view/be_piwikcharts.html
Link zum Tracker https://www.contao-community.de/showthread.php?34266


Vorausssetzungen

  • Eine Piwikinstalliation (Die Installation und Verwendung von Piwik kann hier nachgelesen werden)
  • Installation der Erweiterung be_piwikcharts

Ziele der Erweiterung

  • im Backend eine Auswahl an Besucher-Statistiken bereit stellen

Funktionen

Bepiwikcharts overview.jpg

Statistiken

Folgende Statistiken werden im Standard-Template angezeigt:

  • Anzahl Besucher in den letzten 30 Minuten
  • Anzahl Besucher in den letzten 24 Stunden
  • Anzahl Besucher (täglich) [Linien-Diagramm]
  • Anzahl Besucher (monatlich) [Linien-Diagramm]
  • Besuchszeiten (Serverzeit) (stündlich, Daten der letzten 30 Tage) [Balkendiagramm]
  • Besucherwochentage (Daten der letzten 30 Tage) [Balkendiagramm]
  • Browser (Daten der letzten 30 Tage) [Balkendiagramm]
  • Herkunft der Besucher (Daten der letzten 30 Tage) [Balkendiagramm]
  • Suchwörter (Daten der letzten 30 Tage) [Tabelle]
  • Herkunft-Webseite der Besucher (Daten der letzten 30 Tage) [Tabelle]
  • Häufigsten Seiten (Daten der letzten 30 Tage) [Tabelle]
  • Downloads (Daten der letzten 30 Tage) [Tabelle]

weitere Funktionen

  • Link "OptOut": setzt einen Cookie um eigene Besuche nicht in der Statistik zu erfassen.
  • Link "drucken": Die angezeigten Statistiken können ausgedruckt werden.

Einstellungen

Piwik-Installation

Bepiwikcharts piwik.jpg

Backend Contao

  • Die Einstellungen für die Erweiterung findet man unter "System"->"Einstellungen" im Abschnitt "Piwik-Statistiken"

Bepiwikcharts settings.jpg

  • Notwendige Daten
    • URL: Webadresse zur Piwik-Installation (z.B. http://demo.piwik.org)
    • SiteID: Seiten-ID aus der Piwik-Installation (z.B. 3)
    • AuthCode: Autentifkations-Code/token_auth (z.B. "anonymous" oder "1d4213570c35ab0fd1a26b1e0285fe0b")

weitere Statistiken anzeigen

Es ist relativ einfach möglich weitere Statistiken anzeigen zu lassen bzw. Statistiken aus der Übersicht heraus zu nehmen. Dazu muss das Template "be_piwikcharts" bearbeitet werden (Backend: "Layout" -> "Templates").

neue Grafik

Die Methode "printChart()" (Klasse "bepiwikcharts") wird benötigt:

printChart( $graphType, $apiModule, $period, $date, $width, $height, $scale, $apiAction, $additional )

  • $graphType = Grafentyp: 'evolution' (Liniendiagramm), 'horizontalBar' (horizontales Balkendiagramm), 'verticalBar' (Balkendiagramm) and 'pie' (2D Kreisdiagramm)
  • $apiModule = Bezeichnung Piwikmodul (z.B. Besucherverlauf: 'VisitsSummary')
  • $period = kleinstes Intervall ('day', 'week', 'month', 'year', 'range')
  • $date = untersuchtes Datum/Zeitintervall ('today', 'yesterday','previous30','YYYY-MM-DD%2CYYYY-MM-DD')
  • $width, $height = Breite, Höhe der zu generierenden Grafik
  • $scale = Skalierung in Prozent (z.B. 80 erzeugt ein Antialiasing)
  • $apiAction = abhängig von $apiModule
  • $additional = (optionaler Parameter) für weitere API-Parameter. Muss mit & beginnen. Schema: '&parameter=wert'


So kann ein Graf erstellt und in das Template eingebaut eingebaut werden, der die Besucheranzahl der letzten 30 Wochen anzeigt. Die Grafik wird breit wie die Seite und die Linie in grün dargestellt:

<?php

$bepiwikchart = new bepiwikcharts();

echo $bepiwikchart->printChart( "evolution", "VisitsSummary", "week", "previous30", 813, 100, 80, "get", "&colors=,,00ff00" );

?>

Ansichten
Meine Werkzeuge

Contao Community Documentation

ich hook' mich gleich in die Abstraktion

Martin Mildner
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge