ajung/plone.app.discussion
ajung/plone.app.discussion
0
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Update workflow documentation. we are not there yet.

Browse Source 
svn path=/plone.app.discussion/trunk/; revision=40648
This commit is contained in:
Timo Stollenwerk 2010-10-15 14:49:54 +00:00
parent b849e32fad
commit 6c67b0dbda
1 changed files with 31 additions and 31 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

58
docs/source/workflow.txt
View File

@ -9,41 +9,19 @@ workflows.
Introduction Introduction
============ ============
Workflow and permissions... plone.app.discussion tries to use the default Plone permission and workflow
engine as much as possible. plone.app.discussion ships with a simple one-state
workflow and a review workflow for comments:
Workflow
========
plone.app.discussion ships with a simple one-state workflow and a review
workflow for comments:
1) **Comment Single State Workflow**: 1) **Comment Single State Workflow**:
Essentially a workflow with no transitions, but it has a Published state, Essentially a workflow with no transitions, but it has a published state,
so portlets and applications that expect that state will continue to work. so portlets and applications that expect that state will continue to work.
2) **Comment Review Workflow**: A simple review workflow for comments 2) **Comment Review Workflow**: A simple review workflow for comments
... A simple review workflow that comes with two states (pending and published)
and a single transition (publish).
.. note:: For a general introduction to workflows in Plone see:
http://plone.org/documentation/kb/creating-workflows-in-plone/
Comment Single State Workflow
-----------------------------
...
Comment Review Workflow
-----------------------
The comment review workflow comes with two states (pending and published) and
one transition (publish).
The 'pending' state is the initial state. 'published' is the state where the The 'pending' state is the initial state. 'published' is the state where the
comment is visible to everyone and non-editable. comment is visible to everyone and non-editable.
@ -54,6 +32,29 @@ The 'publish' transition is protected by the 'Review comments' permission.
* --> [pending] -- {publish} --> [published]--> * * --> [pending] -- {publish} --> [published]--> *
.. note:: For a general introduction to workflows in Plone see:
http://plone.org/documentation/kb/creating-workflows-in-plone/
Custom comment workflow
=======================
You can create and enable any custom workflow on the "comment" content type.
Though, there are some special hooks in plone.app.discussion that check if the
workflow that is enabled for the "comment" content type has a 'pending' state in
order to do the following things:
1) A portal message will be shown to the user after posting a comment, if
the comment just entered the 'pending' state.
2) A message is shown to the user if he/she accesses the bulk moderation view
and workflow is enabled for comments that does not implement a 'pending'
state.
3) A moderator will only be emailed when comment moderation is enabled in the
discussion control panel and the comment workflow contains a 'pending'
state.
Permissions Permissions
=========== ===========
@ -61,4 +62,3 @@ Permissions
"Review comments" permission, by default "Manager" and "Reviewer" "Review comments" permission, by default "Manager" and "Reviewer"
"Reply to item" permission, by default "Manager" and "Member" "Reply to item" permission, by default "Manager" and "Member"