Manual:Extension/BlueSpiceReadConfirmation

The extension ReadConfirmation allows to request read confirmations from users. If a user is assigned to a page, a mandatory read confirmation can be added to the page.

What is ReadConfirmation?

Enabling read confirmations

Read Confirmation ask for confirmation that an article was read by certain users.

Where to find Assignments that you are responsible for?

Or go to upper right corner, click on your name and in combo box you will find:"assignments". When you click on "assignments" you will get an article or articles which you are assigned to.

How to use read confirmation

An administrator must enable read confirmations for the namespace the page belongs to. This can be set using the Namespace manager:

Activating read confirmations in a namespace

Display

Click on one of the articles that you are assigned and you will get:

With ReadConfirmation responsible editors are required to confirm that they have had read the article. On an article they are responsible for, they will get a notification containing an option to confirm that the article has been read.

Create a read confirmation

Read confirmation checkbox

When read confirmations are active on a namespace, assigned users see a confirmation prompt. After checking the checkbox Yes, I have completely read this article and clicking Confirm, the page will be marked as read by that user.

Administration of read confirmations

  When access is accessed, all articles of the wiki are listed. The "Assignments" column shows whether an article has already been assigned a read receipt or not.

In order to provide an article with a reading confirmation, you will first find the desired article by scrolling through the following buttons in the displayed list Or the articles. The sorting and filtering functions can be found in the drop-down list of the column header "page title": assign the users, select the appropriate item and click the "Edit" button above the list. A dialog box appears where you can use the drop-down list to assign the users and / or usergroups of the wiki to the article. By clicking on the "Request read confirmation" button, you are now starting the process

Since the reading confirmation depends on the version of an article, you can repeatedly request the reading confirmation if the article has changed in the meantime. The process then starts from the beginning and the affected users are prompted again to issue a read receipt

Received for read receipt After the read confirmation has been established, the respective users receive an email and a message in the wiki. This requires that the users have activated the notifications for the page assignments in their user settings: Regardless of the notifications, the assignments of certain users to articles are also visible in the article info.  Wiki admins can see an overview of all read confirmations by navigating to Global actions > Management > Assignment management. Read confirmation information is shown in the column Read on. A page can have multiple states:

• Read confirmation not enabled: BlueSpiceReadConfirmation is not enabled for the namespace to which the page belongs.
• Not read: BlueSpiceReadConfirmation is enabled, but the assigned users have not yet read the page.
• Actions: In the columns for actions, there are two items related to read confirmations.
  • Read confirmation log: Link to the read confirmation log for the page.
  • Request read confirmation: Users get a reminder for their read confirmation.

Reviewing read confirmations

Read confirmation in connection with page approval

If the approval feature is activated in a namespace at the same time, the read confirmation is triggered when a new draft is created. This can be changed via server configuration so that the read confirmaation is required after the draft page has been approved.

Related info

• Reference:BlueSpiceReadConfirmation