= ProgressMeter macro =

== Description ==

This macro plugin was created due to the task created for GHOP/Python Software Foundation (http://code.google.com/p/google-highly-open-participation-psf/issues/detail?id=256).

This plugin enables the macro users to display progress meter similar to the meters visible in the Roadmap. The ProgressMeter macro works with the same arguments as TicketQuery macro (available in the standard Trac distribution) -- except 'status' argument logically. It can be used for example for building complete report of the progress on tickets owned by a particular person. Actually the macro just counts the tickets matching given criteria and shows the meter (closed-to-active-tickets ratio).

Longer description can be found at the mentioned web page of GHOP task.

== Download & Installation ==

'''Available versions for download:'''
 * Current egg file (v0.1a): attachment:TracProgressMeterMacro-0.1a-py2.5.egg

'''Source:'''
You can check out ProgressMeterMacro from [http://trac-hacks.org/svn/progressmetermacro here] using Subversion, or [source:progressmetermacro browse the source] with Trac.

Download egg file and copy/move it to ''[your trac env dir]''/plugins directory. Then edit your trac.ini configuration file so it will contain these lines:
{{{
[components]
progressmeter.* = enabled
}}}

For other options of installing Trac plugins see [http://trac.edgewall.org/wiki/TracPlugins#InstallingaTracPlugin basic plugin installation documentation].

== Examples ==

Displays meter of progress on tickets owned by 'qwp0' within milestone '0.1a':
{{{
[[ProgressMeter(owner=qwp0, milestone=0.1a)]]
}}}

Display meter of progress on tickets associated with component 'wiki':
{{{
[[ProgressMeter(component=wiki)]]
}}}

== Bugs/Feature Requests == 

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=ProgressMeterMacro&owner=qwp0 new ticket].

== Recent Changes ==

[[ChangeLog(progressmetermacro, 3)]]

== Planned features / Todo ==
 * 'ticket_value' argument
 * separate stylesheet

== Author/Contributors ==

'''Author:''' [wiki:qwp0]