-Piwik Addon
+Matomo / Piwik Addon
============
by Tobias Diekershoff and Klaus Weidenbach
-This addon allows you to embed the code necessary for the FLOSS webanalytics
-tool Piwik into the Friendica pages.
+This addon allows you to embed the code necessary for the FLOSS webanalytics tool Matomo (formerly known as Piwik) into the Friendica pages.
Requirements
------------
-To use this addon you need a [piwik](http://piwik.org/) installation.
+To use this addon you need a [Matomo](https://matomo.org/) installation.
Where to find
-------------
-In the Friendica addon git repository `/piwik/piwik.php` and a CSS file for
-styling the opt-out notice.
+In the Friendica addon git repository `/piwik/piwik.php` and a CSS file for styling the opt-out notice.
Configuration
-------------
-The easiest way to configure this addon is by activating the admin panels of
-your ~friendica server and then enter the needed details on the config page
-for the addon.
+The easiest way to configure this addon is by activating the admin panels of your ~friendica server and then enter the needed details on the config page for the addon.
-If you don't want to use the admin panel, you can configure the addon through
-the .htconfig file.
+If you don't want to use the admin panel, you can configure the addon through the `config/local.config.php` file.
-Open the .htconfig.php file and add "piwik" to the list of activated addons.
+Open the `config/node.config.php` file and add "piwik" to the list of activated addons.
- $a->config['system']['addon'] = "piwik, ..."
+ 'addons' => [
+ ...
+ 'piwik' => [
+ admin => true,
+ ],
+ ]
-You have to add 4 more configuration variables for the addon:
+You can change 5 more configuration variables for the addon in the `config/piwik.config.php` file:
- $a->config['piwik']['baseurl'] = 'example.com/piwik/';
- $a->config['piwik']['sideid'] = '1';
- $a->config['piwik']['optout'] = true;
- $a->config['piwik']['async'] = false;
+ return [
+ 'piwik' => [
+ 'baseurl' => 'example.com/piwik/',
+ 'sideid' => 1,
+ 'optout' => true,
+ 'async' => false,
+ 'shortendpoint' => false,
+ ],
+ ];
Configuration fields
---------------------
-* The *baseurl* points to your Piwik installation. Use the absolute path,
-remember trailing slashes but ignore the protocol (http/s) part of the URL.
-* Change the *sideid* parameter to whatever ID you want to use for tracking your
-Friendica installation.
-* The *optout* parameter (true|false) defines whether or
-not a short notice about the utilization of Piwik will be displayed on every
-page of your Friendica site (at the bottom of the page with some spacing to the
-other content). Part of the note is a link that allows the visitor to set an
-_opt-out_ cookie which will prevent visits from that user be tracked by piwik.
-* The *async* parameter (true|false) defines whether or not to use asynchronous
-tracking so pages load (or appear to load) faster.
-
+* The *baseurl* points to your Piwik installation. Use the absolute path, remember trailing slashes but ignore the protocol (http/s) part of the URL.
+* Change the *sideid* parameter to whatever ID you want to use for tracking your Friendica installation.
+* The *optout* parameter (true|false) defines whether or not a short notice about the utilization of Piwik will be displayed on every page of your Friendica site (at the bottom of the page with some spacing to the
+other content). Part of the note is a link that allows the visitor to set an _opt-out_ cookie which will prevent visits from that user be tracked by piwik.
+* The *async* parameter (true|false) defines whether or not to use asynchronous tracking so pages load (or appear to load) faster.
+* The *shortendpoint* parameter (true|false) defines whether or not to use a short path to the tracking script: "/js/" instead of "/piwik.js".
Currently the optional notice states the following:
-> This website is tracked using the Piwik analytics tool. If you do not want
-> that your visits are logged this way you can set a cookie to prevent Piwik
-> from tracking further visits of the site (opt-out).
+> This website is tracked using the Piwik analytics tool. If you do not want that your visits are logged this way you can set a cookie to prevent Piwik from tracking further visits of the site (opt-out).
License
=======
-The _Piwik addon_ is licensed under the [3-clause BSD license][3] see the
-LICENSE file in the addons directory.
+The _Piwik addon_ is licensed under the [3-clause BSD license][3] see the LICENSE file in the addons directory.
[3]: http://opensource.org/licenses/BSD-3-Clause