Differences

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

--- plugin:acl [2011-11-20 18:55] – old revision restored Aleksandr
+++ plugin:acl [2024-04-10 01:46] (current) – 69.124.234.121
@@ Line 2: / Line 2: @@
 ---- plugin ----
-description: Manage page and namespace ACL settings (bundled with DokuWiki)
+description: Manage page and namespace access control list (ACL) settings (bundled with DokuWiki)
 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
 ----
-This [[:plugins|plugin]] handles the management of access control lists for individual pages and namespaces.
+===== Description =====
-===== Download and Installation =====
+This **plugin** handles the management of access control lists for individual pages and namespaces.
-The Plugin is bundled with DokuWiki and does not need to be installed separately. The ACL Manager is accessible from the admin screen (Login as superuser, click "Admin" and choose "Access Control List Management").
-(Instructions needed for "Login" procedure.)
 ===== Usage =====
+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.
-See also [[:ACL]].
+====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 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.