Changes between Version 8 and Version 9 of TracJsGanttPlugin


Ignore:
Timestamp:
Dec 9, 2010 6:59:03 PM (4 years ago)
Author:
ChrisNelson
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.