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

= Filter custom fields on a per-ticket basis

== Description

This plugin allows you to display or hide specific fields for a ticket. It adds support for filtering displayed custom fields on a per-ticket basis. This is useful for omitting fields that don't apply to specific ticket types. Rather than simply hiding the fields, it removes them from the transmitted data altogether, thus making page rendering and subsequent plugin evaluation faster. It works by adding a custom field responsible for keeping track of which fields should be displayed. For users with `TRAC_ADMIN`, `TICKET_ADMIN` or `TICKET_FIELD_ADMIN` permission, a jQuery datatable is displayed just below the standard Trac properties fieldset that is used to manage which fields are displayed.

In addition, the ticket types admin console is extended with a similar data table that allows for templating of standard ticket types. In this way, `/newticket?type=foo` will display only the selected fields for that type.

Per-ticket field management with jQuery datatable, where only the checked custom fields appear in the properties fieldset:

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

Ticket type template via admin console:

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

== Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

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

== Recent Changes

[[ChangeLog(ticketfieldsplugin, 3)]]

== Author/Contributors

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