Extension:GTag

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
GTag
Release status: stable
Implementation User activity
Description Add Google Analytics tracking to pages
Author(s) Skizzerztalk
Latest version 1.1.0 (2020-07-20)
Compatibility policy master
MediaWiki 1.34+
Database changes No
License MIT License
Download Download latest version
  • $wgGTagAnalyticsId
  • $wgGTagAnonymizeIP
  • $wgGTagHonorDNT
  • $wgGTagTrackSensitivePages
gtag-exempt
Check usage and version matrix.
Issues Open issues · Report a bug

The GTag extension lets you insert the new Google Analytics tracking tag on your MediaWiki site ("gtag.js").

Installation[edit]

  • Download and place the file(s) in a directory called GTag in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'GTag' );
    $wgGTagAnalyticsId = 'UA-xxxxxxxxx-x'; // replace this with your Google Analytics id
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parameters[edit]

$wgGTagAnalyticsId (string)
Google Analytics id, required.
$wgGTagAnonymizeIP (boolean, default false)
If true, anonymize the IP address sent to Google Analytics.
$wgGTagHonorDNT (boolean, default true)
If true, honor "Do Not Track" requests from browsers. If false, ignore such requests.
$wgGTagTrackSensitivePages (boolean, default true)
If true, insert tracking code into sensitive pages such as Special:UserLogin and Special:Preferences. If false, no tracking code is added to these pages.

User rights[edit]

gtag-exempt
Users granted this right will not be tracked by Google Analytics. This can be useful to exempt staff groups from being tracked, to get a better idea of what your end users are doing on the wiki.

See also[edit]

  • Extension:Google Analytics Integration - Provides similar features although it uses a different/older Google Analytics API to perform tracking. The GTag extension makes use of the newer Google Site Tag feature to perform tracking.