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:

• pages and blog posts – see: Activity Report - Content
• email notifications – in the macro body of the send-email macro
• message notifications – in the macro body of the set-message macro
• content headers and footers – see:
  •  header and footer parameters of the workflow macro
  • pageheader macro and pagefooter macro
• Page Blueprints

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

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

• Page:
  Adding page activity to email — Include page activity report, or a link to it, in custom email notifications

See also

Workflow Authoring Guide:

• pagestatus macro
• workflow-report macro
• Event references – @pageactivity@

User Guide:

• Page Activity - Page Tools
• Activity Report - Workflow Popup

Reporting Guide:

• Activity Report - Content