[[PageOutline(2-5,Contents,pullout)]]

= Add permissions to restrict access to individual reports

{{{#!box info
**Notice:** An alternate implementation using TracFineGrainedPermissions is discussed in #11049 and effectively does the same thing as this plugin. Due to some defects in Trac, TracFineGrainedPermissions only work for the report realm in Trac 1.0.2 and later. If you are running Trac 1.0.2 or later, you may want to consider using TracFineGrainedPermissions rather than this plugin.
}}}

== Description

This plugin can be used to restrict users to see only specific reports. The plugin lets you choose permissions for each report. The users have to have at least one of the permissions to be able to see it on the 'Available Reports' page and to access it directly.

In version 0.2 the plugin conforms to the Trac standard of allowing only all uppercase for permissions. This requires a new table structure, which means you have to enter the permission for each report again.

How to choose the permissions or groups needed to view a report:

[[Image(PrivateReportAdmin-Trac1.0.png, border=2)]]

The first report is not visible:

[[Image(privatereports_reports.png, border=2)]]

If a user tries to access the report via changes in the url, then (s)he will get message:

[[Image(private_reports_no_perm.png, border=2)]]

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=PrivateReportsPlugin&cc=rjollos new ticket].

[[TicketQuery(component=PrivateReportsPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:privatereportsplugin here].

== Source

You can check out PrivateReportsPlugin from [/svn/privatereportsplugin here] using Subversion, or [source:privatereportsplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(privatereportsplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:mhenke] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [wiki:rjollos]