Table of Contents
Approve Plugin
Compatible with DokuWiki
- 2024-02-06 "Kaos" yes
- 2023-04-04 "Jack Jackrum" unknown
- 2022-07-31 "Igor" unknown
- 2020-07-29 "Hogfather" unknown
Similar to publish, structpublish
Installation
This Plugin depends on the following other plugins:
Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.
Description
The plugin is an alternative to the publish plugin but it differs in some ways:
- Approving (or marking ready for approval) the page doesn't make a new page revision.
- User always see the diff of the last approved version and the current draft before approval.
- Approvals of page are counted and displayed in the banner.
- Plugin allows additional intermediate state: Ready for approval may be used (turn on in the plugin config)
Like in the publish plugin pages can be approved by the users that has AUTH_DELETE
permission for the page.
Syntax
The syntax component allows you to place the table with wiki pages and its states. The minimal syntax is:
---- approve table ---- ----
You can narrow the results only to specific namespace:
---- approve table ---- namespace: some:namespace ----
Show the page id's that satisfy the regular expression:
---- approve table ---- filter: /regex/ ----
Show the pages that have some status:
---- approve table ---- states: approved, draft, ready_for_approval ----
Hide the summarize at the bottom of the table:
---- approve table ---- summarize: 0 ----
You can show only a pages for specific approver:
---- approve table ---- approver: user ----
Approver can be currently login user:
---- approve table ---- approver: $USER$ ----
You may join several filters:
---- approve table ---- namespace: some:namespace filter: /regex/ states: approved, draft, ready_for_approval approver: $USER$ summarize: 0 ----
Approve Assignments
The plugins adds additional admin panel “Approve Assignments” that has two main tasks:
- It allows to define pages and/or namespaces where the plugin will be used.
- It allows define the page/namespace approver - a person or group (with @ prefix) who will be responsible for approving the page. The approver will be displayed in the plugin's banner, approve table and will receive notifications if the notification plugin is used.
When the page has its approver, the user or group members are the only ones who can approve the page (this can be turned off in plugins configuration). Approver needs only AUTH_VIEW
permission to approve the page. When the approver isn't set, all users with AUTH_DELETE
permission can approve the page.
Configuration
no_apr_namespaces
- here you can put a list of space separated pages and/or namespaces where the plugin won't be used.Removed in 2024-06-07
prettyprint
- adds nice looking banner while page is printed (tested only with default template)ready_for_approval
- turn on additional intermediate ready for approval state.strict_approver
- when this option is turned on only the page approver can approve the page. Otherwise all users withAUTH_DELETE
permission (and the approver) can approve the page.hide_drafts_for_viewers
- when turned on, users without EDIT permission will see last approved version of page instead of last draft.
Integration with notification plugin
This plugin integrates with notification plugin and adds notifications for approvers about the pages that aren't approved yet.