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

= Grouping ticket fields using different fieldsets

== Description

This plugin allows for grouping ticket fields using different fieldsets. This is a solution for t:#10320.

The arrangement of ticket fields is specified by adding a `[group-ticket-fields]` stanza to your project's `trac.ini` file. For example, when using the following settings:

{{{#!ini
[group-ticket-fields]
additional_info = Zusatzinformationen
additional_info.fields = reproducibility,keywords,cc,customtext,svnversion,tester,blockedby,blocking,parents,billable,internal
additional_info.properties = foldable,collapsed
group_order = project,main,additional_info,project_planning
project = Projekt
project.columns = 1
project.fields = project,milestone,version
project_planning = Projektplanung
project_planning.fields = estimatedhours,hours,remaininghours,totalhours,userfinish,userstart
project_planning.properties = foldable,collapsed
}}}

then this is how 'New Ticket' welcomes you in a well-arranged style:

[[Image(newticket_grouped_colapsed.jpg, border=2)]]

Some people may be interested in additional fields:

[[Image(newticket_grouped.jpg, border=2)]]

== Bugs/Feature Requests

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

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

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

== Download

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

The plugin is also available on [pypi:TracGroupTicketFields PyPI].

== Source

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

== Installation

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

== Configuration

Example for `trac.ini` configuration:

{{{#!ini
[group-ticket-fields]
target = Target
target.fields = milestone,version
group_order = target,main
}}}

This creates a field group `Target` and assigns the fields `milestone` and `version` to it. The option name `target` is arbitrary.

`group_order` defines in which order the groups should be arranged.

== Recent Changes

[[ChangeLog(groupticketfieldsplugin, 3)]]

== Author/Contributors

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