This is an outdated documentation for Viewtracker Version ≤ 3.2.2. With the release of Viewtracker 4.0, this functionality was bundled in a separate add-on:

The Viewtracker Plugin provides supplier support for advanced reporting.

 

Reporting Plugin required!

The features described below require the ServiceRocket Reporting Plugin.

Viewtracker Supplier

Details

NameViewtracker Supplier
Prefixviewtracker (required)
Supported contentPages, Blog Posts, Spaces, Users
Provided byViewtracker Plugin from version 1.1.0

Keys Supported

KeyContent TypesReturn TypeDescription
allAnyList of ViewsReturns the list of all views.
totalviewsAnyTextReturns the total number of views.
totalusersAnyTextReturns the total number of users.
allusersAnyTextAll users: can be rendered afterwards

The key "all" was introduced in version 3.0.0 of the Viewtracker plugin! Leave key blank ("viewtracker:") in older versions of the plugin!

View Supplier

Details

NameView Supplier
Prefixview (optional)
Supported contentTracked Views
Provided byViewtracker Plugin from version 1.1.0

Keys Supported

KeyContent TypesReturn TypeDescription
usernameTracked ViewTextReturns the username.
viewdateTracked ViewDateReturns the date of the last view.
viewcountTracked ViewNumberReturns the total number of views by this user.

Example

Create a report of all pages in a space and display the name of the page, total views, total users and a list of all users:

{report-table}
{content-reporter:types=page}{content-reporter}
{report-column:title=Page}{report-info:title|link=true}{report-column}
{report-column:title=Total Views}{report-info:viewtracker:totalviews}{report-column}
{report-column:title=Total Users}{report-info:viewtracker:totalusers}{report-column}
{report-column:title=Users List}{report-info:viewtracker:allusers|render=wiki}{report-column}
{report-table}

Result

In this example the page "Knowledge" does not contain the viewtracker plugin.

Advanced Examples

Show the last 5 pageviews of all children:

Reporting Plugin 4.x or higher

 {report-table:maxResults=5}
  {expanding-reporter:viewtracker:all|as=view}
    {local-reporter:page:children}
    {date-sort:viewdate|order=descending}
  {expanding-reporter}

  {report-column:title=Date}{report-info:expanded:view > viewdate}{report-column}
  {report-column:title=Page}{report-info:expanded:item|link=true}{report-column}
  {report-column:title=User}{report-info:expanded:view > username|link=true}{report-column}
  {report-empty}_No views tracked._{report-empty}
{report-table}

Reporting Plugin 3.x

{report-table:maxResults=5}
  {expanding-reporter:viewtracker:|as=view}
    {local-reporter:page:children}
    {date-sort:viewdate|order=descending}
  {expanding-reporter}

  {report-column:title=Date}{report-info:expanded:view > viewdate}{report-column}
  {report-column:title=Page}{report-info:expanded:item|link=true}{report-column}
  {report-column:title=User|injected=true}[~%expanded:view > username%]{report-column}
  {report-empty}_No views tracked._{report-empty}
{report-table}

Result

 

Show all pageviews of all spaces (except pageviews by user "admin") since 1 Oct 2010 grouped by user:

Reporting Plugin 4.x or higher

{report-table}
{grouping-reporter:expanded:view > username|as=User}
  {grouping-stats:expanded:view > viewdate|as=Viewdate}
  {expanding-reporter:viewtracker:all|as=view}
    {content-reporter:space=@all}
    {user-filter:username|users=-admin}
    {date-filter:viewdate|minValue=1-Oct-2010|format=dd-MMM-yyyy}
    {text-sort:username}
  {expanding-reporter}
{grouping-reporter}

{report-column:title=User}{report-info:grouped:User|link=true}{report-column}
{report-column:title=Last View}{report-info:grouped:Viewdate > stats:max value}{report-column}
{report-column:title=Pages Viewed}{report-on:@items}{report-info:item|link=true}{report-on}{report-column}

{report-empty}_No views tracked._{report-empty}
{report-table}

Reporting Plugin 3.x

{report-table}
{grouping-reporter:expanded:view > username|as=User}
  {grouping-stats:expanded:view > viewdate|as=Viewdate}
  {expanding-reporter:viewtracker:|as=view}
    {content-reporter:space=@all}
    {user-filter:username|users=-admin}
    {date-filter:viewdate|minValue=1-Oct-2010|format=dd-MMM-yyyy}
    {text-sort:username}
  {expanding-reporter}
{grouping-reporter}

{report-column:title=User|injected=true}[~%grouped:User%]{report-column}
{report-column:title=Last View}{report-info:grouped:Viewdate > stats:max value}{report-column}
{report-column:title=Pages Viewed}{report-info:@items|link=true}{report-column}

{report-empty}_No views tracked._{report-empty}
{report-table}

Result

 

Please note that views of a page are only tracked if the viewtracker macro is on that page.

Labels (0)

  • No labels

Comments  (0)

Attachments  (3)

Add Attachment
  File Modified
PNG File viewtracker-supplier-1.png 03. Mar. 2014 by remo.siegwart@bitvoodoo.ch
PNG File viewtracker-supplier-2.png 03. Mar. 2014 by remo.siegwart@bitvoodoo.ch
PNG File viewtracker-supplier-3.png 03. Mar. 2014 by remo.siegwart@bitvoodoo.ch