|Version 6 (modified by 5 years ago) (diff),|
Sums specified field in Roadmap and Milestone stats
This is a complement to the Sum Fields plugin which sums fields in a query or report. This plugin sums fields for the roadmap and milestone views. These plugins are useful when assessing progress based on "points" or "ideal days" of effort instead of ticket count.
This plugin was inspired by the CustomRoadmapPlugin but overcomes its limitation of requiring a patch. Additionally, this plugin allows for any field to be used to define a group, not just the default
status field. Lastly, I designed the plugin to be backwards compatible with the default ticket count behavior so that you can leverage as much or little of its enhancements as desired.
- Install the plugin (after downloading and unzipping):
cd sumstatsplugin/0.12 sudo python setup.py install
See TracPlugins for more installation details and options. You'll likely need to restart Trac's web server after installation.
- Enable the plugin in
[components] sumstats.* = enabled
You can alternatively use the Trac Web Admin GUI.
- Replace the
DefaultTicketGroupStatsProviderwith this plugin's new
SumTicketGroupStatsProvideras shown here:
[roadmap] stats_provider = SumTicketGroupStatsProvider [milestone] stats_provider = SumTicketGroupStatsProvider
- (Optional) Configure the main
[sumstats] field = effort label = effort drilldown_label = Ticket effort query_args = col=summary,col=type,col=effort
field option specifies which field to sum. The optional
label are used to define the
TicketGroupStats object. The optional
query_args is a convenient, comma-delimited list that gets appended to each group's
query_args. See the examples below for more details.
If you have any issues, create a new ticket.
Download the zipped source from [download:sumstatsplugin here].
Here's an example
trac.ini config that combines a custom
phase field with a built-in
[milestone-groups] closed = fixed closed.field = resolution closed.label = fixed closed.order = 1 closed.overall_completion = true readying = * readying.field = phase readying.order = 2 readying.color = YellowGreen implementation = implementation implementation.field = phase implementation.order = 3 implementation.color = Yellow waiting = waiting waiting.field = phase waiting.order = 4 waiting.color = White scoping = sizing,definition scoping.field = phase scoping.order = 5 scoping.color = Red
In general, the plugin maintains the same syntax and semantics as the
DefaultTicketGroupStatsProvider to support backwards compatibility and ease of transition. If the
.field option is omitted, then the
status field is presumed. Note that a
.color option is required for each group (except for any default
new group you have). The "catch all"
* value is also still supported (although there are currently no checks for duplicate "catch all" or otherwise redundant group definitions).
- 15069 by rjollos on 2015-11-25 20:40:43
0.9.1dev: Fix traceback when
The issue occurs in Trac 0.12 -
as_boolwas not as
robust as in later versions of Trac.
- 14026 by rjollos on 2014-07-25 13:31:38
Changed license to 3-Clause BSD with permission of author. Refs #11832.
- 13559 by jun66j5 on 2014-01-08 22:36:13
Removed duplicated definitions of option to fix hidden documentation for
TracInimacro (fixed #11480)