PiwikCharts im Backend: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Piwik-Installation: Beschreibung zum Erstellen eines Piwik-Users hinzugefügt)
 
(5 dazwischenliegende Versionen von einem Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
 
[[Category:Extensions]]
 
[[Category:Extensions]]
 
{{ExtInfo
 
{{ExtInfo
| Dev=maTh
+
| Dev = maTh
| ExtVersion=1.1.X
+
| ExtVersion = 1.4.X
| Version=2.9.0 - 3.0.0
+
| Version = 2.9.0 - 3.3.4
| ERLink=http://contao.org/de/extension-list/view/be_piwikcharts.html
+
| DevSite = https://github.com/mathContao/be_piwikcharts
| TrackerLink=https://www.contao-community.de/showthread.php?34266
+
| ERLink = http://contao.org/de/extension-list/view/be_piwikcharts.html
 +
| TrackerLink = https://community.contao.org/de/showthread.php?34266-be_piwikcharts-Besucherstatistiken-aus-Piwik-im-Backend-anzeigen
 +
| Comment = English translation also available. See International Contao Forum: https://community.contao.org/en/showthread.php?22615-be_piwikcharts-Stats-visitors-from-Piwik-shown-in-Contao-Backend
 
}}
 
}}
 +
 +
Dokumentation ist auf GitHub umgezogen: https://github.com/mathContao/be_piwikcharts/wiki/
  
 
=Vorausssetzungen=
 
=Vorausssetzungen=
Zeile 15: Zeile 19:
 
* im Backend eine Auswahl an Besucher-Statistiken bereit stellen
 
* im Backend eine Auswahl an Besucher-Statistiken bereit stellen
  
=Funktionen=
+
=Sprachen/Translations=
[[Datei:Bepiwikcharts_overview.jpg|500px]]
+
* [https://contao.org/de/extension-list/view/be_piwikcharts.html Deutsch - German]
==Statistiken==
+
* [https://contao.org/en/extension-list/view/be_piwikcharts.html Englisch - English]
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==
+
Um die Statistiken von außerhalb aufrufen zu können wird eine Zugriffsberechtigung auf die API von Piwik benötigt. Der Zugriff ist mit dem anonymous-User möglich als auch mit einem extra angelegten User. Die Benutzer werden in Piwik unter "Einstellungen" (rechts oben), Reiterseite "Benutzer" verwaltet:
+
[[Datei:Bepiwikcharts_piwik.jpg|500px]]
+
Der anonymous-User hat in der Standardeinstellung keine Zugriffsrechte (erkennbar an dem grünen Punkt unter "Kein Zugriff" und dem roten Punkt unter "Ansicht") und müsste aktiviert werden (auf den roten Punkte unter "Ansicht" klicken, so dass es ein grüner Punkt wird). Vorteil des anonymous-User: es wird kein vertraulicher Auth-Token benötigt. Nachteil: Der anoynomous-User ist allgemein bekannt. Nach der Aktivierung kann jeder (auch Unberechtigte) auf die Statistiken zugreifen.
+
 
+
Empfohlener Weg: Neuen Piwik-User anlegen. Der User-Name und das dazugehörige Passwort können beliebig komplex sein. User-Name und Passwort werden nicht weiter benötigt. Der Auth-Token wird automatisch generiert und sollte nicht öffentlich verwendet werden.
+
 
+
==Backend Contao==
+
* Die Einstellungen für die Erweiterung findet man unter "System"->"Einstellungen" im Abschnitt "Piwik-Statistiken"
+
[[Datei:Bepiwikcharts_settings.jpg|500px]]
+
* 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:
+
 
+
<div style="background:lightgrey;padding:30px">
+
<nowiki><?php</nowiki>
+
 
+
<nowiki>$bepiwikchart = new bepiwikcharts();</nowiki>
+
 
+
<nowiki>echo $bepiwikchart->printChart( "evolution", "VisitsSummary", "week", "previous30", 813, 100, 80, "get", "&colors=,,00ff00" );</nowiki>
+
 
+
<nowiki>?></nowiki>
+
</div>
+

Aktuelle Version vom 4. August 2020, 19:22 Uhr


Erweiterungs-Übersicht
Name des Entwicklers maTh
Entwickler Webseite https://github.com/mathContao/be_piwikcharts
Version der Erweiterung 1.4.X
Kompatibilität mit Contao Version 2.9.0 - 3.3.4
Link zum Extension Repository http://contao.org/de/extension-list/view/be_piwikcharts.html
Link zum Tracker https://community.contao.org/de/showthread.php?34266-be_piwikcharts-Besucherstatistiken-aus-Piwik-im-Backend-anzeigen
Anmerkung English translation also available. See International Contao Forum: https://community.contao.org/en/showthread.php?22615-be_piwikcharts-Stats-visitors-from-Piwik-shown-in-Contao-Backend


Dokumentation ist auf GitHub umgezogen: https://github.com/mathContao/be_piwikcharts/wiki/

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

Sprachen/Translations

Ansichten
Meine Werkzeuge

Contao Community Documentation

Dann sollte da auch 3.1.5 stehen. Wenn nicht mach mal Systemwartung, dreh dich im Kreis, ruf: "uga uga uga" und opfer ein kleines huhn... aber nur ein KLEINES, ist ja kein major.

Marc Reimann
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge