= Trac2Taskjuggler =

== Description ==

Export data from Trac to [http://taskjuggler.org/ Taskjuggler] to get a real management tool and planification.  You can group your task by milestone and !MacroTask.

== Bugs/Feature Requests == 

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

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TaskjugglerPlugin&owner=mdelorme new ticket].
== Requirement ==
 * see the README File in the zip
 * To have some knowledges of Taskjuggler a very complete manual is [http://www.taskjuggler.org/manual-2.4.0/index.html available here]
 * You will need to have 
   * some special [http://trac.edgewall.org/wiki/TracTicketsCustomFields custom fields]
   * unfortnatly I'm not a Python dev so I wrote in PHP requirement for it are : php_pdo_sqlite.so available for php 5.1.2



== Download ==

Download the zipped source from ~~[download:taskjugglerplugin here]~~ Attachment 3.

== Source ==

You can check out TaskjugglerPlugin from [http://trac-hacks.org/svn/taskjugglerplugin here] using Subversion, or [source:taskjugglerplugin browse the source] with Trac.

== Installation ==
 1. Create new custom fields
{{{
[ticket-custom]
macro_task=select
macro_task.label=Macro Task
macro_task.options=MacroTask 1| MacroTask2 #change <- by your macro Task
macro_task.order=0

estimatedhours = text
estimatedhours.label = Plan 
estimatedhours.value = 0
estimatedhours.order = 2

hours = text
hours.label = Add Days
hours.value = 0
hours.order = 3

estimatedfinal = text
estimatedfinal.label = Actual
estimatedfinal.value = 0
estimatedfinal.order=4

totalhours = text
totalhours.label = Nb days worked
totalhours.value = 0
totalhours.order = 5

daysworked = textarea
daysworked.label = days worked
daysworked.cols = 23
daysworked.rows = 6
daysworked.order=6
}}}
 1. change the 2 settings on top of trac2TaskJuggler.php  
{{{
PDO('sqlite:/home/intranet/intra/t3_trac/db/trac.db'); <- set your config
}}}
 1. updload on trac2TaskJuggler.php to your server
 1. edit trac.tjp for setting first_milestone macro AND as you want vacation, working hours
 1. you can use your show_planning.sh to retrieve automaticly your data
 1. the days worked area field will be set by the project manager or by the developper as explained here http://www.taskjuggler.org/manual-2.3.1/attribute_classes.html#TYPE_DATEINTERVAL one interval per line
 1. you can add this js script into site_header.cs template to deliver information  see screenshots
{{{
<script language="javascript" type="text/javascript">
function AddEventListener( elem, evt, func, capture){
    capture = capture || false;
    if(elem.addEventListener) elem.addEventListener( evt, func, capture);
    else elem.attachEvent('on'+evt, func);
    return func;
};
add_legend = function(){
    var x = document.getElementById('daysworked');
    if(x){
      var p = x.parentNode;
      var n = document.createElement('div')
      n.style.float="left";
      n.innerHTML="Valeurs possibles : <ul><li>yyyy-mm-dd</li><li>yyyy-mm-dd - yyyy-mm-dd &nbsp;&nbsp;<u>/!\\</u> la 2ème valeur n'est pas inclus dans le calcul</li><li>yyyy-mm-dd +?d&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; <u>/!\\</u> ? doit être remplacés par le nb de jour</li></ul>" ;
      p.appendChild(n);
    }
}
AddEventListener(window, 'load', add_legend)
</script>
}}}

== Screenshots ==
 * see attachments
 * see [http://www.taskjuggler.org/screenshots_ide.php here] from tasjugler.org
== Example ==

./show_planning.sh

== Recent Changes ==

[[ChangeLog(taskjugglerplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:mdelorme] [[BR]]
'''Contributors:'''