README.md
1DokuWiki-matomo
2===============
3
4This is a plugin for DokuWiki (https://www.dokuwiki.org). In integrates a editable tracking code or image into DokuWiki pages to track user actions with Matomo (see https://matomo.org/).
5
6Plugin Data
7===============
8
9Field | Data
10:------------|:--------------------------------------------------------------------------------------
11description | 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.
12author | Bravehartk2 (Marcel Lange)
13email | info@ask-sheldon.de
14type | admin
15lastupdate | 2018-05-19
16compatible | binky, 2014-04-28, Detritus, Elenor of Tsort, Frusterick Manners, Greebo
17conflicts | piwik, piwik2
18similar | googleanalytics
19tags | Tracking, Statistics, Piwik, Google Analytics alternativ
20downloadurl | https://github.com/Bravehartk2/dokuwiki-matomo/tarball/master
21bugtracker | https://github.com/Bravehartk2/dokuwiki-matomo/issues
22sourcerepo | https://github.com/Bravehartk2/dokuwiki-matomo
23
24Description
25===============
26Plugin 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.
27(inspired by the piwik plugin from Heikki Hokkanen <hoxu@users.sf.net>, https://www.dokuwiki.org/plugin:piwik)
28
29Installation
30===============
31Just install the plugin using the PluginManager(https://www.dokuwiki.org/plugin:plugin) or download it from the github account mentioned above.
32
33Or you can clone it directly from repository:
34```bash
35$> cd dokuwiki/lib/plugins/
36$> git clone https://github.com/Bravehartk2/dokuwiki-matomo
37```
38
39External requirements
40===============
41
42This plugin requires the following additional components that must be installed separately:
43
44 * MySQL Database for Matomo
45 * PHP with mysql support (now PHP7 ready)
46 * an existing matomo installation that the matomo trackingscript can send data to
47
48Install 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.
49
50Configuration
51===============
52 - Go to Plugin Management and make sure “matomo” is enabled
53 - 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)
54 - Matomo plugin should now be enabled and you should see the trackingcode in the rendered html on wiki pages (f.e. with firebug)
55