pageactivity macro

Overview

The pageactivity macro displays a workflow "Activity Report" directly within wiki content.

The report is similar to what you see when you access the Activity Report from the workflow popup.

When using Same-space publishing, only the entries up to the most recently published version of content will be shown.

Where to use it?

Optional.

One or more pageactivity macros can be used in the following locations:

Permissions

When used on a page without a workflow, all users can see the report (it will list page creation, edits, etc).

When used on a page with an unrestricted workflow (which does not define any final=true states), all users will be able to see the report.

When used on a page with a workflow which uses Same-space publishing (one which defines a final=true state):

  • Edit/Admin users will see the full report
  • View only users will only see entries up to the point at which the most recent published (final=true) state was entered
  • If the page has not yet reached a published state, view-only users won't be able to view the page or the report

Parameters

Parameter

Required

Default

Notes

maxentries


all entries shown

Maximum number of entries to show

ascending
false

Which order should the entries be shown in?

  • true – oldest → newest
  • false – newest → oldest

Example

The following adds a page activity report with the five most recent entries.

{pageactivity:maxentries=5}

Or use the macro editor:

o

On the page, this displays a chronological list of the page activity.

o

Columns can be set to be sorted in reverse date order when editing the macro.

All examples

See also

Workflow Authoring Guide:

User Guide:

Reporting Guide: