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

= Hide ticket field values

== Description

This plugin allows masking ticket field values (for all drop-down fields) based on users/groups. Basically think of this as the big brother of the SimpleTicketPlugin. Activate the filtering on a user or group by giving them the `TICKET_HIDEVALS` permission.

You can configure which fields to mask under the Web administration interface. All fields are hidden by default as soon as a user has {{{TICKET_HIDEVALS}}} permissions, you must explicitly allow what you want each group to see. If a user has no visible options for a field, it will be hidden entirely. 

**Note:** filtering on the query page doesn't work for Trac >= 1.4, so it's a ticket filter plugin for those versions.
== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=HideValsPlugin new ticket].

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

== Download

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

The plugin is also available on [pypi:TracHideVals PyPi].

== Source

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

== Installation

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

To enable this plugin, add the following to your `trac.ini` file:
{{{#!ini
[components]
hidevals.* = enabled
}}}

== Configuration
Here are a few examples.

=== Custom selection of Components
1. Create a group {{{comp}}}
1. Give the group permission {{{TICKET_HIDEVALS}}}
1. Assign one or more components to the group using the ''Hide Values'' admin page
1. Add user {{{Tester}}} to group {{{comp}}}

The user {{{Tester}}} now only sees the ''component'' drop-down box with the assigned components. All other drop-down boxes are hidden.

If you remove the user from the group all drop-down boxes are visible again.

=== Hide all drop-down boxes 
1. Create a group {{{hideboxes}}}
1. Give the group permission {{{TICKET_HIDEVALS}}}
1. Add users to group {{{hideboxes}}}

For every user who is member of group {{{hideboxes}}} all drop-down boxes are hiden.
== Recent Changes

[[ChangeLog(hidevalsplugin, 3)]]

== Author/Contributors

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