= Customising Trac Roadmap Ticket Groups =
[[TracGuideToc]]

By default, the roadmap shows a list of future milestones with the tickets targeted against a milestone aggregated, and the ratio between active and resolved tickets displayed as a milestone progress bar.  For the default workflow this is often sufficient, however with the ability to create custom workflows, it becomes necessary to be able to show further detail on the roadmap progress bar.

[[Image(TracRoadmapBar.png)]]

Configuring the roadmap to show additional groupings in the progress bar is achieved by editing the [wiki:TracIni#milestone-groups-section trac.ini] file.  This file should already have a section which reads:

{{{#!ini
[milestone]
stats_provider = DefaultTicketGroupStatsProvider
}}}

In order to change the default grouping, which simply counts tickets as either 'closed' or 'active', we need to add a new section to trac.ini entitled `[milestone-groups]`.  In this example we add a new group for the 'in_QA' status, included in the custom workflow.

{{{#!ini
[milestone-groups]
# The definition consists in a comma-separated list of accepted status.
# Also, '*' means any status and could be used to associate all remaining
# states to one catch-all group.
# Qualifiers for the above group (the group must have been defined first):

# Definition of a 'closed' group:
closed = closed
closed.order = 1
closed.query_args = group=resolution
closed.overall_completion = true 

# Definition of an 'in testing' group:                                 
inQA = in_QA
inQA.order = 2
inQA.css_class = new
inQA.label = in testing

# Definition of an 'active' group:
active = *
active.order = 3
active.css_class = open
active.label = in progress

# The CSS class can be one of: new (yellow), open (no color) or
# closed (green). New styles can easily be added using the following
# selector:  `table.progress td.<class>`
}}}

The following parameters are used in the [milestone-groups] section:

||`<groupname>`||A comma separated list of statuses that match this group.  The '*' can be used once and will match all statuses not yet assigned||
||`<groupname>.order`||The sequence number in the progress bar||
||`<groupname>.query_args`||Optional extra parameter for the query||
||`<groupname>.overall_completion`||true/false - count in the overall completion statistic||
||`<groupname>.css_class`||CSS class to use for this interval, defaults available are: new (yellow), open (no color) or closed (green). New styles can easily be added using the following selector:  `table.progress td.<class>`||
||`<groupname>.label`||Displayed name for the group||


----
See also: TracRoadmap, TracTickets, [TracIni#milestone-groups-section TracIni], CookBook/Configuration/Workflow