Extension:Google Analytics Links

From MediaWiki.org

Jump to: navigation, search

         

Manual on MediaWiki Extensions
List of MediaWiki Extensions
Crystal Clear action run.png
Google Analytics Links

Release status: stable
Implementation  Tag, User activity
Description Enable outbound and file link tracking
Author(s)  Nik Molnar
Last Version  1.2 (16-April-2007)
MediaWiki  1.5. X
License No license specified
Download see below

check usage (experimental)

This extension provides a Wiki solution for the two questions posted here and here.
Use Extension talk:Google Analytics Links for feedback

Contents

[edit] Syntax

Note: the third parameter is optional (the one starting with the last "|" and ending just before the "</")

<googa>http://whatever.com/whatever/|Pretty Link Name|/fake/analytic/path</googa>
<googa>/local/link.xyz|Pretty Link Name|/fake/analytic/path</googa>

[edit] Requirements

For this extension to function, it requires that another extension be installed first that includes urchin.js from google:

Note: If you already have the other version installed, you must uninstall it first!

The extension found over on free.fr titled MediawikiEtGoogleAnalytics is using a deprecated function:

if (!$wgUser->isSysop()) {

isSysop() has been deprecated and should be changed to the following

if (!$wgUser->isAllowed('protect')) {

[edit] Code

<?php
 
/*
	Google Analytics Links - v1.2
	(c)2007 Nik Molnar (nik.molnar@gmail.com)
	Distributed UNDER THE TERMS OF GNU GPL Licence.
 
	This extension allows you to easily make use of Google Analytics to track non-HTML files (PDF, AVI, etc.) via JavaScript.
	For more information: http://www.google.com/support/analytics/bin/answer.py?answer=27242
 
	Usage: (third parameter optional)
		<googa>http://yoursite.com/therealfile.pdf|Link Name|/google/friendly/path</googa>
		<googa>/local/path/file.ext|Link Name|/google/friendly/path</googa>
		<googa>http://external.com/whatever.html|Link Name|/google/friendly/path</googa>
	Output: <a href="http://yoursite.com/therealfile.pdf" onClick="javascript:urchinTracker('/google/friendly/path')">Link Name</a>
*/
 
$wgExtensionCredits['parserhook'][] = array(
        'name' => 'Google Analytics Links',
        'author' => 'Nik Molnar',
        'url' => 'http://www.mediawiki.org/wiki/Extension:Google_Analytics_Links',
        'description' => 'Allows you to easily make use of Google Analytics to track non-HTML files.',
);
 
$wgExtensionFunctions[] = "wfGAnalyticsExtension";
 
//Register the hook
function wfGAnalyticsExtension() {
	global $wgParser;
	$wgParser->setHook("googa", "renderGAnalytics");
}
 
//Render function
function renderGAnalytics($input) {
	//Pase the arguments
	$args = split("[|]", $input);
 
	//If 3rd argument is absent, use the 1st argument.
	if(!isset($args[2])) { $args[2] = $args[0]; }
 
	//Return the rendered output
	return
		"<a href=\"" . $args[0] .
		"\" class=\"external text\"" .
		" title=\"" . $args[0] . "\"" .
		" onClick=\"javascript:urchinTracker('" . $args[2] .
		"');\">" . $args[1] .
		"</a>";
}

[edit] Installation

  1. copy the above code to a new text file called googa.php
  2. place that file in your /wiki/extensions/ folder
  3. edit your LocalSettings.php file
  4. After the existing line: $googleAnalytics = "UA-xxxxxxx-1"; insert this line:
//Google Analytics Links Extension http://www.mediawiki.org/wiki/Extension:Google_Analytics_Links
require_once("extensions/googa.php");

[edit] Examples

See examples of this extension in action at these fine wikis:
kJams

[edit] Related extensions

Retrieved from "http://www.mediawiki.org/wiki/Extension:Google_Analytics_Links"