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

= Group sets of related fields together =

== Description ==

Adds support for grouping sets of related ticket fields together, both in the change properties section of the ticket page as well as in the ticket box section.  Provides an admin console for easy management of fieldgroups.

== Bugs/Feature Requests == 

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

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

== Download ==

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

== Source ==

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

== Example ==

This first image shows the effect that the plugin has on the ticket box.  The fields "Begin Date" and "Due Date" have been grouped together in the "Deadlines & Signoff" group, while the field "Repository URL" field has been grouped into the "Information" group.  A header is created for each group and then the fields are listed one per line.  The values (none are shown here) would be displayed along the right-hand side of the table.

[[Image(FieldGroups_ticket_box.png,75%)]]

The next image show how the groups are broken out into separate fieldsets under the standard "Change Properties" fieldset in the "Modify" section of the ticket.

[[Image(FieldGroups_fieldsets.png,75%)]]

An admin console similar to the standard AdminEnum interface is provided for adding, removing, and re-ordering the field groups.  The "order" specifies the sequence in which the groups are displayed in both the ticket box and the change properties section.

[[Image(FieldGroups_admin_groups.png,75%)]]

Individual field groups are managed using a jQuery datatable.  Fields are added or removed from the group using this table (accessible by clicking the field group's link on the main FieldGroups admin console).

[[Image(FieldGroups_admin_fields.png,75%)]]

== Recent Changes ==

[[ChangeLog(fieldgroupsplugin, 3)]]

== Author/Contributors ==

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