<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<link rel="home" title="HomePage" href="HomePage.html" />
<link rel="help" title="HowToUseWiki" href="HowToUseWiki.html" />
<link rel="copyright" title="GNU General Public License" href="http://www.gnu.org/copyleft/gpl.html#SEC1" />
<link rel="author" title="The PhpWiki Programming Team" href="http://phpwiki.org/ThePhpWikiProgrammingTeam" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta http-equiv="Content-Language" content="en" />
<meta name="robots" content="noindex,nofollow" />
<meta name="language" content="en" />
<meta name="document-type" content="Public" />
<meta name="document-rating" content="General" />
<meta name="generator" content="PhpWiki" />
<meta name="PHPWIKI_VERSION" content="1.3.14" />

<link rel="stylesheet" type="text/css" charset="iso-8859-1" href="phpwiki-printer.css" />
<title>PhpWiki - Moderated Page</title>
</head>
<body>

<div id="header">
  
<!-- Page title -->
<h1>Moderated Page</h1>
</div>
<div id="content">



<div class="wikitext"><div class="plugin tightenable top" id="ModeratedPagePlugin2"></div>
<hr />
<h2>What is a <a href="ModeratedPage.html" class="wiki">ModeratedPage</a>?</h2>
<p class="tightenable">A <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> is a page-internal setting, which restricts certain actions on certain pages.
The requested action and page is stored internally and an email is sent to the moderators
described in the linked and locked <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> action page.
Any moderator may approve or reject the action by simply clicking an url.
When approving the action, the requested action (edit, rename, ...) is performed.</p>
<p class="tightenable">In both cases the author is notified, so it's recommended for the
moderator to click on either the approve or reject links in the moderation email.
In case of multiple moderators: first comes, first serves.</p>
<h2>How to enable <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> on a single page?</h2>
<ul><li class="tightenable bottom">Check the status of this action page, esp. the moderators in the
plugin line, if they had their emails stored in their
<a href="UserPreferences.html" class="wiki">UserPreferences</a>, and if the action page is locked.</li>
<li class="tightenable top bottom">Add a link to this action page in the page(s) in question.</li>
<li class="tightenable top bottom">Save the page.</li>
<li class="tightenable top">Lock the page to actually change the moderation status. You may want to unlock it then.</li>
</ul>
<h2>How to disable <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> on a single page?</h2>
<ul><li class="tightenable bottom">Remove the link to this action page in the page(s) in question.</li>
<li class="tightenable top bottom">Save the page.</li>
<li class="tightenable top">Lock the page to actually change the moderation status. You may want to unlock it then.</li>
</ul>
<h2>Plugin Arguments</h2>
<ul><li class="tightenable bottom"><p class="tightenable top bottom">moderators: comma seperated list of registered usernames or groups.
Each user should have his email defined in his prefs. Default: &quot;Administrators&quot; or</p>
<span class="plugin" id="SystemInfoPlugin2">admin</span></li>
<li class="tightenable top bottom">requirelevel: one of 0, 1, 2 or 10 on which moderation is used. Default: false (use requireaccess instead)</li>
<li class="tightenable top">requireaccess: comma separated list of access perms, on which the moderation is used
&quot;view,edit,create,list,remove,change&quot;
Default: edit,remove,change</li>
</ul>
<h2>How does it work internally?</h2>
<p class="tightenable">You need to lock the page additionally, so that the link parser performs
some magic whether the <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> link is present or not, for efficiency
reasons. It can be unlocked again, and even the <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> link may be removed.
The status will only be changed on the <b>lock</b> action, whether the <a href="ModeratedPage.html" class="wiki">ModeratedPage</a>
link is present or not.</p>
<p class="tightenable">The moderation status is stored in each page in question.
Each moderated action is stored in the page also, together with a randomly
created permission key to allow Grant by a simple external unauthorized request.
There's no timeout on moderated actions, so the actions may stack up.
The delayed actions may be performed in any order, there's no strict ordering to
follow for the moderator.</p>
<h2>How to enable <a href="ModeratedPage.html" class="wiki">ModeratedPage</a> on multiple/all pages?</h2>
<p class="tightenable">If you enable the config option ENABLE_MODERATEDPAGE_ALL, the page moderation status on
every page is automatically set to check this action page <a href="ModeratedPage.html" class="wiki">ModeratedPage</a>.</p>
<p class="tightenable">There may come another administrative plugin to change the moderation
status on selected pages.</p>
<hr />
<p class="tightenable top bottom"><a href="PhpWikiDocumentation.html" class="wiki">PhpWikiDocumentation</a> <a href="WikiPlugin.html" class="wiki">WikiPlugin</a></p>
</div>

<div id="footer">  <hr class="printer" noshade="noshade" />
<p class="editdate">Owner: &quot;admin&quot;  Last edited on August 14, 2007  7:11 am by &quot;The PhpWiki programming team&quot;</p>
</div>

</div>
<!-- Add your Disclaimer here -->
</body>
</html>
