Loading...
 

Flagged Revisions


Introduced in Tiki7, Flagged Revisions is a feature replacing the former Staging and Approval. You can get quickly started using the feature when you apply the profile Revision Approval in your tiki site.

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.



1. Enable the feature

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.

2. Permissions involved

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

3. Example

Let's imagine a case where:
  • we have user1 belonging to group1, and user2 belonging to group2.
  • group1 has been granted permissions to edit pages, view history, view unnaproved versions, and to approve them.
  • group2 has only the permission to view and edit wiki pages, but no permission to view history, unnaproved versions nor to approve them.
  • HomePage had some content approved by user1:
    Our organization is about X, Y and Z.
  • HomePage was then edited and new content was added.
    I am { {user}} (the one viewing this page right now)

3.1. Extend the information displayed with some Wiki Argument Variables

You can extend the display of infomation related to flagged revisions in a specific page by means of using the Wiki Argument Variables related to Flagged revision, like in the examples shown in the screenshots below.

3.2. View and actions of user1 (with perms)

In this case and specific moment, HomePage shows this content for user1:

Click to expand
Click to expand


When user1 clicks to see the "latest version", that is the page shown:

Click to expand
Click to expand


When user1 clicks at "Show changes since last approved version", that is the content shown:

Click to expand
Click to expand


There is a box called "Content approval" at the top, which allows user1 to "Approve revision", in an equivalent way to what was shown in the previous screen when viewing the latest version, if user1 had clicked a the button "Approve current revision". Once user1 approves that revision, the new content will be shown when visiting the page:

Click to expand
Click to expand


3.3. View of user2 (without perms)

Note that before user1 approved the changes in that revision, this is what user2 could see in the same HomePage:

Click to expand
Click to expand


And after user1 approved that revision, this is what user2 could see (the same as user1 by then):

Click to expand
Click to expand



4. 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

Simple list of pages pending approval
{LIST()}
  {filter field=wiki_approval_state content=pending}
{LIST}


List of approved pages
{LIST()}
  {filter field=wiki_approval_state content=approved}
{LIST}


List of pages not needing approval
{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.

Simple list of pages pending approval (prior to 11)
{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.

5. Mass approval

Using PluginListExecute
Approve multiple pages at the same time - for activation on existing sites
{LISTEXECUTE()} {pagination max="5000"}
  {filter field=wiki_approval_state content=pending}
  {ACTION(name=Approve)}
    {step action=wiki_approval}
  {ACTION}
{LISTEXECUTE}


Mass approval of all pages in some categories
{LISTEXECUTE()} {pagination max="5000"}
    {filter categories="40 OR 41 OR 97 OR 231"}
    {filter language="fr"}
    {sort mode=title_asc}
    {filter type="wiki page"}
  {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

6. 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.

alias names for this page
FlaggedRevisions | FlaggedRevision | Flagged Revision | Revision Approval | RevisionApproval

Attached files

ID Name Comment Uploaded Size Downloads
75 wikiflagged.jpg my anonymous page does not match your screenshot for 3.2 How can i make the blue box go away for users? I don't necessarily want them to know that there are changes coming to that page... shootathought Tue 03 May, 2016 23:58 CEST 148.50 Kb 0

doc.tiki.org


Bootstrap

AdminGuide

UserGuide

untry+Selector?structure=HomePage+UserGuide&latest=1">Country Selector
  • Group selector
  • IP selector
  • Page selector
  • User selector
  • Static Text Tracker Field
  • Subscription Tracker Field
  • System Tracker Field
  • Textarea Tracker Field
  • URL Tracker Field
  • Adding items to a tracker
  • How to change tracker field types
  • Linking trackers
  • Multilingual trackers
  • Searching tracker items
  • Viewing Tracker Results
  • Export trackers
  • Terms and Conditions
  • Accounting
  • MyAccount
  • User Preferences
  • Inter-User Messages
  • Gmap User
  • Bookmarks
  • Watch
  • User Page
  • MyTiki Details
  • Karma
  • Score vs Karma
  • User Action log
  • Search User
  • Mobile Tiki User
  • User Wizard
  • Must Reads

  • Keywords

    Keywords serve as "hubs" for navigation within the Tiki documentation. They correspond to development keywords (bug reports and feature requests):

    Accessibility (WAI and 508)
    Accounting (7.x)
    Articles and Submissions
    Backlinks
    Banners
    Batch (6.x)
    BigBlueButton audio/video/chat/screensharing (5.x)
    Blog
    Bookmark
    Browser Compatibility
    Link Cache
    Calendar
    Category
    Chat
    Clean URLs
    Comments
    Communication Center
    Compression (gzip)
    Contacts (Address Book)
    Contact us
    Content Templates
    Contribution (2.x)
    Cookie
    Copyright
    Credit (6.x)
    Custom Home and Group Home Page
    Date and Time
    Debugger Console
    Directory of hyperlinks
    Documentation link from Tiki to doc.tiki.org (Help System)
    Docs 8.x
    Draw 7.x
    Dynamic Content
    Dynamic Variable
    External Authentication
    FAQ
    Featured links
    File Gallery
    Forum
    Friendship Network (Community)
    Gmap Google maps
    Groups
    Hotword
    HTML Page
    i18n (Multilingual, l10n, Babelfish)
    Image Gallery
    Import-Export
    Install
    Integrator
    Interoperability
    Inter-User Messages
    InterTiki
    Kaltura video management (4.x)
    Karma
    Live Support
    Login
    Logs (system & action)
    Look and Feel
    Lost edit protection
    Mail-in
    Map with Mapserver
    Menu
    Meta Tags
    Mobile Tiki and Voice Tiki
    Mods
    Module
    MultiTiki
    MyTiki
    Newsletter
    Notepad
    Payment
    Performance Speed / Load
    Permissions
    Platform independence (Linux-Apache, Windows/IIS, Mac, BSD)
    Polls
    Profiles
    Profile Manager
    Report
    Toolbar
    Quiz
    Rating
    Feeds
    Score
    Search engine optimization
    Search
    Search and Replace
    Security
    Semantic links (3.x)
    Shadowbox
    Shadow Layers
    Share
    Shopping cart
    Shoutbox
    Slideshow
    Smiley
    Social Networks
    Spam protection (Anti-bot CATPCHA)
    Spellcheck
    Spreadsheet
    Stats
    Surveys
    Tags (2.x)
    Task
    Tell a Friend, alert + Social Bookmarking
    TikiTests (2.x)
    Theme CSS & Smarty
    Trackers
    Transitions (5.x)
    TRIM
    User Administration including registration and banning
    User Files
    User Menu
    Watch
    WebHelp
    WebDAV (5.x)
    Webmail
    Web Services
    Wiki 3D
    Wiki History, page rename, etc
    Wiki Page Staging and Approval (2.x)
    Wiki Plugin extends basic syntax
    Wiki Syntax
    Wiki structure (book and table of content)
    Workspace
    WSOD
    WYSIWYCA
    WYSIWYG (2.x)
    XMLRPC


    Tiki Newsletter

    Delivered fresh to your email inbox!
    Newsletter subscribe icon
    Don't miss major announcements and other news!
    Contribute to Tiki