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

= Add permissions to restrict access to individual reports

== 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.

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.

=== Updates

In version 0.2 I made the plugin conform 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.

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Example

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

[[Image(PrivateReportAdmin-Trac1.0.png)]]


The first report is not visible:

[[Image(privatereports_reports.png)]]


If a user tries to access the report via changes in the url, then he/she gets this message:

[[Image(private_reports_no_perm.png)]]

== Recent Changes

[[ChangeLog(privatereportsplugin, 3)]]

== Author/Contributors

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