====== Matomo Plugin ======

---- plugin ----
description  : Plugin for the new 3.x version of Matomo (formerly Piwik), the open source Google Analytics alternative. It's the followup version of https://www.dokuwiki.org/plugin:piwik2.
author       : Bravehartk2 (Marcel Lange)
email        : info@ask-sheldon.de
type         : admin
lastupdate   : 2018-05-19
compatible   : binky, 2014-04-28, Detritus, Elenor of Tsort, Frusterick Manners, Greebo
conflicts    : piwik, piwik2
similar      : googleanalytics
tags         : Tracking, Statistics, Piwik, Analytics
downloadurl  : https://github.com/Bravehartk2/dokuwiki-matomo/tarball/master
bugtracker   : https://github.com/Bravehartk2/dokuwiki-matomo/issues
sourcerepo   : https://github.com/Bravehartk2/dokuwiki-matomo
----

==== Description ====
Plugin for the new 3.x version of Matomo (formaly Piwik), the open source Google Analytics alternative. It's the followup version of https://www.dokuwiki.org/plugin:piwik2. 
(inspired by the piwik plugin from Heikki Hokkanen <hoxu@users.sf.net>, https://www.dokuwiki.org/plugin:piwik)

==== Installation ====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

Or you can clone it directly from repository:
<code bash>
$> cd dokuwiki/lib/plugins/
$> git clone https://github.com/Bravehartk2/dokuwiki-matomo
</code>

==== External requirements ====
This plugin requires the following additional components that must be installed separately:

  * MySQL Database for Matomo
  * PHP with mysql support (now PHP7 ready)
  * an existing matomo installation that the Matomo trackingscript can send data to

Install the plugin using the Plugin Manager (https://www.dokuwiki.org/plugin:plugin) and the download URL above, which points to latest version of the plugin. Refer to https://www.dokuwiki.org/plugin on how to install plugins manually.

==== Configuration ====
  - Go to Plugin Management and make sure “matomo” is enabled
  - Configure the plugin in ***Admin -> Configuration Manager –> Plugin Settings –> Matomo*** (Values partly have to be taken from an existing matomo installation -> From ***Settings -> Tracking Code***, more information https://developer.matomo.org/api-reference/tracking-javascript)
  - Matomo plugin should now be enabled and you should see the trackingcode in the rendered html on wiki pages (f.e. with firebug)