Changes between Version 8 and Version 9 of TracJsGanttPlugin


Ignore:
Timestamp:
Dec 9, 2010, 5:59:03 PM (13 years ago)
Author:
Chris Nelson
Comment:

Notes about computing start date from finish and estimate.

Legend:

Unmodified
Added
Removed
Modified

  • TracJsGanttPlugin

    v8 v9  
    66
    77A plugin which allows Trac ticket data to be displayed in a [http://jsgantt.com jsGantt] chart in a wiki page.  Tasks and milestones are links to the corresponding ticket or milestone.
     8
     9Configurable field names allow integration with other plugins such as MasterTicketsPlugin (for dependencies) and TimingAndEstimationPlugin (for estimated and total hours).
    810
    911== Bugs/Feature Requests ==
    … …  
    4648== Example ==
    4749
    48 `[[TracJSGanttChart(milestone=Test)]]` displays all the tickets in the Test milestone.  `[[TracJSGanttChart(sample=1)]]` displays the sample project from jsgantt.com.
     50`[[TracJSGanttChart(sample=1)]]` displays the sample project from jsgantt.com.  `[[TracJSGanttChart(milestone=Test)]]` displays all the tickets in the Test milestone.
    4951
    5052[[Image(jsGanttSample.PNG)]]
    … …  
    5456Trac-jsGantt is intended to be flexible enough to get data from various plugins by configuring the field names for those plugins in `trac.ini`.  It is known to work with TimingAndEstimationPlugin (for estimated and total hours), MasterTicketsPlugin (for FS dependencies), and [http://github.com/itota/trac-subtickets-plugin Subtickets] for parent/child relationships.  Custom fields for start and finish date are also supported.
    5557
    56 Tasks are colored based on ticket priority consistent with the colors used in Trac reports.
     58Tasks are colored based on ticket attributes.  When colored by priority colors  are consistent with the colors used in Trac reports.  Other coloring choices (e.g., by milestone or owner) use arbitrary, unique colors.
    5759
    5860Your `trac.ini` may include:
    … …  
    6365fields.estimate = estimatedhours
    6466fields.worked = totalhours
     67# Each unit in estimate is 1/8 of a day
     68days_per_estimate = 0.125
    6569# To work with Master Tickets for dependencies
    6670fields.pred = blockedby
    … …  
    8589
    8690When `start` and `finish` are configured, the plugin uses them to set task start and finish dates.  The `date_format` field is a Python `strptime()` format specifier which describes the contents of `start` and `finish`.  If these fields are not configured, all tasks end today and have a 1-day duration.
     91
     92When `estimate` and `finish` are both configured (and `start` is not configured or not on the ticket), the plugin attempts to determine the start of the task from  `finish` and `estimate` as `start = finish - estimate` with consideration for weekends and hours per day.
    8793
    8894The `milestone_type` may be used to have a custom ticket type show up as milestones on the chart.  If this field is not specified, only Trac milestones are displayed as milestones.