Extension:Matomo(Redirected from Extension:Piwik Integration)
Release status: stable
|Description||Inserts Matomo script into pages for tracking|
|Latest version||4.0.0 (2019-02-15)|
|License||GNU General Public License 2.0 or later|
|Translate the Matomo extension if it is available at translatewiki.net|
|Check usage and version matrix.|
The Matomo extension (formerly "Piwik Integration") inserts your Matomo (formerly Piwik) tracking code to the bottom of every page. It can exclude the views of the users with 'bot' privileges (bots) and the 'protect' privileges (sysops).
This exension is based on extension Google Analytics Integration by Tim Laqua.
|Warning:||This extension is being renamed in February 2019 given Piwik/Matomo changed its name on January 2018 (more explanations). The following changes are done or are pending:
- MediaWiki 1.25+ (tested up to MediaWiki 1.30)
- Matomo 0.4+ with the site configured
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php:
wfLoadExtension( 'Matomo' );
- Configure the Matomo URL and site-id by setting up the following variables below this extension's call:
$wgMatomoURL = "piwik-host.tld/dir"; $wgMatomoIDSite = "piwik_idsite";
Make sure to set
$wgMatomoIDSite to the ID of your site in Matomo. For the first site, this ID will usually be "1". In Matomo, click on the "Administration" link in the top menu and go to the "Websites" page. In this page you will find the list of all websites. The website ID is on the left of this table listing all websites.
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
To users running MediaWiki 1.24 or earlier:
The instructions above describe the new way of installing this extension using
wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of
wfLoadExtension( 'Matomo' );, you need to use:
Disable cookies by setting the
$wgMatomoDisableCookies variable to
true. For example:
$wgMatomoDisableCookies = true;
$wgMatomoCustomJS = "_paq.push(['trackGoal', '1']);";
If you have multiple variables to define; use an array. For example:
$wgMatomoCustomJS = 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 Matomo tracker, set
$wgMatomoActionName inside your LocalSettings.php file.
In case you want to include the title as, for example, "wiki/Title of the page", you can set
true and set
wiki/. The extension will print piwik_action_name = 'wiki/Title of the page';
$wgMatomoIgnoreSysops to false you can enable Matomo to also count page hits done by MediaWiki users who have the "protect" user right. By default, sysop users have this right and so - by default - their page hits are not counted. Default: $wgMatomoIgnoreSysops = true.
$wgMatomoIgnoreBots to false, you can enable Matomo to also count page hits done by MediaWiki users who have the bot right. By default their page hits are not counted. Default: $wgMatomoIgnoreBots = true.
$wgMatomoProtocol with one of the following values: 'http', 'https', 'auto' (automatically set the protocol depending on the protocol used by the wiki).
If you have Matomo 2.7.0 or greater, you can set
$wgMatomoTrackUsernames if you want to save the username of logged-in users in Matomo.
If you use a CDN to distribute the file "piwik.js", you need the version incorporating this pull request (2.4.3+) and you can set
$wgMatomoJSFileURL = 'assets.example.org/piwik.js'; (do not write the protocol "http://" or "https://", it is automatically added); the parameter
$wgMatomoURL must still be configured with the Matomo server collecting analytics.
Tracking with MobileFrontendEdit
For those desiring to track across both views, comment or delete the Matomo entries in
LocalSettings.php and add to the file:
$wgUseSiteJS = true;
Then paste the Matomo tracking code generated in the Matomo dashboard into http://www.example.com/wiki/MediaWiki:Common.js. Matomo will now track users in both Desktop view and Mobile view. Take care: This workaround currently breaks the VisualEditor Extension. (2015-10-01)
Matomo configuration optimized for MediaWikiEdit
This can also be slightly improved by setting the two parameters:
- "Query parameter" = "search": this will remove some false positives compared to the default value;
- "Category parameter" = "profile": Matomo will recognize as search category the profile on top of the MediaWiki search page.
This can be either as global parameters in Administration > Websites > Settings > Tracking Internal Site Search, but preferably in the site-specific configuration in Administration > Websites > Manage > [your wiki] > Edit and uncheck "Use default Site Search parameters" and fill the paremters.