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

= Add an Earned Value Chart to wiki pages

== Description

This plugin will create an [wikipedia:Earned_value_management Earned Value chart] via a wiki macro for all tickets under a given milestone. This requires that a custom start and end date field be made for tickets. The date must be entered in the YYYY-MM-DD format. This includes leading zeros, eg 2012-01-01. 

This macro is useful for project management information purposes, see also ProjectManagementIdeas.

Once installed, the plugin can easily be inserted into any Trac wiki page by use of a wiki macro. The macro used is `[[EVChart(MILESTONE NAME HERE)]]`.

The start date of the chart is determined by finding the ticket with the earliest start date in the milestone and using that date. The end date of the chart is determined by the planned end date of the milestone. Ticket start and end dates should be set up such that the start day is the expected date you plan to start working on it, and the end day should be set to the date you plan to have the ticket finished. The start date of a ticket should be before or on the end date of the ticket and the end date of the ticket should be before or on the end date of the milestone.

If a chart fails to appear, you likely have some problems with the tickets in the milestone. The error message output should be able to direct you to which tickets need to be modified in order for the plugin to generate a chart correctly.

This plugin was developed by the YODA team at [http://www.msoe.edu/welcome Milwaukee School of Engineering].

== Bugs/Feature Requests

Existing bugs and feature requests for EarnedValueChartMacro are 
[report:9?COMPONENT=EarnedValueChartMacro here].

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

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

== Download

Download the zipped source from [export:earnedvaluechartmacro here].

== Source

You can check out EarnedValueChartMacro from [/svn/earnedvaluechartmacro here] using Subversion, or [source:earnedvaluechartmacro browse the source] with Trac.

== Installation

Follow these steps to globally install the plugin:
 - Check out the plugin from the repository.
 - Change directories so that you are in the `~/yoda/earnedvalue/trunk directory`.
 - Enter the command `sudo python setup.py install`.
 - Restart your web server.
 - Enable the plugin from the admin panel on all Trac environments you wish to use it on.

== Recent Changes

[[ChangeLog(earnedvaluechartmacro, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:MSOEYODA] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''