Staging_and_Approval

Table of contents

• Introduction
• Categories
• Groups & permissions
• Activating the features
• Users for test

Introduction

This new feature in 2.x is quite flexible but a little tricky to setup. Please see the documentation: Wiki Page Staging and Approval

This is one configuration among a lot of possible different ones to set a staging/ approval within tikiwiki. In this case:

• Anonymous & the Registered group can view the wiki pages but Registered can also comment on pages. Only the Authors and Approvers groups can edit a page. As soon as a page is edited, a page with the same name preceded with * is created. An Author or an Approver can still continue to edit the staging page (with the name beginning with *).
• The Approvers group can approve a staging page. As soon the page is approved, content and history are copied to the approved page. The staging page is deleted.
• Permissions over staging and approved pages are done with 2 categories. It is possible to have regular categories (Registered can have tiki_p_view_categories, tiki_p_view_categorized... without breaking the staging feature.

Categories

objects:
 -
  type: category
  ref: Staging_categ
  data:
   name: Staging
   description: For staging page
 -
  type: category
  ref: Approved_categ
  data:
   name: Approved
   description: For approved pages

Groups & permissions

permissions:
 Anonymous:
  description: Already exists
  objects:
   -
    type: category
    id: $profileobject:Approved_categ$
    allow:
     -view_categorized
 Registered:
  description: Will be ignored because group is already created
  allow:
   -view
   -comment
  objects:
   -
    type: category
    id: $profileobject:Approved_categ$
    allow:
     -view_categorized
 Authors:
  description: Can edit pages -> put them in a staging status.
  allow: 
   -edit
   -wiki_view_history
  include: Registered
  objects:
   -
    type: category
    id: $profileobject:Staging_categ$
    allow:
     -view_categorized
     -edit_categorized
   -
    type: category
    id: $profileobject:Approved_categ$
    allow:
     -view_categorized
 Approvers:
  description: Can approve a staging page
  include: Authors
  allow:
   -remove
   -rename
   -rollback
  objects:
   -
    type: category
    id: $profileobject:Approved_categ$
    allow:
     -view_categorized
     -edit_categorized
   -
    type: category
    id: $profileobject:Staging_categ$
    allow:
     -view_categories
     -edit_categorized
 Admins:
  include: Approvers

Activating the features

preferences:
 feature_wiki: y
 feature_categories: y
 feature_wikiapproval: y
 wikiapproval_delete_staging: y
 wikiapproval_prefix: *
 wikiapproval_master_group: Approvers
 wikiapproval_staging_category: $profileobject:Staging_categ$
 wikiapproval_approved_category: $profileobject:Approved_categ$

Users for test

Profiles now supports (in version 4) the creation of users, but this profile doesn't have any yet so you should create some users for each group to test.

---