PmWiki has the capability to stage draft versions of a page prior to them becoming “official”. All of the draft pages end in “-Draft” by default (this can be changed by setting
$DraftSuffix). Multiple interim edits to a page can be temporarily saved in a “-Draft” copy of a page until the draft is ready to be published to the original.
When the site administrator sets
$EnableDrafts in a local customization file, the “Save” button on the edit page is split into separate “Publish” and “Save draft” buttons.
The “Save draft” button causes any edits to be saved to a “-Draft” copy of the original page, leaving the original page intact. Subsequent requests to edit the page (either the original or -Draft) bring up the draft copy for further editing.
The “Publish” button saves back to the original non-Draft copy of the page, removing any -Draft page that may have been created.
By default, saving drafts and publishing are available to anyone with ‘edit’ permissions (see Passwords). However, the site administrator can also set the
$EnablePublishAttr configuration variable, which provides a separate ‘publish’ permission that is required to publish to the original page.
Drafts and pagelists (and RSS)
The drafts module also sets pagelists (and thus RSS feeds) to ignore “-Draft” pages by default; one has to do list=all or similar in order to have draft pages included in a pagelist or RSS feed.
Q How do I moderate all postings?
Start by enabling drafts to change the “Save” button into separate “Publish” and “Save draft” buttons. Then set
$EnablePublishAttr. This adds a “publish” authorization level to distinguish editing of page drafts from publishing.