It's better when it's simple

User Tools

Site Tools


Acknowledge Plugin

Compatible with DokuWiki

  • 2024-02-06 "Kaos" unknown
  • 2023-04-04 "Jack Jackrum" yes
  • 2022-07-31 "Igor" yes
  • 2020-07-29 "Hogfather" yes

plugin Manage page acknowlegments by assigning users and groups

Last updated on
Syntax, Admin

Similar to ireadit

Tagged with acknowledge, confirm

A CosmoCode Plugin


Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.


The plugin provides a convenient way to manage acknowledgement of certain pages, for example meeting minutes or policy agreements. It consists of three components:

  1. “Acknowledge” button is placed on pages which an user is assigned to
  2. A wiki page with an overview of the user's outstanding acknowledements
  3. An admin overview of all current acknowledgements

Syntax and Usage

Users and groups can be assigned for acknowledgement on a page-by-page basis or centrally using assignment patterns.

Acknowledgement Widget

Insert the widget syntax into any page to display a text, a checkbox and a button.


The syntax accepts a comma separated list of users and/or groups (prefixed with an @) who need to acknowledge this page. Once a user has acknowledged a page, the date and time of acknowledging is shown instead of the form.



The form is only displayed to the listed users (or members of the listed groups). For all others, nothing is shown at all.

As soon as the page has been modified, the assigned users must acknowledge its contents again. (Minor changes do not invalidate the acknowledgements.)

Pages to Acknowledge

Use the overview syntax to display the list of pages that the currently logged in user is required to acknowledge.


If no pages are marked to be acknowledged by the current user or all pages have already been acknowledged, a “Nothing found” text is shown instead.

All Acknowledgements of the Current User

You can also display a complete listing of the user's acknowledgment assignments, both pending and done:


The dates of past acknowledgements are formatted using the dformat configuration setting.

Admin: Acknowledgement Overview

This admin component provides users with manager permission with some reporting on the current acknowledgements:

  • A list of the most recent acknowledgements
  • A report for a given user listing all pages they have to acknowledge
  • A report for a given page pattern listing all users that have to acknowledge the matching pages

The pattern for the last option uses the same syntax as the assignments explained in the next section.

Admin: Acknowledgement Assignments

This admin component allows for the central definition of acknowledgment assignments. This is useful when for example, the same group of users need to acknowledge all pages within a certain namespace. This component is only accessible to superusers.

Whenever a page matches one of the patterns defined here, the given people and groups will be assigned.

  • Namespaces excluding subnamespaces are assigned as namespace:*.
  • Namespaces including subnamespaces are assigned as namespace:**.
  • Pages as usual with their full page ID.
  • Regular Expressions starting and ending with / - they are matched against a : prefixed full page id.

Assignees are defined either by username or @ prefixed group name. Multiple assignees are separated by commas ,.

This feature can be used together with manually assigned users. For pages that have assignments via these patterns, but do not use the Acknowledgement Widget, the widget is automatically appended at the end of the page.




plugin/acknowledge.txt · Last modified: 2024-01-07 14:34 by Aleksandr

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki