Viewtracker Macro

 


Overview

Gain valuable insight into who is visiting your Confluence pages. The Viewtracker macro provides more information than just counting page hits. It provides important user behaviour details: Who has viewed the current Confluence page, and how often has the page has been visited? The info is displayed in a collapsed version that can be opened by clicking on the arrow sign.

Use the Viewtracker macro to track page views per users if Auto Tracking is disabled. This creates a table showing who viewed the page, when and how many times in total.

 


 

Screenshots

 



Parameters of the Macro

 

Name

Description

Type

This is a required field

Default

Values

Name

Description

Type

This is a required field

Default

Values

Hide
hide

Allows you to hide the tracked results.

boolean

false



Expandable
expandable

Enables the expansion of the list. If the Extended Privacy Mode is activated or the data is hidden from the user, the Viewtracker macro is not expandable.

boolean

true



Render User Names
renderusernames

Enables the creation of links to user profile pages in the list. Disable for better performance.

boolean

true



Sort
sort

Sorts the list by date or name.

enum

date

date, name

Time frame
timeframe

Specifies the time frame for displaying the tracked data. The time frame can either be a specific date or the number of days (for example: 12 would display all elements tracked in the last twelve days). By default, all tracked elements are displayed.

string





Date format
dateformat

Define the format of the date specified in timeframe if it is in a different format than the default Confluence format (defined in the formatting/international settings). Specify a format that matches the simple date format.

string



 

 


 

Examples

Simply place the Viewtracker macro on a Confluence page or blog post and your counter is ready to go:

1 {viewtracker}

Only display views tracked in the last 10 days:

1 {viewtracker:timeframe=10}

Only display views tracked after 01/01/2000 (if MM/dd/yyyy is your default format in Confluence):

1 {viewtracker:timeframe=01/01/2000}

or to specify it in a different format:

1 {viewtracker:timeframe=01.01.2000|dateformat=dd.MM.yyyy}