Tracking Plugin

Table of Contents Plugin

Plugins

Utilities Plugin

This plug-in contains macros for anonymously tracking content access.

Details

Versions of this plugin prior to 2.2 require the appropriate Utilities Plugin to be installed into WEB-INF/lib.

This plug-in contains macros for anonymously tracking content access.

Otherwise known as 'hit counting', this macro provides the ability to count the number of times a given piece of content has been viewed. It does not count views by the most recent editor of the page.

Please note that this is not currently intended to be a fully-fledged statistics package. Check out the Traffic Stats Plugin page, which is attempting to collect information about what kind of statistics would be useful to people.

The tracking plugin also only counts visits from the time that the plugin is installed. It has no way to retrieve historical data.

Note
The view count will not increase when the page is viewed by the most recent editor of the page. This is to prevent the count from being artificially inflated by the editor doing edits or responding to comments, etc. To see the count go up, just log out, or log in as another user.

Overview

Name	Tracking Plugin
Vendor	CustomWare Asia Pacific (Website)
Authors	David Peterson
Homepage	http://www.customware.net/repository/display/AtlassianPlugins/Tracking+Plugin
Issue Management	http://jira.adaptavist.com/browse/TRACK
Continuous Integration	n/a
Categories	Admin Macros
Most Recent Version	2.4.1
Availability	Confluence v2.3 to v3.0.0_01
State	Stable
Support	By: CustomWare Website: http://www.customware.net/repository/display/CustomWare/Atlassian+Professional+Services
License	Freeware / Open Source (BSD)
Price	Free
Release Docs	http://www.customware.net/repository/display/AtlassianPlugins/Tracking+Plugin
Java API Docs	n/a
Download Source	http://svn.atlassian.com/svn/public/contrib/confluence/tracking-plugin/tags/2.4.1/
Download JAR	tracking-plugin-2.4.1.jar

Bugs & Feature Requests

Bug reports and feature requests are available in JIRA.

Release History

You can view the full release history here.

Tip
You can also use the Reporting Plugin to display and filter based on tracking data, via the Tracking Data Supplier.

To view the macro's documentation, click on its name below.

{tracking-column}

Describes a column of data in a tracking-table. more info...

{tracking-info}

This macro outputs tracking information about the current (or any other) page, including the number of times it has been viewed, the first view date and the last view date. more info...

{tracking-table}

This macro outputs a table of tracking data for a specified set of content (pages, news, attachments, etc). more info...

Suppliers provide information which can be used by the Reporting Plugin.

Tracking Data Supplier

Provides information from the Tracking Plugin regarding content view counts. more info...

Below are listed some recipes which make use of this plugin. They are often good examples of how it can be used in real-world situations.

Pie chart of page visits recipe

Create a pie chart displaying the number of visits to pages. more info...

For information on installing the plugins once you've downloaded them, see these instructions.

Confluence 2.8+

Plugin Package:	tracking-plugin-2.4.1.jar (1413 downloads)
Source Code:	Subversion

Note
This version is only compatible with Reporting 3.0.0 or newer. If you are using older versions of Reporting, stay with Tracking 2.3.1.

Confluence 2.3

Plugin Package:	tracking-plugin-2.3.1.jar (2351 downloads)
Source Code:	Subversion

Confluence 2.2

Plugin Package:	tracking-plugin-2.2.2a.jar (663 downloads)
Source Code:	Subversion

Note

This plugin no longer depends on the Utilities Plugin being installed.
The {content-info} plugin has been renamed to {tracking-info}. The old name will work for this version but beyond that it may be removed. Please update your references.
The 'value' parameters have been changed to more human-readable options (eg. 'view count' instead of 'viewCount'). Check the macro documentation for details.

Confluence 1.4.4+/2.0/2.1

On high load sites, this plugin leads to space bandana corruption (theme selection loss, logo loss in particular). Not recommended for public sites or intranets with over 500 active users.

Plugin Package:	tracking-plugin-1.4.3.jar (355 downloads)
Source Code:	Subversion

Note

This plugin requires at least version 1.4.6/2.0.0/2.1.0 (depending on your version of Confluence) of the Utilities Plugin to be installed.
The filename of the plugin has changed since 1.4.2. The old filename is 'plugins-tracking-1.4.jar', which should be removed before installing the new version.