pgsrc/Help%2FModeratedPagePlugin

   1 Date: Thu,  9 Dec 2010 14:51:45 +0000
   2 Mime-Version: 1.0 (Produced by PhpWiki 1.4.0RC1)
   3 X-Rcs-Id: $Id$
   4 Content-Type: application/x-phpwiki;
   5   pagename=Help%2FModeratedPagePlugin;
   6   flags=PAGE_LOCKED%2CEXTERNAL_PAGE;
   7   markup=2;
   8   charset=UTF-8
   9 Content-Transfer-Encoding: binary
  10
  11 == What is a ModeratedPage? ==
  12
  13 A ModeratedPage is a page-internal setting, which restricts certain actions on certain pages.
  14 The requested action and page is stored internally and an email is sent to the moderators
  15 described in the linked and locked ModeratedPage action page.
  16 Any moderator may approve or reject the action by simply clicking an url.
  17 When approving the action, the requested action (edit, rename, ...) is performed.
  18
  19 In both cases the author is notified, so it's recommended for the
  20 moderator to click on either the approve or reject links in the moderation email.
  21 In case of multiple moderators: first comes, first serves.
  22
  23 == How to enable ModeratedPage on a single page? ==
  24
  25 * Check the status of this action page, esp. the moderators in the
  26   plugin line, if they had their emails stored in their
  27   UserPreferences, and if the action page is locked.
  28 * Add a link to this action page in the page(s) in question.
  29 * Save the page.
  30 * Lock the page to actually change the moderation status. You may want to unlock it then.
  31
  32 == How to disable ModeratedPage on a single page? ==
  33
  34 * Remove the link to this action page in the page(s) in question.
  35 * Save the page.
  36 * Lock the page to actually change the moderation status. You may want to unlock it then.
  37
  38 == Usage ==
  39 {{{
  40 <<ModeratedPage arguments>>
  41 }}}
  42
  43 == Arguments ==
  44
  45 {| class="bordered"
  46 |-
  47 ! Argument
  48 ! Description
  49 ! Default value
  50 |-
  51 | **moderators**
  52 | comma-separated list of registered usernames or groups.
  53 Each user should have his email defined in his prefs.
  54 | "Administrators" or "<<SystemInfo ADMIN_USER>>"
  55 |-
  56 | **requirelevel**
  57 | one of 0, 1, 2 or 10 on which moderation is used
  58 | false (use requireaccess instead)
  59 |-
  60 | **requireaccess**
  61 | comma-separated list of access perms, on which the moderation is used
  62 "view,edit,create,list,remove,change"
  63 | edit,remove,change
  64 |}
  65
  66 == Example ==
  67
  68 {{{
  69 <<ModeratedPage>>
  70 }}}
  71
  72 == How does it work internally? ==
  73
  74 You need to lock the page additionally, so that the link parser performs
  75 some magic whether the ModeratedPage link is present or not, for efficiency
  76 reasons. It can be unlocked again, and even the ModeratedPage link may be removed.
  77 The status will only be changed on the *lock* action, whether the ModeratedPage
  78 link is present or not.
  79
  80 The moderation status is stored in each page in question.
  81 Each moderated action is stored in the page also, together with a randomly
  82 created permission key to allow Grant by a simple external unauthorized request.
  83 There's no timeout on moderated actions, so the actions may stack up.
  84 The delayed actions may be performed in any order, there's no strict ordering to
  85 follow for the moderator.
  86
  87 == How to enable ModeratedPage on multiple/all pages? ==
  88
  89 If you enable the config option ENABLE_MODERATEDPAGE_ALL, the page moderation status on
  90 every page is automatically set to check this action page ModeratedPage.
  91
  92 There may come another administrative plugin to change the moderation
  93 status on selected pages.
  94
  95 == Author ==
  96 * [[PhpWiki:ReiniUrban|Reini Urban]]
  97
  98 <noinclude>
  99 ----
 100 [[PhpWikiDocumentation]] [[CategoryWikiPlugin]]
 101 </noinclude>