This plug-in contains macros for anonymously tracking content access.
| 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 v2.10 |
| State | Stable |
| Support |
|
| 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 |
| This plugin can be installed and updated via the Confluence Repository Client. |
Description/Features
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.
Contains the following macros:
- {content-info} (deprecated)
- {tracking-info}
- {tracking-table}
- {tracking-column}
| For more information, visit this plugin's homepage |
Version History
Confluence 2.3 and newer
| Version | Date | State | License | Price |
|
|
29 Aug 2008 | Stable | Freeware / Open Source (BSD) | Free |
|
|
30 Apr 2007 | Stable | Freeware / Open Source (BSD) | Free |
|
|
01 Mar 2007 | Stable | Freeware / Open Source (BSD) | Free |
Confluence 2.2 and older
| Version | Date | State | License | Price |
|
|
29 Aug 2008 | Stable | Freeware / Open Source (BSD) | Free |
|
|
30 Apr 2007 | Stable | Freeware / Open Source (BSD) | Free |
|
|
01 Mar 2007 | Stable | Freeware / Open Source (BSD) | Free |
See Also
- Page Information Plugin ({page-info} and {version-info} macros)
- Confluence Usage Tracking Plugin


Comments (14)
Oct 03, 2005
Bob Swift says:
This counts the hits from when? How do I reset the count? Thanks for providing t...This counts the hits from when? How do I reset the count? Thanks for providing this.
Oct 03, 2005
David Peterson [CustomWare] says:
Yeah, I'm lacking a little detail on that aren't I. Sorry about that. All pages...Yeah, I'm lacking a little detail on that aren't I. Sorry about that.
All pages and attachment hits are counted from as soon as you install the plugin into Confluence. The {view-count} macro simply outputs the recorded value.
Actually, another thing is that since the count is incremented after the page is viewed, the number displayed will not count your own view of the page.
I'll update the docs to reflect that info.
Oct 07, 2005
David Peterson [CustomWare] says:
Oh, and there currently isn't any way to reset the count. That would probably ne...Oh, and there currently isn't any way to reset the count. That would probably need an XWork action. I'll add it as a 'todo' item, but it won't be in the next release.
Dec 22, 2006
Bill Richard says:
I have a page with 3 instances of tracking-table/tracking-column. When the page...I have a page with 3 instances of tracking-table/tracking-column.
When the page is located in my personal space, it takes less than 1 second to render.
When the page is located in a global space, it takes over 6 seconds to render.
Both spaces have similar amount of pages (<50).
Any ideas?
Thanks, Bill
Dec 22, 2006
David Peterson [CustomWare] says:
That does seem odd. The macros themselves are certainly doing nothing different ...That does seem odd. The macros themselves are certainly doing nothing different between the two types of spaces. Some possibilities are that the global space has more content of other types (attachments, news items, etc). When it filters out pages it runs through all content checking if its appropriate. There is certainly some room for optimisation there.
Alternately, perhaps it has more historical versions of pages, although that's less likely, since I'm pretty sure historical versions don't get checked.
Jan 23, 2007
senthilraja says:
Hi, When i installed this plugin in confluence 2.2 I am getting the following e...Hi,
When i installed this plugin in confluence 2.2 I am getting the following error.
Tracking Plugin
Vendor: randombits.org
Plugin Version: 2.2.2a
This plug-in allows pages to track the number of times a page or attachment is viewed. Note: contains the 'Odometer' counter images created by Heini Withagen.
content-info
Outputs information about the content. Deprecated.
Error:There was a problem loading the descriptor for module 'macro' in plugin 'Tracking Plugin'
Jan 24, 2007
David Peterson [CustomWare] says:
As is noted in the description above, 2.2.2a will only work with Confluence 2.2....As is noted in the description above, 2.2.2a will only work with Confluence 2.2.1a or later. Which version of Confluence 2.2 are you using?
Apr 30, 2007
Christoph Gerstle says:
Hi! Is it planned to provide caching functionality for the tracking-table m...Hi!
Is it planned to provide caching functionality for the tracking-table macro?
i.e.
(tracking-table:
spaces=(+/-)[@all|@global|@personal|@favorite|KEY]
|scope=(+/-)[KEY:]Page > [children|decendents|ancestors]
|labels=(+/-)label
|types=(+/-)[space|page|news|attachment]
|sort=[natural title|exact title|space key|space name|creation date|modification date|view count|first view date|last view date] (asc/desc)
|maxResults=X
|loadfromcachetime=86400
)
(tracking-table)
loachfromcachetime would mean that only if the amount of given time since creation/update is passed (i.e. 86400s = 24h) the operation is executed against the database again. Else the old result is just read out of the database...
This would be great when you have many tracking-tables in your standard page...
Christoph
Apr 30, 2007
David Peterson [CustomWare] says:
Caching is definitely a good idea, however you can already achieve it by simply ...Caching is definitely a good idea, however you can already achieve it by simply putting the Caching macro around the tracking table - in fact I do that on this very site (see [Summary] for an example).
Jun 14, 2007
Rohan says:
Hi , Is there a macro which gives count of the number of unique users who have ...Hi ,
Is there a macro which gives count of the number of unique users who have visited a particular page . The current tracking macro increments the view count for the page refreshes and even if the same user visits the same given page again during a day span , the view count is incremented for the page . If someone can tell me how can I get view count of unique visitors , it would be really nice.
Thanks,
Rohan
Feb 01, 2008
Sasan MAHDIAN says:
Hi, Do you know if this plug-in supports cluster serves? ThanksHi, Do you know if this plug-in supports cluster serves?
Thanks
Feb 01, 2008
David Peterson [CustomWare] says:
Not having a clustered environment around to test on, I can't say. However, nobo...Not having a clustered environment around to test on, I can't say. However, nobody has reported any errors with it so far.
Feb 13, 2008
Guerry Semones says:
All right, newbie here. I want to track the download of some file attachments. ...All right, newbie here.
I want to track the download of some file attachments.
Here is my scenario. I have a file foo.zip attached to a page in a space. I added my tracking-table to that page.
I've clicked the foo.zip attachment, and downloaded it using the links on that page, as well as links directly to foo.zip from other pages. The statistics for the file never change or update.
I've logged out and logged back in to make sure the "most recent editor" thing doesn't cause a problem.
Ideas? Am I missing something? I do see stats in the tracking table for some images, etc.
Thanks,
Guerry
Nov 30
Shakthi says:
Does the Confluence space or the site statistics increment the hi...Does the Confluence space or the site statistics increment the hit count when an attachment is accessed directly rather than the page being clicked first?
If no, Is there any way by which the hit count can get incremented even when the attachment is viewed directly?
Thanks,