Differences

This shows you the differences between two versions of the page.

--- plugin:acl [2013-01-24 22:19] – [Usage] 88.74.123.0
+++ plugin:acl [2024-04-10 01:46] (current) – 69.124.234.121
@@ Line 5: / Line 5: @@
 author     : Andreas Gohr
 email      : andi@splitbrain.org
-type       : admin
+type       : admin, remote
-lastupdate :
+lastupdate : 2023-04-04
 compatible : (bundled)
 depends    :
@@ Line 12: / Line 12: @@
 similar    :
 tags       : acl, users, groups, !bundled
+screenshot_img: :aclmanager.png
 ----
@@ Line 17: / Line 18: @@
 ===== Description =====
-This plugin handles the management of access control lists for individual pages and namespaces.
+This **plugin** handles the management of access control lists for individual pages and namespaces.
 ===== Usage =====
-The ACL Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "Access Control List Management").
+The ACL Manager is accessible from the admin screen:\\
+Login as superuser, click "Admin" and choose "{{https://raw.githubusercontent.com/dokuwiki/dokuwiki/master/lib/plugins/acl/admin.svg?14}} Access Control List Management"
 {{:aclmanager.png}}
-FIXME add detailed interface description here.
-TODO The plugin needs to support recursive patterns like *:*. The acl subsystem accepts the pattern but the plugin does not.
+====Interface elements====
+The numbered elements are:
+  - **Site index** \\ In the topleft column the index of the whole site is shown, please select here your page or namespace before you can check its current settings, modify or add a new rules for it.
+  - **User and group selector** \\ The top toolbar on the right let you select users or groups that where already mentioned in existing rules. Or you can select the upper options ''Group:'' or ''User:'' to input a new name.
+  - **Current permission status** \\ Below the selector the selected user or group is display with their current (inherited) permissions on the page/namespace selected in the index. The permissions may not be set explicitly, but can be inherited from groups or higher namespaces.
+  - **Add new/Modify/Delete Entry Form** \\ When you select an user with the selector, a form shows up that lets add a new rule or lets modify or delete the existing one.
+  - **Current ACL Rules** \\ Below the index is the table of all ACL rules set in the wiki. It lets change the permission level of the existing rules or delete rules via checkboxes in the right column.
-See also [[:ACL]].
+See for explanation of the ACL rules at [[:ACL]].
+=====Remote API to add and remove rules=====
+Since release 2013-12-08 "Binky" of DokuWiki the remote XML-RPC API is extended by this plugin with an add and delete method. See further the API description of the [[devel:xmlrpc#pluginacladdacl|plugin.acl.*]] methods.
+===== Bugs/feature requests =====
+Please refer to DokuWiki’s [[:bugs|bug tracker]] for reporting bugs or feature requests.