Version 2 (modified by 12 years ago) (diff) | ,
---|
Contents
Sums specified field in Roadmap and Milestone stats
Notice: This plugin is unmaintained and available for adoption.
Description
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 fields 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 take leverage as much or little of its enhancements as desired.
Configuration
- 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
trac.ini
:[components] sumstats.* = enabled
You can alternatively use the Trac Web Admin GUI.
- Replace the
DefaultTicketGroupStatsProvider
with this plugin's newSumTicketGroupStatsProvider
as shown here:[roadmap] stats_provider = SumTicketGroupStatsProvider [milestone] stats_provider = SumTicketGroupStatsProvider
- (Optional) Configure the main
trac.ini
section:[sumstats] field = effort label = effort drilldown_label = Ticket effort query_args = col=summary,col=type,col=effort
The optional field
option specifies which field to sum. The optional drilldown_label
and 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.
Bugs/Feature Requests
Existing bugs and feature requests for SumStatsPlugin are here.
If you have any issues, create a new ticket.
Download
Download the zipped source from [download:sumstatsplugin here].
Source
You can check out SumStatsPlugin from here using Subversion, or browse the source with Trac.
Example
Here's an example trac.ini
config that combines a custom phase
field with a built-in resolution
field:
[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 closed
or 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).
Recent Changes
- 15069 by rjollos on 2015-11-25 19:40:43
-
0.9.1dev: Fix traceback when
overall_completion
isNone
The issue occurs in Trac 0.12 -
as_bool
was not as
robust as in later versions of Trac.
Fixes #12589.
- 14026 by rjollos on 2014-07-25 11:31:38
-
Changed license to 3-Clause BSD with permission of author. Refs #11832.
- 13559 by jun66j5 on 2014-01-08 21:36:13
-
Removed duplicated definitions of option to fix hidden documentation for
filter
onTracIni
macro (fixed #11480)
(more)
Author/Contributors
Author: robguttman
Maintainer: robguttman
Contributors:
Attachments (2)
- sumstats.png (29.1 KB) - added by 12 years ago.
- burndown.png (22.9 KB) - added by 12 years ago.
Download all attachments as: .zip