= !ProgressMeter macro =

== Description ==

This macro plugin was created because of [http://code.google.com/p/google-highly-open-participation-psf/issues/detail?id=256 this task] for GHOP/Python Software Foundation.

It contains a macro to display progress meter similar to the meters visible in the Roadmap within a wiki page. The !ProgressMeter macro works with the same arguments as !TicketQuery macro -- except 'status' argument logically (which is handled differently, see [#usage usage]). 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).

A longer description is available at the mentioned web page of GHOP task.

== Download ==

Download the zipped source from [download:progressmetermacro here]. (Please note that attachments are obsolete and so they don't provide full functionality.)

== Source ==

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

== Usage examples == #usage

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

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

Using the {{{status}}} arg you can define statuses which will be considered as closed, separated by '|'. The 'closed' status is not default -- you have to specify it explicitly if you want it to be inclosed with the other statuses. Also, at the moment you can't use this arg as the only one.
{{{
[[ProgressMeter(status=closed|ready for QA, owner=$USER)]]
}}}

== Bugs/Feature Requests ==

Existing bugs and feature requests for ProgressMeterMacro are [query:status!=closed&component=ProgressMeterMacro&order=priority here]. If you have any issues, create a [/newticket?component=ProgressMeterMacro&owner=qwp0 new ticket].

== Recent Changes ==

[[ChangeLog(progressmetermacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:qwp0][[br]]
'''Thanks to:''' [http://www.doughellmann.com/ Doug Hellmann], [http://trac.edgewall.org/wiki/OddSimonSimonsen Odd Simon Simonsen], Russell Sim