This server will be upgraded at 3pm Sydney time on December 3rd (December 2nd, 8pm PST) and will be down for up to 30 minutes.

Tracking Plugin

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 Unsupported Plugins
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:

For more information, visit this plugin's homepage

Version History

Confluence 2.3 and newer

Version Date State License Price
Show description 2.4.1 (#9) 29 Aug 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Bug TRACK-30 Major Tracking does not communicate with Reporting after Confluence restart Apr 29, 2007 David Peterson Resolved

Contributors

  • David Peterson — Developer

Show description 2.3.1 (#8) 30 Apr 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Bug TRACK-30 Major Tracking does not communicate with Reporting after Confluence restart Apr 29, 2007 David Peterson Resolved

Contributors

  • David Peterson — Developer

Show description 2.3 (#7) 01 Mar 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Task TRACK-25 Major Switch project to Maven 2 Apr 29, 2007 David Peterson Closed
Bug TRACK-27 Major Confluence 2.3 compatibility Feb 28, 2007 David Peterson Closed

Contributors

  • David Peterson — Developer

Confluence 2.2 and older

Version Date State License Price
Show description 2.4.1 (#9) 29 Aug 2008 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Bug TRACK-30 Major Tracking does not communicate with Reporting after Confluence restart Apr 29, 2007 David Peterson Resolved

Contributors

  • David Peterson — Developer

Show description 2.3.1 (#8) 30 Apr 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Bug TRACK-30 Major Tracking does not communicate with Reporting after Confluence restart Apr 29, 2007 David Peterson Resolved

Contributors

  • David Peterson — Developer

Show description 2.3 (#7) 01 Mar 2007 Stable Freeware / Open Source (BSD) Free

Release Notes

Jira Issues
Type Key Priority Summary Updated Reporter Status
Task TRACK-25 Major Switch project to Maven 2 Apr 29, 2007 David Peterson Closed
Bug TRACK-27 Major Confluence 2.3 compatibility Feb 28, 2007 David Peterson Closed

Contributors

  • David Peterson — Developer

See Also

Labels

plugin plugin Delete
macro macro Delete
confluence14 confluence14 Delete
confluence15 confluence15 Delete
confluence20 confluence20 Delete
confluence21 confluence21 Delete
repository_current repository_current Delete
confluence23 confluence23 Delete
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.
  1. 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.

    1. 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.

      1. 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.

  2. 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

    1. 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.

  3. 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'

    1. 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?

  4. 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



    1. 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).

  5. 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 

  6. Feb 01, 2008

    Sasan MAHDIAN says:

    Hi, Do you know if this plug-in supports cluster serves? Thanks 

    Hi, Do you know if this plug-in supports cluster serves?

    Thanks 

    1. 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.

  7. 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

  8. 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,