wiki:ProgressMeterMacro

Version 27 (modified by qwp0, 5 years ago) (diff)

--

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 progress meter similar to the meters visible in the Roadmap within a wiki page what can be used, for example, for building complete report of the progress on tickets owned by a particular person. The ProgressMeter macro works with the same arguments as TicketQuery macro -- except the argument status, which is ignored (#status-arg).

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

Configuration

The macro supports the following configuration options:

  • stats_provider (since r5224): Name of the component implementing ITicketGroupStatsProvider, which is used to collect statistics on groups of tickets for meters generated by the ProgressMeterMacro plugin. (You probably don't need to change this.)

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 r5224. If you want to define which ticket states are considered closed have a look at the appropriate section of trac.ini instead.

Download

Download the zipped source from here. (Please note that the attachments are obsolete.)

Source

You can check out ProgressMeterMacro from here using Subversion, or browse the source with Trac.

Installation

See wiki:TracPlugins#InstallingaTracPlugin for the installation instructions.

Bugs/Feature Requests

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

Recent Changes

[11720] by qwp0 on 2012-07-10 01:24:20
ProgressMeterMacro: Version bump.
[11719] by qwp0 on 2012-07-10 01:24:15
ProgressMeterMacro: Major code revision and unification across the supported Trac versions.
[11718] by qwp0 on 2012-07-09 16:42:44
ProgressMeterMacro: A friendlier message when previewing in a self-addressed non-existent ticket.

Author/Contributors