= 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). 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:[[BR]]
Current egg file: attachment:TracProgressMeterMacro-0.1a-py2.5.egg

For the newest version of ProgressMeter macro plugin you can check out [#Source subversion repository].

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

== Source ==

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

== Example ==

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)]]

== Author/Contributors ==

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