Revision approval, Flagged Revisions

Introduced in Tiki7, Flagged Revisions is feature replacing Staging and Approval.

To be used, Flagged Revisions must be enabled from "Admin > Wiki > Flagged Revision" as Revision Approval. Multiple categories can be specified. Make sure to use the category ID, and not the category name, and separate multiple category IDs with the semicolon ; character. Pages added to those categories will use the approval workflow.

Flagged revisions rely on trusted users to mark revisions of a page as good or safe. Trusted users can see all revisions and flag/unflag revisions as needed. A notice at the top of the page will offer these options and allow to navigate to the latest version or the last approved version. More details are available from the Page History.

Untrusted users, likely guests of the site, will only be able to see the approved versions of the page. If they are allowed to view the history of the page, they will also only be able to see and diff between approved revisions. Depending on the permissions granted, they may also be able to view unapproved revisions, but they would get a clear warning that the content has not yet been approved and may not be suitable.

Permissions:

• Can view unapproved revisions of pages (tiki_p_wiki_view_latest)
• Can approve revisions of pages (tiki_p_wiki_approve)

Managing the approval workflow

Starting with Tiki11, additional information is included in the Unified Index. The List Plugin can be used to obtain lists of pages that need approval.

Note: PluginList requires that your Unified Index be up to date

{LIST()}
  {filter field=wiki_approval_state content=pending}
{LIST}

{LIST()}
  {filter field=wiki_approval_state content=approved}
{LIST}

{LIST()}
  {filter field=wiki_approval_state content=none}
{LIST}

In previous versions, a list of pending pages could be obtained in a less accurate manner.

{LIST()}
  {filter categories="42"}
  {filter field=title content=latest}
{LIST}

The LIST plugin has many more options to alter how to display the list of pages and more filters can be added. You are encouraged to create lists of pages needing approval for the different groups of people managing those pages. This can be done by using additional categories on your pages.

If you are using Perspectives, the global listing could be automatically filtered for the currently selected perspective.

Mass approval

Using PluginListExecute

{LISTEXECUTE()} {pagination max="5000"}
  {filter field=wiki_approval_state content=pending}
  {ACTION(name=Approve)}
    {step action=wiki_approval}
  {ACTION}
{LISTEXECUTE}

You also may want to increase "Lucene Maximum Results" and "Lucene Maximum Result Set Limit" from tiki-admin.php?page=search

FAQ

1. Q: How do Approvers become aware of pending Flagged Revisions?
   A: By monitoring email notifications. There is currently no status reporting. See Above
   
   
2. Q: Can emails be sent to different Approvers for different pages or sections?
   A: Approval permission can be assigned to a category. This won't work for sections, but you can assign different pages to different categories, and each approver needs to be in an approval group, then assign category approval permission to that group.
   
   
3. Q: Can certain users be permitted to just make approved edits directly? That is, an admin editing a page still needs to click Approve Edits; seems redundant.
   A: No. In fact, the purpose of revision approval is to review the content before making it public. Just because an administrator does it does not mean it should go live right away.

FlaggedRevisions | FlaggedRevision | Flagged Revision