Help:SemanticACL

{{TOC right}}<div style="background: black;">This extension allows read and edit restrictions to be set on pages using SMW properties.

==Usage==

To set restrictions, mark up a page with the appropriate properties.

To set ''read'' restrictions, use these properties:
* <nowiki>[[Visible to::]]</nowiki>
* <nowiki>[[Visible to user::]]</nowiki>
* <nowiki>[[Visible to group::]]</nowiki>

To set ''edit'' restrictions (which apply to all other actions), use these ones:
* <nowiki>[[Editable by::]]</nowiki>
* <nowiki>[[Editable by user::]]</nowiki>
* <nowiki>[[Editable by group::]]</nowiki>

The "main" property (<tt>Editable by</tt> or <tt>Visible to</tt>) can take one or more of these values. With the exception of "public", a user must satisfy '''all''' conditions set.
* <tt>public</tt> — overrides all other values and never denies access.
* <tt>users</tt> — denies access to users who are not logged in.
* <tt>whitelist</tt> — denies access to all users who are not whitelisted, either explicitly or by being in a whitelisted group.

The read and edit restrictions have separate whitelists. You can add one or more users or groups to the whitelist using the appropriate properties. Note that the <tt>User:</tt> prefix is '''mandatory''' for the single-user whitelist.


=== Example ===
These properties, included on a page, would allow only users in the "moderator" group to read the page, and only the user "Chief Moderator" to edit it.
<pre>
[[Visible to::whitelist]]
[[Visible to group::moderator]]

[[Editable by::whitelist]]
[[Editable by user::User:Chief Moderator]]
</pre>


===User rights===
Users who have the <tt>sacl-exempt</tt> user group are never prohibited access by this extension. This is a failsafe to avoid pages becoming permanently uneditable by having an empty whitelist.

</div>