===== Controlling read/write access to single pages ===== Wikka supports advanced **ACL** (access control lists) management for setting user privileges on single pages. Making a page //read-only//, //private//, or writable by a restricted number of users is possible by setting the appropriate privileges for the page in question. ACLs can be easily set by clicking on the //Edit ACLs// link at the bottom of the page. This link appears only when you are logged in//and// have the right to set ACLs; only the [[PageOwnership | page owner]] and Admins have this privilege. If a page isn't owned by anyone (i.e. "Nobody" is the owner) you first have to take ownership to modify the ACLs. The following fields are available: ~-**read access** list ~determines which users can read the page ~-**write access** list ~determines which users can write the page ~-**comment access** list {{until version="1.3" display="inline"}} ~determines which users can post comments on the page ~-**comment read access** list {{since version="1.3" display="inline"}} ~determines which users can read comments on the page ~-**comment post access** list {{since version="1.3" display="inline"}} ~determines which users can create comments on the page ===Screenshots=== {{until version="1.3" display="inline"}} {{image url="images/acl.png" alt="ACL handler screenshot (until 1.3)" title="Example of page-level ACL settings prior to 1.3"}} {{since version="1.3" display="inline"}} {{image url="images/acl2.png" alt="ACL handler screenshot (since 1.3)" title="Example of page-level ACL settings 1.3 and later"}} ===ACL Syntax=== The ACL fields accept the following values: ##*## = Everyone ##+## = Registered users only Or any enter individual user [[WikiName]]s | (one per line) Any of these items can be negated with a ##!## ##!*## = No one ##!+## = Anonymous users only ##!""JohnDoe""## = ""JohnDoe"" will be denied access. Be aware that the ACLs are tested in the order specified. So be sure to specify ##*## on a separate line after negating any users - not before. Otherwise, the ##*## everyone condition will always give access before the list of users that should not have access is tested. Note: setting a page to ##!*## (= No one) still allows the page owner and admins to access it. === ACL default values === Default ACL for new pages can be set in the [[ConfigurationOptions wikka configuration file]] by Wikka administrators. **Note:** Any page with no custom ACL will use the global ACL set in the [[ConfigurationOptions | wikka configuration file]]. If you later change the default ACLs in the config file, then all pages that do not already have a custom ACL set will change to the new defaults. If you decide to change the default Read ACL to ##!*## (= No one), make sure you go to your UserSettings and HomePage and set their ACLs to allow read access for at least yourself. {{since version="1.3" display="inline"}} When upgrading from a version prior to 1.3, the comment read and comment post ACLs for existing pages are assigned the old comment ACL setting. === Comment restrictions === Comment ACLs for single pages can be overridden by: ~-global [[ConfigurationOptions | ACL settings]] that can enable/disable comments on the whole wiki ~-##[[NocommentsActionInfo | {{nocomments}}]]## actions that disable comments on single pages Comments can be disabled on the whole wiki via the ##[[ConfigurationOptions | hide_comments]]## setting. ---- CategoryEN