Progress meter with arguments similar to TicketQuery macro

Description

This macro plugin was created because of this task for GHOP/Python Software Foundation.

It contains a macro to display a progress meter similar to the meters visible in the Roadmap. In a wiki page it can be used, for example, for building a complete report of the progress on tickets owned by a particular person. The ProgressMeter macro works with the same comma-separated list of keyed parameters (named fields of a ticket) as the TicketQuery macro, except the argument status and format.

For more complex progress statistics and metrics, see TracMetrixPlugin.

Usage examples

Display a progress meter on all your (if you're logged in) tickets in the milestone '0.1a': 

[[ProgressMeter(owner=$USER, milestone=0.1a)]]

A progress meter on tickets associated with the wiki component: 

[[ProgressMeter(component=wiki)]]

Since [10572], it's possible to customize the used stats provider in a macro call itself using the stats_provider argument: 

[[ProgressMeter(keywords~=needinfo, stats_provider=CustomStatsProvider)]]

Configuration

The macro supports the following configuration options:

  • stats_provider (since [5224]): Name of the component implementing ITicketGroupStatsProvider, which is used to collect statistics on groups of tickets for meters generated by the ProgressMeterMacro plugin. Defaults to DefaultTicketGroupStatsProvider.

All of these must be put into the progressmeter section of trac.ini. The progress bars themselves can be modified using wiki:TracIni#milestone-groups-section.

The status argument

The status argument is ignored since [5224] triggers an error since [8558]. If you want to define which ticket states are considered closed have a look at the appropriate section of trac.ini instead.

Download

  • Subversion repo: svn checkout https://trac-hacks.org/svn/progressmetermacro
  • Git mirror: git clone git://github.com/andrejtokarcik/trac-progressmetermacro.git
  • zip archive
  • source browser

Installation

See wiki:TracPlugins#InstallingaTracPlugin for the installation instructions. Please note that Trac 0.11.5 is a minimum requirement in order for the plugin to work.

Bugs/Feature Requests

Existing bugs and feature requests for ProgressMeterMacro are here. If you have any issues, create a new ticket.

Recent Changes

[10969] by rjollos on 12/01/11 10:56:38

Added plugin revision info to webadmin page.

[10855] by qwp0 on 11/01/11 01:17:48

ProgressMeterMacro: added class to div, needed in 0.13dev

[10854] by qwp0 on 11/01/11 01:17:41

ProgressMeterMacro: pass req to _parse_macro_content

[10575] by qwp0 on 08/09/11 03:28:07

ProgressMeterMacro: setup.py bugfix

Author/Contributors