Dashboard > Atlassian Plugins > ... > Macros > tracking-info
  Atlassian Plugins Log In | Sign Up   View a printable version of the current page.  
  tracking-info

Added by David Peterson , last edited by David Peterson on Feb 28, 2007  (view change)
Labels: 

{tracking-info}

Plugin: Tracking Plugin

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.

Usage

{tracking-info:[Page/Attachment Name]
   |value=[view count|first view date|last view date]
   |format=[date format]
   |digits=[#]}
Default text
{trackinginfo}

Parameters

Name Required Default Description
[default]
current page
The page/attachment to report on.
value
The value to report. May be one of the following:
  • first view date - The date the content was first viewed by someone other than the creator.
  • last view date - The date the content was last viewed by someone other than the last editor.
  • view count - The number of times the content has been viewed since the 'first view date'.
  • age in days - The number of days between the day the content was created and now.
  • views per day - The average number of views per day since the content was created.
digits
For values returning a number, the minimum number of digits to output.
type
plain text
For values returning a number, the type of image to use for the counter (e.g. "gif", "jpg", etc). If not set, plain text will be output.
images
For values returning a number, the style of image to use if type is not text. Defaults to the built-in 'odometer' style.
format
For values returning a date, the date format (eg. 'dd-MMM-yyyy'). May also be 'long', 'medium' or 'short', which will use the system defaults for those formats.

Viewing the hit count for the current page

Page views can be reported for the current page.

This page has been viewed {tracking-info:value=view count}zero{tracking-info} times.
Viewing the hit count for other pages

Page views can be reported for pages in any visible space.

[Another Page] has been viewed 
{tracking-info:Another Page|value=view count|type=gif}zero{tracking-info} times.
Viewing the hit count for pages in another space

The number of page views for a page in a different space space can be listed also.

[SPACE:Distant Page] has been viewed 
{tracking-info:SPACE:Distant Page|value=view count}zero{tracking-info}
times since {tracking-info:SPACE:Distant Page|value=first view date}
the beginning of time{tracking-info}.
Viewing the total hit count for a space

The total number of hits for a space are retrieved by listing the space key followed by a ':'.

[Another Space|SPACE:] has been viewed {tracking-info:SPACE:|value=view count}zero{tracking-info} times.
Viewing attachment download counts

You can also report the number of times an attachment has been viewed (for images, this includes every time it is displayed on a page).

The [^attachment.ext] has been viewed 
{tracking-info:^attachment.ext|value=view count}zero{tracking-info} times.
The [Another Page^attachment.ext] has been viewed 
{tracking-info:Another Page^attachment.ext|type=gif|value=view count}0{tracking-info} times.

Copyright(c) CustomWare Asia Pacific Pty Ltd
Powered by Atlassian Confluence 2.7.3, the Enterprise Wiki. Bug/feature request - Atlassian news - Contact administrators