Page Approval

Description

Add the page approval functionality to a page.


Parameters

NameRequiredAvailable InMigratable to Cloud?Default ValueDescription
Users
 Optional
Server
No
none
A list of users who will be added as approvers. This is a comma separated list of case-sensitive user names. 
Approval Group(s)
 Optional
Server
No
none
A list of user-groups who will be added as approvers. This is a comma separated list of case-sensitive user-group names.
Acknowledgers
 Optional
Server
No
none
A list of users who will be added as acknowledgers. This is a comma separated list of case-sensitive user names. 
Acknowledgement Group(s)
 Optional
Server
No
The users of the specified group(s) will be added to the list of users who are registered to acknowledge the page. Users can not remove themselves from the list. Note that notifications are NOT generated immediately when users are added or removed from a group.
Quorum
 Optional
Server
No
Number of approvers required before approval achieved.
Notified Users
 Optional
Server
No
none
  • all - Notify all users
  • unapproved - Notify registered users who have not approved the page.
  • approved - notify users who have approved the page

Options are all,unapproved,approved. Must have notifiedactions defined.

Notified Actions
 Optional
Server
No
none
  • change - Notify of any change
  • unapproval - Notify when the page is unapproved
  • approval - Notify when the page is approved

Options are change,unapproval,approval. Must have notifiedusers defined.

Notify Approvals
 Optional
Server
No
false
Notify on approval events.
Notify Acknowledgements
 Optional
Server
No
false
Notify on acknowledgement events.
Chain
 Optional
Server
No
no

Enforces an ordered list of approvals.

The approvals are done in the order of the users that are defined by the users option.

Options are yes/no. Must have users defined. 

Show Acknowledgement
 Optional
Server
No
none

Creates an option such that users can acknowledge a page.

Users who acknowledge a page are added to an acknowledgement list. Options not required.

Show Role
 Optional
Server
No
Shows a comment box where users can enter their role in the approval process. Note that if the showrole parameter has been configured to be true by default, then the hiderole parameter can be used to turn off comments.
Show Comment
 Optional
Server
No
Shows a comment box where users can make comments about why they approved or unapproved a page. Note that if the showcomment parameter has been configured to be true by default, then the hidecomment parameter can be used to turn off comments.
Acknowledgers Visible
 Optional
Server
No
true

If acknowledgers are active, this determines whether the acknowledgers table is shown or not by default.

Users will still be able to toggle this table on or off, however their setting will not be remembered.

Allow Macros
 Optional
Server
No
no

Specifies a list of one or more macros that will allowed for page approval.

Normally, dynamic macros will prevent the pageapproval macro from working, so this options gives users a way to work around them. A comma separated list of macro names.

Expire After
 Optional
Server
No
none

Specifies a time period, after the page is approved, when the approval will expire. The usage example shows a page that will have it's approve expired 2 months after the page is approved.

Options are a number and time word, such as '72 hours', '1 day', '6 months' or '1 year'. Time periods allowed are year, month, day, hour.

Expiry Month
 Optional
Server
No
none

Specifies a fixed, recurring month when the page will expire. Can be used in conjunction with expiryday.

Options are a number (1-12). The month when the approval of this page will expire.

Expiry Day
 Optional
Server
No
none

Specifies a fixed, recurring day of the month when the page will expire. Can be used in conjunction with expirymonth to define a particular day in a year. Note that the behavior of days 29, 30 and 31 is undefined, so please don't use them.

Options are a number (1-31). The day when the approval of this page will expire.