[[PageOutline(2-5,Contents,pullout)]]
= Display or hide parts of wiki pages based on permissions  =

== Description ==

The Trac Access macro allows parts of wiki pages to be displayed or hidden depending on the permissions granted to a user viewing the page. It has two variants:

 * Make a block of wiki text visible only to users with one of a specified list of permissions.
 * Hide a block of wiki text for users with one of a specified list of permissions.

Limitations: 
 * This will not be effective in hiding text from users with `WIKI_EDIT` permission, as they will see the text when editing the page (#5492).
 * Access control is not enforced for the wiki history and exported formats (#5554).

== Bugs/Feature Requests == 

Existing bugs and feature requests for AccessMacro are 
[report:9?COMPONENT=AccessMacro here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=AccessMacro&owner=turkanis new ticket].

== Download ==

Download the zipped source from [download:accessmacro here].

== Source ==

You can check out AccessMacro from [http://trac-hacks.org/svn/accessmacro here] using Subversion, or [source:accessmacro browse the source] with Trac.

== Example ==

{{{
This is seen by everyone

{{{
#!access
#allow(TICKET_ADMIN, MILESTONE_ADMIN)

This is seen only by users with one of the permissions TICKET_ADMIN or MILESTONE_ADMIN
}}}

{{{
#!access
#deny(REPORT_VIEW)

This is seen only by users who do not have the REPORT_VIEW permission
}}}

[[access(deny(REPORT_VIEW), This is an alternate syntax)]]

}}}

== Recent Changes ==

[[ChangeLog(accessmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:turkanis] [[BR]]
'''Maintainer:''' [wiki:turkanis] [[BR]]
'''Contributors:'''