This package is abandoned and no longer maintained. The author suggests using the mediawiki/matomo package instead.

The Matomo (ex-Piwik) extension inserts your Matomo tracking code to the bottom of every page.

Installs: 28 552

Dependents: 0

Suggesters: 0

Security: 0

Stars: 15

Watchers: 2

Forks: 13

Open Issues: 4


v3.1.0 2018-02-07 21:53 UTC

This package is not auto-updated.

Last update: 2019-02-19 08:39:42 UTC


MediaWiki Piwik Integration extension
Version 3.1.0
 - Last update: 7 February 2018

This is the README file for the Piwik Integration extension for MediaWiki
software. The extension is only useful if you've got a MediaWiki
installation; it can only be installed by the administrator of the site.

Minimum requirements

1.  MediaWiki 1.25+

2.  A Piwik (0.4+) installation with the site configured

Installation instructions
Please, read them carefully. They're not very difficult to understand,
but **ALL** steps are necessary:

1. Create a folder called "Piwik" in your extensions directory

2. Upload extension.json and Piwik.hooks.php in the "Piwik" folder you've just created

3. Edit your LocalSettings.php and, at the end of the file, add the

        ```wfLoadExtension( 'Piwik' );```

4. Configure the Piwik URL and site-id. To do so; edit the LocalSettings and set up the following variables:
      > $wgPiwikURL = "piwik-host.tld/dir/";

      > $wgPiwikIDSite = "piwik_idsite";

      **IMPORTANT** Do not define the protocol of the $wgPiwikURL

  Note: Change the value of $wgPiwikURL with the URL, without the protocol
	but including the domain name, where you installed Piwik.
	Remember to add the trailing slash!

5. Enjoy our extension!
> Note: to check if the extension has succesfully installed; go to your wiki and check if the Piwik Extension is present on the bottom of the Wiki source code.

Custom variables
* Disable cookies by setting  the ```$wgPiwikDisableCookies``` variable to ```false```.
  > For example: $wgPiwikDsiableCookies = false;

* To define custom javascript tags in the Piwik javascript code, its possible to define the $wgPiwikCustomJS variable. For example if you have a single setting to insert; use the following code:
   > ```$wgPiwikCustomJS = "_paq.push(['trackGoal', '1']);"```

   If you have multiple variables to define; use an array. For example:
>`` $wgPiwikCustomJS = array(
"_paq.push(['setCustomVariable', '1','environment','production']);",
"_paq.push(['setCustomVariable', '1','is_user','yes']);"

* If you want to change the title of your pages inside the Piwik tracker,
  you can set ```$wgPiwikActionName``` inside your LocalSettings.php file.

* In case you want to include the title as, for example,
   "wiki/Title of the page", you can set ```$wgPiwikUsePageTitle``` to
  ```true``` and set ```$wgPiwikActionName``` to ```wiki/```. The extension will print piwik_action_name = 'wiki/Title of the page';

* If you want to track the username of the visitor with the piwik feature User ID (needs Piwik >= 2.7.0) 
  set the ```$wgPiwikTrackUsernames``` to true in LocalSettings.php.