Wikimore

**MediaWiki extensions manual**
MatomoAnalytics; Release status: stableCategory:Stable extensions
Implementation	Special pageCategory:Special page extensions, User activityCategory:User activity extensions
Description	Integration with Matomo for analytics. Adds a special page to view that stats on-wiki.
Author(s)	John Lewis, Southparkfan, Universal Omega, Agent Isai
Maintainer(s)	Miraheze system administrators
Latest version	continuous updates
Compatibility policy	Main branch maintains backward compatibility.Category:Extensions with master compatibility policy
MediaWiki	>= 1.43.0
PHP	7.2+
Database changes	No, Yes if $wgMatomoAnalyticsUseDB is enabled
Composer	miraheze/matomo-analytics
Virtual domain	virtual-matomoanalytics
	Tables matomo;
	Parameters $wgMatomoAnalyticsEnableCustomDimensionsUserType; $wgMatomoAnalyticsForceGetRequest; $wgMatomoAnalyticsDisableCookie; $wgMatomoAnalyticsSiteID; $wgMatomoAnalyticsUseDB; $wgMatomoAnalyticsTokenAuth; $wgMatomoAnalyticsDisableJS; $wgMatomoAnalyticsGlobalID; $wgMatomoAnalyticsServerURL;
	Added rights noanalytics; viewanalytics;
	Hooks used CreateWikiCreationCategory:CreateWikiCreation extensions; CreateWikiDeletionCategory:CreateWikiDeletion extensions; CreateWikiRenameCategory:CreateWikiRename extensions; InfoActionCategory:InfoAction extensions; LoadExtensionSchemaUpdatesCategory:LoadExtensionSchemaUpdates extensions; SkinAfterBottomScriptsCategory:SkinAfterBottomScripts extensions;
Licence	GNU General Public License 3.0 or later
Download	GitHub: project page; git repository URL; commit history; ; Category:Extensions in GitHub version control

Category:Extensions supporting Composer Category:GPL licensed extensionsCategory:All extensions

The MatomoAnalytics extension inserts tracking code for the Matomo analytics platform. It also creates a Special Page (Special:Analytics) where you can view the stats on-wiki.

For reporting an issue or a bug, please use Miraheze Phabricator. See here for the workboard.

Installation

Download and place the file(s) in a directory called MatomoAnalytics in your extensions/ folder.
Add the following code at the bottom of your LocalSettings.php file:
```
wfLoadExtension( 'MatomoAnalytics' );
```
Configure as required.
Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration

parameter	default	comment	required?
`$wgMatomoAnalyticsServerURL`	`""`	URL of your Matomo installation It is important that the whole URL is used with protocol and trailing slash: `http://example.org/`	Required
`$wgMatomoAnalyticsTokenAuth`	`""`	The auth token for the API of your Matomo install	Required
`$wgMatomoAnalyticsSiteID`	`1`	Matomo site ID	Optional
`$wgMatomoAnalyticsGlobalID`	`0`	Shared Matomo site ID. For use on wikifarms.	Optional
`$wgMatomoAnalyticsUseDB`	`false`	Whether to use a database or not. For use on wikifarms.	Optional
`$wgMatomoAnalyticsForceGetRequest`	`false`	Whether or not you want to force GET requests which also disables beacon. Reverts back to Matomo v3 tracking behavior.	Optional
`$wgMatomoAnalyticsEnableCustomDimensionsUserType`	`false`	Whether to fetch `userType` in Matomo using CustomDimensions. You must set up CustomDimensions to be able to use this.	Optional
`$wgMatomoAnalyticsDisableCookie`	`false`	Allow disabling cookies set by Matomo.	Optional
`$wgMatomoAnalyticsDisableJS`	`false`	Allow disabling of JS tracking code globally	Optional

Matomo API token

To obtain a Matomo API token from your Matomo installation, you can follow the official documentation:

https://matomo.org/faq/general/faq_114/

Wikimore

Extension:MatomoAnalytics

Installation

Configuration

Matomo API token

See also