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

= Categorizing ticket fields in Trac

== Description

This plugin's purpose is to categorize ticket fields.

This plugin can help in the follow situations:
* Your ticket has a lot of fields.
* The fields of your ticket is varying in different conditions.
* Some fields of a ticket should only be visible to authorized user (not implemented).

[[Image(ticket-view.PNG)]]
[[Image(ticket-edit.PNG)]]

== !Bugs/Feature Requests

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

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

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

== Download

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

== Source

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

== Installation

1. Install the plugin just like any other
2. Set up the trac.ini
 1. In [components] section, add:{{{catagorizedfields.catagorizedfields = enabled}}}
 2. Create a {{{[catagorized-fields]}}} section, and adds the catagories. e.g.:
{{{
[catagorized-fields]
# declare a catagory in syntax "(catagory_id) = (catagory_display_name)"
cat1 = catagory_one

# specify the hide condition in syntax "(catagory_id).hide_when_(condition-field) = (field-value1)[, (field-value2), ..]"
cat1.hide_when_status = new, closed

# the order of catagory, the smaller the index is, the more the catagory is close to top
cat1.index = 1
}}}
 3. In {{{[ticket-custom]}}} section, specify your fields with catagory property:
{{{
[ticket-custom]
custom_field1 = text

# declare one field with catagory in syntax "(field_id).catagory = (catagory_id)"
custom_field1.catagory = cat1

# the order of field, the smaller the index is, the more the field is close to top
custom_field1.index = 1
}}}

== Recent Changes

[[ChangeLog(catagorizedfieldsplugin, 3)]]

== !Author/Contributors

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