[[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, border=2)]]

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.

To avoid an issue with batch modify requests (#13180), it is suggested to use Trac 1.2.2 or later ([trac:#12811]).

== 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:'''