---

Dieses Projekt wird nicht weiter gepflegt.
Falls du es übernehmen und weiterentwickeln möchtest, gib uns gerne bescheid!

---

.

Github-Hinweis: Beim Download von Github bitte daran denken, das entpackte Verzeichnis umzubenennen in decaf_piwik_tracker (statt redaxo_piwik_tracker)!

Piwik Tracker 1.5pre

• Fügt den Tracking-Code in die Website ein, wahlweise als JavaScript-Schnipsel oder PHP-include.
  Kann ab v1.4 deaktiviert werden, wenn der Tracking-Code manuell eingebracht werden soll.
• Zeigt eine grafische Statistik im REDAXO-Backend, die erstmal aufs Wesentliche reduziert ist (Besucher der letzten 14 Tage), aber recht frei konfiguriert werden kann.
• Bringt einen Direktlink auf die Piwik-Installation mit automatischem Login (optional).
• Zählt keine REDAXO-Redakteure mit. Auch nicht nach Ablauf der Sitzung (Cookie).

---

Instructions (English only)

• Adds the tracking code to the website, either as JavaScript snippet or PHP include.
  Can be disabled from v1.4 if tracking code wants to be added manually.
• Shows graphical statistics on the REDAXO backend being focused on essential output per default (last 14 days’ visits) but also being quite configurable.
• Adds a direct link on your Piwik installation with an auto login feature (optional).
• Does not track REDAXO authors. Either when session has ended (cookie).

Requirements:

• Piwik Server (any version)
• PHP 5.2+
• REDAXO 4.1+
• If you want to track your visitors using PHP-Code and display the statistics in REDAXO allow_url_fopen needs to be turned on.

For more information on Piwik visit http://piwik.org. They have good documentation how to setup the statistics server.

Installation note for REDAXO 4.1 users:

If you want to use this addon with REDAXO 4.1 you will need to manually create the folder /files/addons/decaf_piwik_tracker/ and copy everything from /redaxo/include/addons/decaf_piwik_tracker/files/ to the newly created folder.

Configuration

Once the addon is installed you need to configure some parameters on the configuration page.

• Tracker URL: The URL to your Piwik-Server, no trailing slash please. E.g.: http://stats.your-server.tpl
• Site Id: The ID as shown in Piwik under [Settings » Websites].
• Tracking Method: Choose between Javascript (default) and PHP. The PHP Method is only available if allow_url_fopen is turned on. Javascript has the ability to track more information (e.g. screen sizes), while PHP is more dependable.
• Auth Token: The auth token is required if you want to include stats in the REDAXO backend. It's shown in Piwik under [Settings » Users.]
• Username: Optional parameter. Enables auto login at the Piwik stat server (requires username and password).
• Password: Optional parameter. Enables auto login at the Piwik stat server (requires username and password).

Widget Configuration

To configure what statistics are displayed in the REDAXO backend you need to edit the widgets.ini.php in the config/ folder. You can show multiple widgets by adding entries to the widget.ini.php.

• api_period: The period to display. Can be either day, week, month or year
• api_date: The date range to fetch. Right now only lastX is supportet. To fetch the last 6 weeks use api_date= last6 and api_period = week.
• columns: What columns to display. You can use nb_visits, nb_uniq_visitors and nb_actions. Separate multiple values with commas (,) and no spaces.
• width: The width of the widget. Usually it's 745. If you use smaller values the widgets will be displayed on the same row.
• widget_title: If you want to override the automatic title generation you can set your custom title here.

Changelog

v1.5pre _ t.b.a.

• REX 4.6 compatibility
• Use asynchronous JavaScript tracking (see API reference)
• Update PiwikTracker PHP class from current Piwik 2.6.0
• Slight cleanup

v1.4 _ 22.12.2013

• Auto tracking code can be disabled now if you want to add the tracking code by yourself.
• Update PiwikTracker class from current Piwik 2.0
• Update Raphaël JS component to current 2.1.2
• README, typo, slight cleanup.