Closed (fixed)
Project:
Revisioning
Version:
6.x-2.7
Component:
Miscellaneous
Priority:
Normal
Category:
Feature request
Assigned:
Reporter:
Created:
18 Nov 2009 at 07:40 UTC
Updated:
3 Dec 2009 at 23:00 UTC
Quote from README.txt from revisioning-6.x-2.7.tar.gz:
INSTALLATION
============
0. Install the Module Grants module as per its README instructions.
Optionally install the Diff module if you want to compare revisions and
highlight the differences.
1. Place the "revisioning" folder in your "sites/all/modules" directory.
2. Enable the module under Administer >> Site building >> Modules.
3. Under Administer >> Content >> Content types, click "edit" next to the
content types for which you wish to enable/disable revisioning. Under
"Workflow Settings", Default Options, tick both the "Create new revision"
and "New revision in draft, pending moderation" checkboxes. Also in this
section UNtick "Published", so that all new content is created in an
unpubished state, i.e. invisible to the public.
4. The module creates a new root menu item, named "My content" with three tabs:
o "Viewable" shows all nodes that may be viewed by the logged-in user
o "Editable" shows all nodes that may be edited by the logged-in user
o "Pending", a subset of "Editable" showing nodes that have been revised
recently and are awaiting review and publication by an authorised role.
These menu options will be visible only to roles that have the "access
content summary" permission, as granted by the administrator.
5. Grant to the various roles the view/delete/revert revisions permissions
(node access section) and the "edit revisions" permission (revisioning
section). Typically you'd give authors the "view revisions" and
"edit revisions" permissions, while moderators will get the same as well
as the "publish/revert revisions" permission. Neither require the
"administer nodes" permission, which is a good thing as this gives
excessive rights.Ad 3 till 5) Please, list these instructions under a CONFIGURATION (not INSTALLATION) section within the documentation.
Ad 3) Please, clarify in the help text of the configuration option "New revision in draft, pending moderation". I think (but hope to get some verification on this in this topic) that it means something like: "Allow authors to edit/ delete their new revisions, as long as those revisions have not been moderated". Perhaps the help text and/ or documentation should also refer to: http://drupal.org/node/472710
Comments
Comment #1
rdeboerThanks for your suggestions.
Trust you got it to work though?
Rik
Comment #2
not_Dries_Buytaert commentedThank you for being so responsive and willing to incorporate the suggestions. :-)
The module functions as designed and suffers only from known (already reported) bugs, as fas as I have tested so far. I am still in the process of testing it, though.
Please, confirm in this topic what the "New revision in draft, pending moderation" option does, so I can finalize my testing. In contrast to what I wrote earlier, I think (but am not really sure) that this option causes updating an EXISTING revision (instead of creating a new one) if that revision is still pending for moderation.
Is this assumption correct?
Ad 4) I believe this instruction is outdated, as the navigation menu item changed from "My content" to "Accessible content"
ad 4 & 5) I believe this instruction is outdated, as following tabs changed from:
"" to "I created"
"Viewable" to "I can view"
"Editable" to "I can edit"
"Pending" to "I last modified"
NB: Also, in the permissions page under the "revisioning module" section, the name of the field "access 'Pending' tab" is outdated, as for constancy it should be "access 'I last modified' tab". Please, change this.
Aforementioned issues are actually (tiny) bugs.
Comment #3
rdeboerRe 4) and 5) and the names of the tabs ... the Revisioning and Module Grants README.txt files were updated before your post came in. They're in the development snapshot versions of these modules.
I may follow your suggestion to add more explanation to the README.txt file, although I think this info is probably better suited for the tutorials on the Revisioning project page.
To answer your question:
"New revision in draft, pending moderation" means that when a user edits a piece of content two things happen
1) a new revision is created (via the "Create new revision" tickbox which should also be ticked).
2) unlike default core behaviour, this new revision is NOT automatically made "current"; the publicly visible revision remains unchanged.
There is an additional radiobox on the same page (Administer >> Content management >> Content types >> edit that augments the above behaviour giving you the option to "Only create a new revision when saving content that is not already in draft/pending moderation". This will save you some disk space, because until the draft is published all saved modifications will be applied to the same copy, i.e. no new revision is created when one already exists.
On the other hand there are situations, for instance in a Wiki page with multiple authors editing the same copy, where you do want every Save to create a new draft (revision), so that contributors can compare what was changed between Saves.
The Diff module is a good addition to Revisioning for this.
NB: Also, in the permissions page under the "revisioning module" section, the name of the field "access 'Pending' tab" is outdated, as for constancy it should be "access 'I last modified' tab".
I don't think so. "access I Last Modified" tab is a permission that pertains to Module Grants (a module that one can use on its own without Revisioning), while "access Pending tab" has everything to do with Revisioning.
Hope this helps
Rik
Comment #4
rdeboerAdded elaboration on "New revision in draft, pending moderation" to README.txt file.
Available in versions of Revisioning of 20 Nov 09 or later.