History: PluginGanttChart

            See also ((Front-ends to Tracker data))

! Plugin Gantt Chart
''Introduced in ((Tiki19))''
 
Use this ((wiki plugin)) to help you manage projects within Tiki, where project data is stored in Tiki ((trackers)). You will be able to draw Gantt chart diagrams, and edit them easily to have your gantt chart updated while the project life evolves changing project details, internal deadlines, etc. Please see: ((dev:jQuery Gantt editor)).
  
!! Parameters
{pluginmanager plugin="ganttchart"}

!! Get Started
As mentioned above, the project data used to create the Gantt charts are stored in Tiki ((trackers)). Create the Tracker with all the specific fields or use this [http://profiles.tiki.org/GanttChart|Profile] as a template, adjusting it to your own needs. Start with the Plugin Gantt Chart by adding the code to a Wiki page once you have created a tracker.
{CODE()}
{ganttchart trackerId="1" name="trackerganttTaskName" begin="trackerganttStartDate" end="trackerganttEndDate" resourceId="trackerganttResponsible" roleId="trackerganttRole" status="trackerganttStatus" progress="trackerganttProgress" canWrite="true" canDelete="true" canWriteOnParent="true" description="trackerganttDescription" code="trackerganttCode" effort="trackerganttEffort" resourceId="trackerganttResourceId"  order="trackerganttOrder" level="trackerganttLevel" depends="trackerganttDependencies"}
{CODE}

!!! Overview
The previous code will give the result this overview:
{img src="display1600" link="display1600" width="800" rel="box[g]" alt="Plugin Gantt Chart Overview"  desc="Click to expand"}

!! Key Features
The Gantt Chart Plugin allows you to manage a complete project of any size, to divide it into tasks, to associate resources with each one with its role. When managing the project, you can create a task hierarchy, create dependencies between tasks, determine milestones, highlight the critical path, modify resources, change time scheduling, etc.

To quickly build Gantt charts, use the undo, redo, un-indent task, indent task, move up, move down, delete, EXPAND_ALL, COLLAPSE_ALL, zoom out, zoom in, Print, CRITICAL_PATH, control options to handle the different task display modes, fullscreen, task status color control and the Save button.

With a simple click, set the critical path; remove a task; switch to fullscreen mode, etc.
{DIV(class="row")}
{DIV(class="col-md-6")}
{img src="display1601" link="display1601" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Project hierarchy"}
''Organise projects into tasks linked by dependencies''
{DIV}
{DIV(class="col-md-6")}
{img src="display1602" link="display1602" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Options"}
{DIV}
{DIV}

!! Explore Plugin Gantt Chart 

{DIV(class="row")}
{DIV(class="col-md-6")}
!!!!! Changing a task
{img src="display1603" link="display1603" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Change Task Details"}
''In a few clicks change the status, code, name, start date, end date, duration or progress of the task just by clicking on the element you need to update.''
{DIV}
{DIV(class="col-md-6")}
{img src="display1604" link="display1604" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Task Editor"}
''When you want to modify a task, click on the edit icon or on the diagram that represents a task, a window will open __Task Editor__, change the code, the name of the task, define milestones, add a description of the task, etc.''
{DIV}
{DIV}

{DIV(class="row")}
{DIV(class="col-md-6")}
!!!!! Moving a task
{img src="display1605" link="display1605" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Moving a task"}
''After editing a task, use the __«move up»__ and __«move down»__ controls to move a task from bottom to top or from top to bottom.''
{DIV}
{DIV(class="col-md-6")}
!!!!! Creating dependencies


{img src="display1606" link="display1606" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Creating dependencies"}
''Very easy to create dependencies between two or more tasks by simply dragging the mouse. Place the mouse over the graph, once the two points have been shown, select one and dragging it to another task.''
{DIV}
{DIV}

{DIV(class="row")}
{DIV(class="col-md-6")}
!!!!! Changing task duration
{img src="display1607" link="display1607" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart"}
''Easily change the duration of tasks with just a simple drag of the mouse.''
{DIV}
{DIV(class="col-md-6")}
!!!!! Adjusting the chart preview
{img src="display1608" link="display1608" width="400" rel="box[g]"  desc="Click to expand" alt="Plugin Gantt Chart Zoom option"}
''Adjust the zoom option to view the charts according to day, week, month, semester, and year.''
{DIV}
{DIV}

!! Some extra details on some fields

*     id: used to synch data with the server. If the id is supplied by the server it will untouched. Tasks created client side will acquire a temporary id starting with  “tmp_”
*     level: it is the depth (the indentation) of a task in the Gantt structure. The root task is at level 0 (zero), its children at level 1 (one) and so on. Levels must be consistent with the project structure: you can’t have a task of level n+1 if you don’t have a task of level n above on the list
*     start, end: are expressed in milliseconds. “start” is set to the first millisecond of the day, “end” is set to the last millisecond of the day.
*     duration: is always in working days. If there are holidays on the calendar the end date will take it into account. Actually the end date is always recomputed using “start” and “duration”, and it is supplied for comfort
*     startIsMilestone, endIsMilestone: booleans. Once set to true, task’ start/end can’t move accidentally. You always can change dates directly on the task, but not by acting on children or predecessors.
*     depends: a string comma delimited containing indexes of tasks on which this task depends. Multiple dependencies are supported. Only the finish-to-start dependency type is supported (other types can be workarounded by introducing intermediary brother tasks or children). It is possible to specify a “lag” in days by using a “:”. E.g.: 7:3,8 means that the task will start 3 days after task 7 is completed and task 8 is completed.
*     status: this is a string representing the status of the task. Allowed statuses are: STATUS_ACTIVE, STATUS_DONE, STATUS_FAILED, STATUS_SUSPENDED, STATUS_UNDEFINED. As stated before, task statuses allow to use your project like a sort of workflow: e.g.: if “task b” depends on “task a”, “task b” will remain in “STATUS_SUSPENDED” until “task a” will pass from “STATUS_ACTIVE” to “STATUS_DONE”. For the complete status transition rules see below.
*     progress: a number that specifies progress: 0%  none 50% half way and so on. In some cases 123% can be a meaningful value for progress, so there are no constraints.

!! Status transition rules (aka project workflow)
Task statuses are a key feature in this plugin. 

When you close some tasks (change status to “completed”) you will see how dependent tasks/children will change their status according to the following rules:

*    __any status-> STATUS_DONE__:  may activate dependent tasks, both suspended and undefined. Will set to done all descendants.
*    __STATUS_FAILED -> STATUS_DONE__:  do nothing if not forced by hand.
*    __STATUS_UNDEFINED -> STATUS_ACTIVE__: all children become active, if they have no dependencies.
*    __STATUS_SUSPENDED -> STATUS_ACTIVE__ : sets to active all children and their descendants that have no inhibiting dependencies.
*    __STATUS_DONE -> STATUS_ACTIVE__: all those that have dependencies must be set to suspended.
*    __STATUS_FAILED -> STATUS_ACTIVE__: nothing happens: child statuses must be reset by hand.
*    __any status-> STATUS_SUSPENDED__: all active children and their active descendants become suspended. when not failed or forced
*    __any status-> STATUS_UNDEFINED__: all active children and their active descendants become suspended. when not failed or forced.
*    __any status-> STATUS_FAILED__: children and dependants are set to failed.

!! Example
* See ((Sample Gantt Chart))

!! Improvements in Tiki23
Added gantt items duplication within same tracker since ((Tiki23)):
* Use ganttId to indicate the value to filter items;
* User ganttIdField to indicate the field perm_name that holds the value above;
* Use canDuplicate to indicate if it can duplicate or not (both ganttId and ganttIdField need to have values)
* When duplicating items, a new ganttId is chosen and also the option to update the existing wikiplugin_ganttchart to display the new duplicated items.
* If user does not have permissions to create new tracker items, the duplication is not available.

 
!! Related pages
* ((Trackers))
* ((dev:jQuery Gantt editor))

!! Related Profile
* ((pr:GanttChart))
 
-=Aliases=-
* (alias(Gantt Chart))
* (alias(Gantt))
* (alias(PluginGantt))
* (alias(Plugin Gantt))
* (alias(Plugin GanttChart))
* (alias(Plugin Gantt Chart))