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
andfooter
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
Parameter | Required | Default | Notes |
---|---|---|---|
| all entries shown | Maximum number of entries to show | |
ascending | false | Which order should the entries be shown in?
|
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
-
Adding page activity to email — Include page activity report, or a link to it, in custom email notifications
See also
- pagestatus macro
- workflow-report macro
- Event references –
@pageactivity@