[[PageOutline(2-5,Contents,pullout)]]

= Plugin to render burndown SVG images

'''Links:'''
[query:status!=closed&component=TimeVisualizerPlugin&order=priority open #]
| [http://trac-hacks.org/newticket?component=TimeVisualizerPlugin&owner=mape new #]
| [/svn/timevisualizerplugin svn]
| [browser:timevisualizerplugin browse]

== Description

This component draws customizable burndown graphs from ticket history provided by TimingAndEstimationPlugin. Dynamic graphs can be easily embedded to wiki pages.

Developed and tested with Trac 0.10.4, Python 2.4, sqlite, mod_python and Apache on Windows. The 0.6 version works on Trac 0.11.

== Bugs/Feature Requests

Existing bugs and feature requests for TimeVisualizerPlugin are [query:?status=new&status=assigned&status=reopened&group=&component=TimeVisualizerPlugin&order=priority here].

If you have any issues, create a [/newticket?component=TimeVisualizerPlugin new ticket].

[[TicketQuery(component=TimeVisualizerPlugin,group=type,format=progress)]]

== Installation

'''Dependencies:''' TimingAndEstimationPlugin was needed in 0.4 and earlier versions to feed database with estimates and totalhours custom tickets. Browser must render SVG natively and support the html tag iframe. Latest Firefox, Opera and Safari browser versions should work.

 1. Get source installation & install it
{{{#!sh
svn co http://trac-hacks.org/svn/timevisualizerplugin/branches/TimeVisualizer_0.6
cd TimeVisualizer_0.6
python setup.py install
}}}
 2. Edit your `trac.ini` file and modify components section:
{{{#!ini
[components]
<...other components...>
tractimevisualizerplugin.* = enabled
}}}
 3. Restart server to propagate changes.

For details, see browser:/timevisualizerplugin/branches/TimeVisualizer_0.6/release_notes.txt

== Usage

To test graphs & filtering, access "http://server:port/path_to_trac_env/tractimevisualizer". It will render hours from whole project life cycle.

More practical is to get graphs from some certain time frame and filter hours based on milestone and/or component. This is achieved with macro !BurnDown (wrote this plugin to replace ScrumBurndownPlugin because its graphing capabilities were limited and it modifies the database schema).

In my example project, I have wiki page with following content:
{{{
[[BurnDown(width=800,height=200,query=targetmilestone=mile1&datestart=08/8/07&dateend=8/22/07)]]

[[BurnDown(width=400,height=200,query=targetmilestone=mile1&datestart=08/8/07&dateend=8/15/07)]]
[[BurnDown(width=400,height=200,query=targetmilestone=mile1&datestart=08/15/07&dateend=8/22/07)]]
}}}

It renders the following graphs (picture is cropped to fit better on this page)

[[Image(TracTimeVisualizerPlugin_ss1.PNG)]]

[[Image(0.7_screenshot.png)]]

For more, see browser:/timevisualizerplugin/branches/TimeVisualizer_0.6/release_notes.txt

== Feedback

[wiki:TimeVisualizerPlugin/FeedBack Feel free to give feedback]

== Recent Changes

[[ChangeLog(timevisualizerplugin, 5)]]

== Author/Contributors

'''Author:''' [wiki:mape] (thtv08 _at_ gmail.com) [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:''' [[BR]]