[[PageOutline(2-5,Contents,pullout)]] = Ticket-based Gantt chart and calendar == Useful Links ''' [http://pack.hibuz.com/trac/hibuz-pack/ticketgantt Demo] | [http://osdn.jp/projects/shibuya-trac/ticket/?component%5B%5D=1062&component_mode%5B%5D=eq&status%5B%5D=1&status%5B%5D=2 View Tickets] | [http://osdn.jp/ticket/newticket.php?group_id=3068&component=1062 New Ticket] ''' == Description This plugin adds Gantt charts and calendar views for tickets to Trac. Click on the thumbnails for larger versions of the screenshots. '''Gantt chart view''' [[Image(Trac_Gantt_Chart.png, border=2)]] '''Calendar view''' [[Image(Trac_Calendar.png, border=2)]] '''Ticket creation example''' [[Image(Ticket_Creation.png, border=2​)]] Usage of calendars in Trac is also discussed in ProjectManagementIdeas. See also the following alternative plugins: [[ListTagged(realm:wiki calendar)]] '''Notes''': * Compared to TracJsGanttPlugin, this plugin does not compute the `completed percentages` from custom ticket fields like 'remaininghours' or 'estimatedhours', but you manually set the completion value in the range of 0% to 100% in the ticket form. * Timezone issue: This plugin was designed as timezone-less. All users and Trac server should have the same timezone. == Bugs/Feature Requests If you have any issues, [http://osdn.jp/ticket/newticket.php?group_id=3068&component=1062 create a new ticket] in [http://osdn.jp/projects/shibuya-trac/ticket/?component%5B%5D=1062&component_mode%5B%5D=eq&status%5B%5D=1&status%5B%5D=2 Shibuya.trac]. == Download === Trac 0.11 (English) This plugin is not hosted on trac-hacks.org. Please refer [http://www.daveperrett.com/articles/2008/11/26/gantt-calendar-plugin-for-trac/ here] for download, installation and usage instructions. {{{#!sh easy_install https://github.com/recurser/trac-gantt-calendar/tarball/master }}} The version at the address above is the previous (0.11) release translated into English. The new version (0.12) by the original author now supports English, so using [#Trac0.12Multilingual Multilingual version] below is recommended. === Trac 0.12 and 1.0+ (Multilingual) You can check out !GanttCalendarPlugin from [http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk here] using Subversion, or [http://osdn.jp/projects/shibuya-trac/scm/svn/tree/head/plugins/ganttcalendarplugin/trunk/ browse the source] in Shibuya.trac. [http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk/ganttcalendar/locale/ Supported Languages]: English, German, Simplified Chinese, Japanese, Korean == Installation Download from original repository: {{{#!sh svn export http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk }}} Build and install egg: {{{#!sh python setup.py bdist_egg easy_install dist/*.egg }}} == Configuration Configure the components section in your `trac.ini` file: {{{#!ini [components] .... ganttcalendar.admin.holidayadminpanel = enabled ganttcalendar.complete_by_close.completeticketobserver = enabled ganttcalendar.ticketcalendar.ticketcalendarplugin = enabled ganttcalendar.ticketgantt.ticketganttchartplugin = enabled ganttcalendar.ticketvalidator.ticketvalidator = enabled .... }}} You can disable or enable this plugin per project. Configure other sections in `trac.ini`: {{{#!ini [mainnav] .... ticketgantt.label = Ticket Gantt ticketcalendar.label = Ticket Calendar .... [ticket-custom] .... complete = select complete.label = Completed [%] complete.options = |0|5|10|15|20|25|30|35|40|45|50|55|60|65|70|75|80|85|90|95|100 complete.order = 3 due_assign = text due_assign.label = Start (YYYY-MM-DD) due_assign.order = 1 due_close = text due_close.label = End (YYYY-MM-DD) due_close.order = 2 .... [ganttcalendar] complete_conditions = fixed, invalid default_zoom_mode = 3 first_day = 0 format = %Y-%m-%d show_ticket_summary = false show_weekly_view = false }}} Restart Web Server. Definition of dates: * Essentially, the Start/End date of a ticket are defined as follows: * `Start Date`: the date that a task actually began. * `End Date`: the date that a task is scheduled to be completed. but you may interpret the meaning of the dates differently. It is up to you or your team to define them. Date format for Start/End date: * Accepted date formats: a numeric date format in the order of year, month, day ||||= '''Date Format''' =||||= '''Format String''' =|| || ''YYYY-MM-DD'' || ''2014-01-31'' || ''%Y-%m-%d'' || ''ISO 8601 date format'' || || ''YYYY/MM/DD'' || ''2014/01/31'' || ''%Y/%m/%d'' || ''legacy date format'' || || ''YYYY.MM.DD'' || ''2014.01.31'' || ''%Y.%m.%d'' |||| || ''YYYYMMDD'' || ''20140131'' || ''%Y%m%d'' |||| || ''YY-MM-DD'' || ''14-01-31'' || ''%y-%m-%d'' |||| || ''YY/MM/DD'' || ''14/01/31'' || ''%y/%m/%d'' |||| || ''YY.MM.DD'' || ''14.01.31'' || ''%y.%m.%d'' |||| || ''YYMMDD'' || ''140131'' || ''%y%m%d'' |||| * If you want to use the legacy date format (YYYY/MM/DD), you have to change your project's `trac.ini` file: (if previously created tickets are not shown) {{{#!ini [ganttcalendar] .... format = %Y/%m/%d .... }}} * '''Caution''': After a ticket is created, you should not change the date format. Instead, you should manually update the value of custom fields in the database for the date-formatting to take effect. Display holidays: * Currently, [http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk/README.ko the holiday data is provided for Japanese and Korean users only]. Allow NULL values in the `complete` field by prefixing with spaces as follows: ||= =||= '''[ticket-custom] section in trac.ini''' =|| || Allow NULL value || complete.options = `|`0|5|10|15|20|25|30|35|40|45|50|55|60|65|70|75|80|85|90|95|100 || || Do not allow NULL value || complete.options = 0|5|10|15|20|25|30|35|40|45|50|55|60|65|70|75|80|85|90|95|100 || === Korean version The [https://xp-dev.com/trac/ganttcalendar-ko/browser Korean version of GanttCalendarPlugin] (aka ganttcalendar-ko) was developed based on revision 592 of [http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk GanttCalendarPlugin], and the [#Trac0.12Multilingual Multilingual version] above (aka ganttcalendar-i18n) [https://xp-dev.com/trac/ganttcalendar-ko/log/branches/gantt_filter_0.12?rev=62 was developed based on revision 46 of ganttcalendar-ko]. The ganttcalendar-ko is not hosted on trac-hacks.org. Please refer [http://jinself.tistory.com/370 here] for download, installation and usage instructions. * for Trac 0.12 / 1.0dev {{{#!sh svn export https://xp-dev.com/svn/ganttcalendar-ko/branches/0.12 }}} * for Trac 0.11 / [http://sourceforge.net/projects/traconwindows/files/TOW%20%28TracOnWindows%29/0.3.0%20alpha%201/ TOW (TracOnWindows) 0.3.0 alpha 1] {{{#!sh svn export https://xp-dev.com/svn/ganttcalendar-ko/branches/0.11 }}} == Remarks * The UX was inspired by Redmine, and the included icons came from Redmine [http://www.redmine.org/projects/redmine/repository/show/tags/0.5.1/public/images 0.5.1] / [http://www.redmine.org/projects/redmine/repository/show/tags/0.9.4/public/images 0.9.4]. * The Complete by Close feature (in the [#Koreanversion Korean version], [#Trac0.12Multilingual Multilingual version]) was renewed by using the code of TimingAndEstimationPlugin. * The Author of [#Trac0.11English English version] helped popularize [http://svn.osdn.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk GanttCalendarPlugin] in the early days. == Branches [https://github.com/lexqt/EduTracGanttCalendar EduTracGanttCalendar]: port for [https://github.com/lexqt/edutrac EduTrac]. == Authors/Contributors {{{#!html }}} '''Original Author:''' [http://osdn.jp/users/okamototk Takashi Okamoto] [[BR]] '''Author of English version:''' [http://www.daveperrett.com/articles/2008/11/26/gantt-calendar-plugin-for-trac Dave Perrett] [[BR]] '''Author of Korean version:''' 강순권, [http://jseo.tistory.com/entry/Trac-ko-0104-%EC%97%90%EC%84%9C-Gantt-Chart-Plugin-%ED%95%9C%EA%B8%80%ED%99%94 JSeo], Genie [[BR]] '''Author of Multilingual version:''' [http://osdn.jp/users/okamototk Takashi Okamoto], [http://osdn.jp/users/kabuchan kabuchan], [http://osdn.jp/users/gil gil], [http://osdn.jp/users/suzz ssuzuki], Genie, [http://osdn.jp/users/jun66j5 Jun Omae] (aka jun66j5) [[BR]] '''Contributors:''' [http://osdn.jp/users/tomosnowbug tomo.snowbug] ([http://d.hatena.ne.jp/tomo_snowbug/20090922 related post]), [http://diary-of-paddy.blogspot.kr/2009/10/tracwbs.html paddy mt], [http://sakanaya.kir.jp/ymnet/diary/d/20100609 YMNet], [http://blue21.ddo.jp/web/osgyo/trac/trac5.html blue21], [http://osdn.jp/users/kanu かぬ], [http://osdn.jp/users/sutra Sutra Zhou] (support for Simplified Chinese), [http://osdn.jp/users/itsmeagain ItsmeAgain] (support for German) * English version: [https://github.com/recurser/trac-gantt-calendar/commit/14d90707e9a7a27511afe8d72652876f196fe019 Achim], djszapi, mwehr, PeterStephens, mark_kids@... * Korean version: Seo-Hee Khang, 김기원, 김갑인, axolotl and 황가 [http://blog.naver.com/ejjungeo/50129709998 (ejjungeo)] * Documentation: otaku42, ZoomQuiet, AdrianFritz, Chris.Nelson@…, rjollos, falkb, figaro, [http://www.codeforum.net/wiki/doku.php?id=trac#tracganttcalendar pitoosung] (for Korean version) * Hosting Demo site: [http://kanon.ultimania.org Kanon LAB], [http://pack.hibuz.com Hibuz​] * Hosting as Service: [https://xp-dev.com XP-Dev.com] (commercial), [http://projectlocker.com ProjectLocker] (commercial/only calendar)