The extension FlaggedRevs is a MediaWiki extension that activates an approval mechanism. New versions of a page are initially marked as drafts and remain so until a user with review rights approves the page.
Activating the acceptance feature
Activating the acceptance feature is done on the namespace level. A user with admin permissions activates the feature in Global actions > Management > Namespace manager for individual namespaces.
The dialog window opens after clicking the edit icon (wrench) in the Actions column. Select Approval and click Done.
Existing pages
After activating Approvals for a namespace, all pages in the namespace are set into first draft mode.
Each page in the namespace now displays the acceptance status in the title area.
New pages
When a new page is created and first saved, it will automatically be visible to all users. Subsequent page edits will be collected in the draft version of the page. If a page is edited and saved multiple times while in draft mode, each edit gets logged in the version history:
The revisions in draft status have a dotted border and are highlighted in orange. In addition, they are marked as pending review. These revisions can be compared before the pending changes of the page are accepted.
Accepting a page
Users with review rights can accept a draft page any time they save a page (Accept this unreviewed page):
If the page is not accepted at this point, it can be accepted independently from the editing process.
A user with review rights can accept the page quickly with the review feature in the title section of the page. The draft message will display an arrow which includes the accept function:
When accepting the page, the reviewer can leave a comment. This comment will then be shown in the version history of the page.
The page status now shows the page version as accepted.
Setting read permissions for drafts
By default, all users can see the drafts of a page, even readers.
To hide drafts from readers, the group user has to be removed from the configuration. An administrator deletes the group user form "Show unstable pages for the following groups" in Global actions > Management > Config manager:
When the group user is removed, only sysop and reviewer users can access drafts. If you want other groups, for example editor, to see draft versions, you need to add them to the configuration and save it:
The two checkboxes Automatically set the page to stable... (checkbox is available until version 3.1.) and Automatically delete the workflow... determine what happens at the end of a workflow, if there is an active Review for a page. A page can be set to accepted status by a workflow and the workflow can be deleted after the page is marked as stable.
Anyone with edit permissions will receive a notification that there are pending changes for the page when they access the page in edit mode:
Changes to embedded templates and files
If a page includes templates or files such as images or PDFs and there is a change to these files after the page has been approved, this will also be reflected in the status information in the title area.
If the embedded resources are located in a namespace without its own approval function, the version of the resource at the time of page approval is displayed in the approved version of the page. The draft version accordingly shows the most current version of the embedded resource. To approve the resource change, the page has to be approved again. This creates a new page version.
Settings for resources on approved pages
It is possible via server configuration to show embedded resources (i.e., files, templates or transcluded content) that were changed after the page has been released, in a certain version. The following options exist:
| Setting | Description |
|---|---|
| FR_INCLUDES_STABLE | Always shows the latest approved (stable) version of a resource, even if it was approved after the page was approved (this works only if the resource is located in a namespace with active approval feature). |
| FR_INCLUDES_CURRENT | Always shows the latest version of the included resource. |
Effects on Semantic MediaWiki properties
Wenn in einem Namensraum gleichzeitig mit der Seitenfreigabe auch Semantic MediaWiki aktiviert ist, sind je nach Freigabestatus der Seite folgende Attribute für SMW-Abfragen verfügbar:
| Document state | Available properties |
|---|---|
| First draft | Current values |
| Approved | Values of the approved (stable) version |
| Draft | Values of the approved (stable) version (default setting) |
| Implicit draft[1] | Values of the approved (stable) version |
The availability of the semantic properties is determined by the following configuration setting:
$bsgFlaggedRevsConnectorStabilizeSMWPropertyValues = true;
The value for this setting can be set to false in the LocalSettings.php of the server file system. If set to false, the property values of the draft version are used for semantic queries instead of the values for the stable version.
Quality management overview
The Special page Special:Quality_management_overview allows users with admin or reviewer rights to view and filter a list of wiki pages and their review status.
Related info
- ↑ An approved page has an implicit draft, if there have been changes to embedded resources (e.g., a template or an image) since the last page approval.
