Confluence Plugins

Viewtracker Plugin

Have you ever wondered, not only how many people visited a Confluence page or blog post you wrote, but also who read it when and how many times? The viewtracker plugin gives you the answers to exactly those questions, because it is more than just a simple visit-counter.

Table of Content

Download History
Issues

Macros


{viewtracker}

Simply place the {viewtracker} macro on a Confluence page or blog post and your counter is ready to go. 


Parameters
ParameterMandatoryDefaultDescription
hidenofalseif true, doesn't display the tracked results on page (useful for "silent" mode in combination with the reporting plugin)
expandablenotrueif false, disables the expansion of the list of tracked views
sortnodateset sort=name to sort the list of tracked views by username
renderusernamesnotrueif false, disables the creation of links to the user profile pages of the users in the list (for performance reasons)
timeframeno–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 timeframe=12 would display all views tracked in the last twelve days). By default all tracked views are displayed.
dateformatno–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.


Examples

Simplest usage:
{viewtracker}


Only display views tracked in the last 10 days:

{viewtracker:timeframe=10}


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

{viewtracker:timeframe=01/01/2000}


or to specify it in a different format:

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



Screenshots


Supplier Support

The viewtracker plugin provides supplier support for advanced reporting. Learn more about the Viewtracker supplier.




{recently-viewed}

Displays pages you have recently visited in Confluence. This history is also available in the Recently Viewed content view from the "User" dropdown. More Information about recently viewed content in Confluence:http://confluence.atlassian.com/display/DOC/Recently+Viewed+Content 


 
Parameters

ParameterMandatoryDefaultDescription
maxResultsno20the maximum number of results to display
hideHeadernofalsetrue/false flag that allows you to hide the header of the table


Examples

Simplest usage:
{recently-viewed}


Only display the last 5 pages visited and hide the header of the table:

{recently-viewed:maxResults=8|hideHeader=true}



Screenshots




Plugin Configuration
In the Confluence Plugin Manager, which is in the Administration Console, you can configure the blocking time option and enable/disable space usage reports:

  1. Click on "Configure"


  2. Edit Viewtracker Configuration


Blocking Time
The blocking time (ms) defines the time period in between the viewtracker macro doesn’t track multiple views per user for the same page.

Space Usage Reports

Space Usage Reports can be enabled to show up in Space Administration. Feel free to override the default template with your custom report. For Space Usage Reports the Reporting Plugin is required.






FAQ

How does the viewtracker macro affect the performance of the Confluence page?

The viewtracker macro affects the performance of the page only if it has a large number of unique (registered) visitors (mainly in large Confluence installations). However, if you experience performance problems, just disable the rendering of the links to the user profile pages (the bottleneck...):


{viewtracker:renderusernames=false} 

 
See this chart of our internal performance tests for more information:




Comments