Changes between Version 26 and Version 27 of TracJsGanttPlugin


Ignore:
Timestamp:
Nov 5, 2011, 3:27:03 AM (13 years ago)
Author:
Adrian Fritz
Comment:

Organize options alphabetically, more example options in configuration file. Formatting.

Legend:

Unmodified
Added
Removed
Modified
  • TracJsGanttPlugin

    v26 v27  
    1919The chart display can be controlled with a number of macro arguments:
    2020
    21 ||Argument      ||Version       ||Description   ||Default
    22 || `formats`||||What to display in the format control.  A pipe-separated list of `minute`, `hour`, `day`, `week`, `month`, and `quarter` (though `minute` may not be very useful). ||`day|week|month|quarter`||
    23 || `format`|| ||Initial display format, one of those listed in `formats` || First format ||
    24 || `sample`|| ||Display sample tasks (1) or not (0) || 0 ||
    25 || `res`|| ||Show resource column (1) or not (0) || 1 ||
    26 || `dur`|| ||Show duration colunn (1) or not (0) || 1 ||
    27 || `comp`|| ||Show percent complete column (1) or not (0) || 1 ||
    28 || `caption`|| ||Caption to place to right of tasks: None, Caption, Resource, Duration, %Complete || Resource ||
    29 || `startDate`|| ||Show start date column (1) or not (0) || 1 ||
    30 || `endDate`|| ||Show end date column (1) or not (0) || 1 ||
    31 || `dateDisplay`|| ||Date display format: 'mm/dd/yyyy', 'dd/mm/yyyy', or 'yyyy-mm-dd' || 'mm/dd/yyyy' ||
    32 || `openLevel`|| ||Number of levels of tasks to show.  1 = only top level task.  || 999 ||
    33 || `expandClosedTickets`||0.9||Show children of closed tickets (1) or collapse the subtree (0).|| 1 ||
    34 || `colorBy`|| ||Field to use to choose task colors.  Each unique value of the field will have a different color task.  Other likely useful values are owner and milestone but any field can be used. || priority ||
    35 || `root`|| ||When using something like Subtickets plugin to maintain a tree of tickets and subtickets, you may create a Gantt showing a ticket and all of its descendants with `root=<ticket#>`.  The macro uses the configured `parent` field to find all descendant tasks and build an `id=` argument for Trac's native query handler.[[br]][[br]]Multiple roots may be provided like `root=1|12|32`.[[br]][[br]]When used in a ticket description or comment, `root=self` will display the current ticket's descendants.|| ||
    36 || `goal`|| 0.9 ||When using something like MasterTickets plugin to maintain ticket dependencies, you may create a Gantt showing a ticket and all of its predecessors with `goal=<ticket#>`.  The macro uses the configured `succ` field to find all predecessor tasks and build an `id=` argument for Trac's native query handler.[[br]][[br]]Multiple goals may be provided like `goal=1|12|32`.[[br]][[br]]When used in a ticket description or comment, `goal=self` will display the current ticket's predecessors.|| ||
    37 || `lwidth`|| ||The width, in pixels, of the table of task names, etc. on the left of the Gantt. || ||
    38 || `showdep`||||Show dependencies (1) or not (0)||1||
    39 || `userMap`||0.8||Map user IDs to full names (1) or not (0).||1||
    40 || `omitMilestones`||0.8||Show milestones for displayed tickets (0) or only those specified by `milestone=` (1)||0||
     21||'''Argument'''  ||'''Version'''  ||'''Description'''  ||'''Default'''
     22|| `caption`|| ||Caption to place to right of tasks: None, `Caption`, `Resource`, `Duration`, `%Complete` || `Resource` ||
     23|| `comp`|| ||Show (`1`) percent complete column, or do not (`0`). ||  `1`  ||
     24|| `colorBy`|| ||Field to use to color tasks.  Useful fields are `priority`, `owner` and `milestone` but any field can be used. || `priority` ||
     25|| `dur`|| ||Show (`1`) duration colunn, or do not (`0`). ||  `1`  ||
     26|| `dateDisplay`|| ||Format to display dates: `mm/dd/yyyy`, `dd/mm/yyyy`, or `yyyy-mm-dd` ||  `mm/dd/yyyy`  ||
     27|| `endDate`|| ||Show (`1`) end date column, or do not (`0`). ||  `1`  ||
     28|| `expandClosedTickets`||0.9||Show (`1`) children of closed tickets in the task hierarchy or collapse the subtree (`0`). ||  `1`  ||
     29|| `format`|| ||Initial display format, one of those listed in `formats` ||  `day`  ||
     30|| `formats`||||Formats to show for Gantt chart.  A pipe-separated list of `minute`, `hour`, `day`, `week`, `month`, and `quarter`. || `day|week|month|quarter` ||
     31|| `goal`|| 0.9 ||Ticket(s) to show predecessors of. When using something like MasterTicketsPlugin to maintain ticket dependencies, you may create a Gantt showing a ticket and all of its predecessors with `goal=<ticket#>`.  The macro uses the configured `succ` field to find all predecessor tasks and build an `id=` argument for Trac's native query handler.[[br]][[br]]Multiple goals may be provided like `goal=1|12|32`.[[br]][[br]]When used in a ticket description or comment, `goal=self` will display the current ticket's predecessors.||  None ||
     32|| `hoursPerDay`|| ||Hours worked per day ||  `8.0`  ||
     33|| `lwidth`|| ||Width (in pixels) of left table (The one contains task names, etc. on the left of the Gantt chart.) ||  None  ||
     34|| `omitMilestones`||0.8||Show milestones for displayed tickets (`0`) or only those specified by `milestone=` (`1`). ||  `0`  ||
     35|| `openLevel`|| ||How many levels of task hierarchy to show open.  `1` = only top level task.  ||  `999`  ||
     36|| `res`|| ||Show (`1`) resource column, or do not (`0`). ||  `1`  ||
     37|| `root`|| ||Ticket(s) to show descendants of. When using something like Subtickets plugin to maintain a tree of tickets and subtickets, you may create a Gantt showing a ticket and all of its descendants with `root=<ticket#>`.  The macro uses the configured `parent` field to find all descendant tasks and build an `id=` argument for Trac's native query handler.[[br]][[br]]Multiple roots may be provided like `root=1|12|32`.[[br]][[br]]When used in a ticket description or comment, `root=self` will display the current ticket's descendants.||  None  ||
     38|| `sample`|| ||Display (`1`) sample tasks in Gantt, or do not (`0`) ||  `0`  ||
     39|| `schedule`|| ||Schedule algorithm: as-last-as-possible (`alap`) or as-soon-as-possible (`asap`) ||  `alap`  ||
     40|| `showdep`|| ||Show (`1`) dependencies in Gantt, or do not (`0`). ||  `1`  ||
     41|| `startDate`|| ||Show (`1`) start date column, or do not (`0`). ||  `1`  ||
     42|| `userMap`||0.8||Map (`1`) user IDs to full names, or do not (`0`). ||  `1`  ||
    4143
    4244Site-wide defaults for macro arguments may be set in `trac.ini`.  `option.<opt>` overrides the built-in default for `<opt>` from the table above.
    4345
    4446All other macro arguments are treated as TracQuery specification (e.g., milestone=MS1|MS2) to control which tickets are displayed.
     47
    4548
    4649== Installation ==
     
    4952 1. '''Install''' globally with:
    5053{{{
    51   sudo easy_install http://trac-hacks.org/svn/tracjsganttplugin/0.11/
     54  sudo easy_install https://trac-hacks.org/svn/tracjsganttplugin/0.11/
    5255}}}
    5356 1. '''Enable''' the plugin by updating TracIni file (..../trac.ini) as follows:
     
    6063  [trac-jsgantt]
    6164  # To work with Timing and Estimation for percent complete
     65  ## Ticket field to use as the data source for estimated work (default: None)
    6266  fields.estimate = estimatedhours
     67  ## Ticket field to use as the data source for completed work (default: None)
    6368  fields.worked = totalhours
    6469  # Each unit in estimate is 1/8 of a day
    6570  days_per_estimate = 0.125
    6671  # To work with Master Tickets for dependencies
     72  ## Ticket field to use as the data source for predecessor list
    6773  fields.pred = blockedby
     74  ## Ticket field to use as the data source for successor list
    6875  fields.succ = blocking
    6976  # To work with Subtickets for parent/child relationships
     77  ## Ticket field to use as the data source for the parent parent_format', '%s', Format of ticket IDs in parent field (default: None).
    7078  fields.parent = parents
    7179  #
     
    7482  #
    7583  # Custom fields for start and due dates
     84  ## Ticket field to use as the data source for start date (default: None)
    7685  fields.start = userstart
     86  ## Ticket field to use as the data source for finish date (default: None)
    7787  fields.finish = userfinish
    7888  #
     89  # Format for ''start'' and ''finish'' date strings (default: '%Y-%m-%d')
    7990  date_format = %Y-%m-%d
     91  #
     92  # Ticket type for milestone-like tickets (default: 'milestone')
    8093  milestone_type = milestone
     94  #
     95  # Ticket field to use as the data source for the percent complete column (default: None).
     96  # fields.percent =
     97  #
     98  # Hours represented by each unit of estimated work (default: 1).
     99  # hours_per_estimate = 1
     100  #
     101  # Default work for an unestimated task, same units as estimate  (default: 4.0).
     102  # default_estimate = 4.0
     103  #
     104  # How much work may be remaining when a task goes over estimate, same units as estimate (default: 0.0)..
     105  # estimate_pad = 0.0
    81106}}}
    82107   * See [#Configuration configuration details] below for explanations and more options.