publish plugin

This plugin was originally written by Jarrod Lowe

Download and install the plugin using the Plugin Manager using the download link given above. Refer to Plugins on how to install plugins manually.

• Merge pull request #4 from lupo49/patch-1 (2011/10/16 12:55)
• Fixed calling helper function. (2011/10/16 12:36)
• fixed path to diff image (2011/02/16 14:25)
• fixed call to wrong function (2011/02/14 10:54)
• store login name, not real name (2011/02/10 16:20)
• fixed syntax errors (2011/02/10 12:27)
• Use editorinfo() to display approver (2011/02/10 12:24)
• use correct dateformat function (2011/02/10 11:31)

The idea behind this plugin is to differentiate between revisions of a document that are in draft state and those that are approved.

A user with delete or admin permissions can mark a revision as approved while editing. Anyone else gets their revision marked as draft. Users with read permissions will see approved revisions only.

The plugin places a banner at the top of each page, with information about the Approval/Draft status. It may contain notes like:

• This version (date) is a Draft
• This version (date) was Approved by user
• The Most Recent Version of this document is a draft (Diff)
• The Previously Approved Version (date) is available (Diff)
• This version is Outdated by a Newer Approved Version (Diff)

The banner is colour-coded: Green for the latest approved version, and Red for all others.

The Old Revisions page is colour-coded: Green for approved versions, and Red for drafts.

The Recent Changes pate is colour-coded: Green for approved versions, and Red for drafts.

A user with sufficient permissions (AUTH_DELETE or AUTH_ADMIN) can Approve a page. They do so by editing the page, and ticking 'Approve', and submitting the page.

Placing the tag [APPROVALS] into a page will give a table listing pages which are:

• In one of the namespaces where publish operates, and
• the latest version is a draft, and
• you have sufficient permission to approve it

You can limit it to certain namespaces with [APPROVALS:namespace]

You may need ~~NOCACHE~~ to the page.

The plugin only applies to specified namespaces (all, by default).

You can set the list of namespaces through the configuration page. It is a space-separated list of namespaces.

Eg. ”playground foospace blah:somethingspace”

The list only takes namespace names, not individual pages.

By default, a user with AUTH_EDIT or better will see the latest revision of a page, if they do not specify which revision they want. However, someone with only AUTH_READ will see the latest approved revision by default (unless there isn't one).

All users with AUTH_READ or better can still view any revision of a page if they specifically request it – whether or not it is approved.