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

= Sums specified fields in custom queries

== Description

This plugin calculates the sum of specified fields, for example estimations in hours of effort. Example:

[[Image(sumfields-example.png)]]

This is useful as flexible means to sum story points or comparable numeric data for any arbitrary group of tickets such as milestones, owners, etc.

This is a !JavaScript solution (and my first published plugin), would be interested in learning better/simpler ways to achieving this functionality.

== Bugs/Feature Requests

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

If you have any issues, create a 
[/newticket?component=SumFieldsPlugin new ticket].

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

== Download

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

== Source

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

== Installation

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

Enable the plugin and specify a list of fields to sum in your `trac.ini` file:

{{{#!ini
[components]
sumfields.* = enabled

[sumfields]
fields = effort, actual_effort
}}}

== Recent Changes

[[ChangeLog(sumfieldsplugin, 3)]]

== Author/Contributors

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