Extension:Google Analytics Integration

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg
Google Analytics Integration

Release status:Extension status stable

ImplementationTemplate:Extension#type User activity
DescriptionTemplate:Extension#description Automatically inserts Google Universal Analytics (and/or other web analytics) tracking code at the bottom of MediaWiki pages
Author(s)Template:Extension#username Tim Laqua, Dāvis Mošenkovs
Latest versionTemplate:Extension#version 3.0.1 (2017-10-29)
MediaWikiTemplate:Extension#mediawiki 1.23+
PHPTemplate:Extension#php 5.3+
Database changesTemplate:Extension#needs-updatephp No
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
ExampleTemplate:Extension#example Projects by Davis Mosenkovs (view page source at the bottom)
  • $wgGoogleAnalyticsAccount
  • $wgGoogleAnalyticsOtherCode
  • $wgGoogleAnalyticsAnonymizeIP
  • $wgGoogleAnalyticsIgnoreNsIDs
  • $wgGoogleAnalyticsIgnorePages
  • $wgGoogleAnalyticsIgnoreSpecials
Added rightsTemplate:Extension#rights
  • noanalytics
Hooks usedTemplate:Extension#hook

Translate the Google Analytics Integration extension

Check usage and version matrix.

The Google Analytics Integration extension inserts Google Universal Analytics (and/or other web analytics) tracking code in every page viewed. Exclusion of specific pages, namespaces, special pages and all pages for specific groups of users is configurable.

This extension may be outdated for your needs. If you are using the new Global Site Tag for Google Analytics, try using Extension:HeadScript instead.


  • Download and place the file(s) in a directory called googleAnalytics in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/googleAnalytics/googleAnalytics.php";
    // Replace xxxxxxx-x with YOUR GoogleAnalytics UA number
    $wgGoogleAnalyticsAccount = 'UA-xxxxxxx-x'; 
    // Add HTML code for any additional web analytics (can be used alone or with $wgGoogleAnalyticsAccount)
    $wgGoogleAnalyticsOtherCode = '<script type="text/javascript" src="https://analytics.example.com/tracking.js"></script>';
    // Optional configuration (for defaults see googleAnalytics.php)
    // Store full IP address in Google Universal Analytics (see https://support.google.com/analytics/answer/2763052?hl=en for details)
    $wgGoogleAnalyticsAnonymizeIP = false; 
    // Array with NUMERIC namespace IDs where web analytics code should NOT be included.
    $wgGoogleAnalyticsIgnoreNsIDs = array(500);
    // Array with page names (see magic word Extension:Google Analytics Integration) where web analytics code should NOT be included.
    $wgGoogleAnalyticsIgnorePages = array('ArticleX', 'Foo:Bar');
    // Array with special pages where web analytics code should NOT be included.
    $wgGoogleAnalyticsIgnoreSpecials = array( 'Userlogin', 'Userlogout', 'Preferences', 'ChangePassword', 'OATH');
    // Use 'noanalytics' permission to exclude specific user groups from web analytics, e.g.
    $wgGroupPermissions['sysop']['noanalytics'] = true;
    $wgGroupPermissions['bot']['noanalytics'] = true;
    // To exclude all logged in users give 'noanalytics' permission to 'user' group, i.e.
    $wgGroupPermissions['user']['noanalytics'] = true;
  • YesY Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
The following options were removed in version 3.0.0:
  • $wgGoogleAnalyticsAddASAC
  • $wgGoogleAnalyticsIgnoreSysops
  • $wgGoogleAnalyticsIgnoreBots


  1. Create a Google Analytics account
  2. Locate your UA number
    • For the legacy code block, it can be found on the following line:
    • For the new ga.js code block, it can be found on the following line:
      var pageTracker = _gat._getTracker("UA-xxxxxxx-x");
  3. Follow Installation Instructions
  4. Google Analytics stats should start populating within 24-48 hours.

See also[edit]

Other languages:Project:Language policy English  • русский