Clone ACLs
Currently in trunk: Will be included in 1.1.7
Working for 1.1.6.0 to 1.1.6.4. See comments for possible bug.
Working for 1.1.6.0 to 1.1.6.4. See comments for possible bug.
A patch you can apply to handlers/page/clone.php that will optionally copy the ACLs from the source page to the new page while cloning a page.
A note about patches
The patch utility is included in most *nix systems and allows all changes to files to be packaged into one convenient'patch file' for distribution. I've found that in the process of transferring files with embedded tabs from the development machine to the wiki environment, the tabs are lost when using copy-and-paste. Consequently, the patch command will sometimes fail, since the tabs have been munged up. I've found that patch -p0 -l < some.patch (note the "dash el" option -- not "dash one") seems to handle munged-up whitespace quite nicely.
Clone ACLs Patch (1.1.6.1)
--- clone.php 2006/03/11 05:26:01 1.1
+++ clone.php 2006/03/11 06:03:04
@@ -29,6 +29,8 @@
*
* @input boolean $editoption optional: if true, the new page will be opened for edition on creation
* default is false (to allow multiple cloning of the same source)
+ * @input boolean $cloneaclsoption optional: if true, ACLs will be copied from the source page to the new page
+ * default is false
*
* @todo Use central library for valid pagenames.
*
@@ -39,6 +41,7 @@
$to = $this->tag;
$note = 'Cloned from '.$from; #i18n
$editoption = '';
+$cloneaclsoption = '';
$box = 'Please fill in a valid target ""PageName"" and an (optional) edit note.'; #i18n
// print header
@@ -65,6 +68,8 @@
$to = ($_POST['to'])? $_POST['to'] : $to;
$note = ($_POST['note'])? $_POST['note'] : $note;
$editoption = (isset($_POST['editoption']))? 'checked="checked"' : '';
+ $cloneaclsoption = (isset($_POST['cloneaclsoption']))? 'checked="checked"' : '';
+
// 3. check target pagename validity
if (!preg_match("/^[A-Zƒ÷‹]+[a-zfl‰ˆ¸]+[A-Z0-9ƒ÷‹][A-Za-z0-9ƒ÷‹fl‰ˆ¸]*$/s", $to))
@@ -90,6 +95,17 @@
$thepage=$this->LoadPage($from); # load the source page
if ($thepage) $pagecontent = $thepage['body']; # get its content
$this->SavePage($to, $pagecontent, $note); #create target page
+ // Clone ACLs if requested
+ if($cloneaclsoption == 'checked="checked"')
+ {
+ $read_acl = $this->LoadACL($from, "read", 0);
+ $write_acl = $this->LoadACL($from, "write", 0);
+ $comment_acl = $this->LoadACL($from, "comment", 0);
+ $this->SaveACL($to, "read", $this->TrimACLs($read_acl["read_acl"]));
+ $this->SaveACL($to, "write", $this->TrimACLs($write_acl["write_acl"]));
+ $this->SaveACL($to, "comment", $this->TrimACLs($comment_acl["comment_acl"]));
+ }
+ // Open editor if requested
if ($editoption == 'checked="checked"')
{
// quick edit
@@ -118,6 +134,11 @@
'<td></td>'.
'<td>'.
'<input type="checkbox" name="editoption" '.$editoption.' /> Edit after creation '.
+ '<input type="checkbox" name="cloneaclsoption" '.$cloneaclsoption.' /> Clone ACLs '.
+ '</tr>'.
+ '<tr>'.
+ '<td></td>'.
+ '<td>'.
'<input type="submit" name="create" value="Clone" />'.
'</td>'.
'</tr>'.
+++ clone.php 2006/03/11 06:03:04
@@ -29,6 +29,8 @@
*
* @input boolean $editoption optional: if true, the new page will be opened for edition on creation
* default is false (to allow multiple cloning of the same source)
+ * @input boolean $cloneaclsoption optional: if true, ACLs will be copied from the source page to the new page
+ * default is false
*
* @todo Use central library for valid pagenames.
*
@@ -39,6 +41,7 @@
$to = $this->tag;
$note = 'Cloned from '.$from; #i18n
$editoption = '';
+$cloneaclsoption = '';
$box = 'Please fill in a valid target ""PageName"" and an (optional) edit note.'; #i18n
// print header
@@ -65,6 +68,8 @@
$to = ($_POST['to'])? $_POST['to'] : $to;
$note = ($_POST['note'])? $_POST['note'] : $note;
$editoption = (isset($_POST['editoption']))? 'checked="checked"' : '';
+ $cloneaclsoption = (isset($_POST['cloneaclsoption']))? 'checked="checked"' : '';
+
// 3. check target pagename validity
if (!preg_match("/^[A-Zƒ÷‹]+[a-zfl‰ˆ¸]+[A-Z0-9ƒ÷‹][A-Za-z0-9ƒ÷‹fl‰ˆ¸]*$/s", $to))
@@ -90,6 +95,17 @@
$thepage=$this->LoadPage($from); # load the source page
if ($thepage) $pagecontent = $thepage['body']; # get its content
$this->SavePage($to, $pagecontent, $note); #create target page
+ // Clone ACLs if requested
+ if($cloneaclsoption == 'checked="checked"')
+ {
+ $read_acl = $this->LoadACL($from, "read", 0);
+ $write_acl = $this->LoadACL($from, "write", 0);
+ $comment_acl = $this->LoadACL($from, "comment", 0);
+ $this->SaveACL($to, "read", $this->TrimACLs($read_acl["read_acl"]));
+ $this->SaveACL($to, "write", $this->TrimACLs($write_acl["write_acl"]));
+ $this->SaveACL($to, "comment", $this->TrimACLs($comment_acl["comment_acl"]));
+ }
+ // Open editor if requested
if ($editoption == 'checked="checked"')
{
// quick edit
@@ -118,6 +134,11 @@
'<td></td>'.
'<td>'.
'<input type="checkbox" name="editoption" '.$editoption.' /> Edit after creation '.
+ '<input type="checkbox" name="cloneaclsoption" '.$cloneaclsoption.' /> Clone ACLs '.
+ '</tr>'.
+ '<tr>'.
+ '<td></td>'.
+ '<td>'.
'<input type="submit" name="create" value="Clone" />'.
'</td>'.
'</tr>'.
Clone ACLs Patch (1.1.6.2)
--- clone.php.orig Tue Aug 22 18:05:01 2006
+++ clone.php Tue Aug 22 18:07:58 2006
@@ -29,6 +29,8 @@
*
* @input boolean $editoption optional: if true, the new page will be opened for edition on creation
* default is false (to allow multiple cloning of the same source)
+ * @input boolean $cloneaclsoption optional: if true, ACLs will be copied from the source page to the new page
+ * default is false
*
* @todo Use central library for valid pagenames.
*
@@ -56,6 +58,7 @@
$to = $this->tag;
$note = sprintf(CLONED_FROM, $from);
$editoption = '';
+$cloneaclsoption = '';
$box = PLEASE_FILL_VALID_TARGET;
// print header
@@ -82,7 +85,9 @@
$to = isset($_POST['to']) && $_POST['to'] ? $_POST['to'] : $to;
$note = isset($_POST['note']) && $_POST['note'] ? $_POST['note'] : $note;
$editoption = (isset($_POST['editoption']))? 'checked="checked"' : '';
+ $cloneaclsoption = (isset($_POST['cloneaclsoption']))? 'checked="checked"' : '';
+
// 3. check target pagename validity
if (!preg_match(VALID_PAGENAME_PATTERN, $to)) //TODO use central regex library
{
@@ -107,6 +112,17 @@
$thepage=$this->LoadPage($from); # load the source page
if ($thepage) $pagecontent = $thepage['body']; # get its content
$this->SavePage($to, $pagecontent, $note); #create target page
+ // Clone ACLs if requested
+ if($cloneaclsoption == 'checked="checked"')
+ {
+ $read_acl = $this->LoadACL($from, "read", 0);
+ $write_acl = $this->LoadACL($from, "write", 0);
+ $comment_acl = $this->LoadACL($from, "comment", 0);
+ $this->SaveACL($to, "read", $this->TrimACLs($read_acl["read_acl"]));
+ $this->SaveACL($to, "write", $this->TrimACLs($write_acl["write_acl"]));
+ $this->SaveACL($to, "comment", $this->TrimACLs($comment_acl["comment_acl"]));
+ }
+ // Open editor if requested
if ($editoption == 'checked="checked"')
{
// quick edit
@@ -135,6 +151,12 @@
'<td></td>'."\n".
'<td>'."\n".
'<input type="checkbox" name="editoption" '.$editoption.' id="editoption" /><label for="editoption">'.LABEL_EDIT_OPTION.'</label>'."\n".
+ '<input type="checkbox" name="cloneaclsoption" '.$cloneaclsoption.' /> Clone ACLs '.
+ '</tr>'.
+ '<tr>'.
+ '<td></td>'.
+ '<td>'.
+
'<input type="submit" name="create" value="'.LABEL_CLONE.'" />'."\n".
'</td>'."\n".
'</tr>'."\n".
+++ clone.php Tue Aug 22 18:07:58 2006
@@ -29,6 +29,8 @@
*
* @input boolean $editoption optional: if true, the new page will be opened for edition on creation
* default is false (to allow multiple cloning of the same source)
+ * @input boolean $cloneaclsoption optional: if true, ACLs will be copied from the source page to the new page
+ * default is false
*
* @todo Use central library for valid pagenames.
*
@@ -56,6 +58,7 @@
$to = $this->tag;
$note = sprintf(CLONED_FROM, $from);
$editoption = '';
+$cloneaclsoption = '';
$box = PLEASE_FILL_VALID_TARGET;
// print header
@@ -82,7 +85,9 @@
$to = isset($_POST['to']) && $_POST['to'] ? $_POST['to'] : $to;
$note = isset($_POST['note']) && $_POST['note'] ? $_POST['note'] : $note;
$editoption = (isset($_POST['editoption']))? 'checked="checked"' : '';
+ $cloneaclsoption = (isset($_POST['cloneaclsoption']))? 'checked="checked"' : '';
+
// 3. check target pagename validity
if (!preg_match(VALID_PAGENAME_PATTERN, $to)) //TODO use central regex library
{
@@ -107,6 +112,17 @@
$thepage=$this->LoadPage($from); # load the source page
if ($thepage) $pagecontent = $thepage['body']; # get its content
$this->SavePage($to, $pagecontent, $note); #create target page
+ // Clone ACLs if requested
+ if($cloneaclsoption == 'checked="checked"')
+ {
+ $read_acl = $this->LoadACL($from, "read", 0);
+ $write_acl = $this->LoadACL($from, "write", 0);
+ $comment_acl = $this->LoadACL($from, "comment", 0);
+ $this->SaveACL($to, "read", $this->TrimACLs($read_acl["read_acl"]));
+ $this->SaveACL($to, "write", $this->TrimACLs($write_acl["write_acl"]));
+ $this->SaveACL($to, "comment", $this->TrimACLs($comment_acl["comment_acl"]));
+ }
+ // Open editor if requested
if ($editoption == 'checked="checked"')
{
// quick edit
@@ -135,6 +151,12 @@
'<td></td>'."\n".
'<td>'."\n".
'<input type="checkbox" name="editoption" '.$editoption.' id="editoption" /><label for="editoption">'.LABEL_EDIT_OPTION.'</label>'."\n".
+ '<input type="checkbox" name="cloneaclsoption" '.$cloneaclsoption.' /> Clone ACLs '.
+ '</tr>'.
+ '<tr>'.
+ '<td></td>'.
+ '<td>'.
+
'<input type="submit" name="create" value="'.LABEL_CLONE.'" />'."\n".
'</td>'."\n".
'</tr>'."\n".
Please make sure you check out the latest SVN version if you want to suggest any improvement on top of the existing code.
BTW: There's seemingly no way of resetting ACLs to the default values beside deleting the appropriate row in _acls in the database. Maybe the acls.php handler should be extended by a 'Reset to default ACLs' button, deleting the ACLs entry in the database. As I've found no way at the moment to do this, I report this to you. ... maybe I should take a look at delete.php -- deletion of ACLs should be in there.
resetting acls: http://wush.net/trac/wikka/ticket/211 milestone set for 1.1.7.1 at the moment
Most simple solution would be to allow the entry 'default' in the ACL boxes, meaning to not store any ACLs, not even empty one. This could also be used to show that the current page uses the default values which is missing currently. Or a checkbox labelled 'Default value' for each ACL box. Might be more elegant and not restricting having a group or user called 'default' (whyever). The default values should be displayed somewhere, maybe beneath the ACL box together with the checkbox.