[[PageOutline(2-5,Contents,pullout)]] = Ticket-based Gantt chart and calendar = == Useful Links == ''' [http://kanon.ultimania.org/trac/BugTracker/ticketgantt Try Demo #1] / [http://pack.hibuz.com/trac/hibuz-pack/ticketgantt Demo #2] | [http://sourceforge.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://sourceforge.jp/ticket/newticket.php?group_id=3068&component=1062 New Ticket] ''' == Description == This plugin adds Gantt charts and calendar views for tickets to Trac. See also: ProjectManagementIdeas '''|''' TracJsGanttPlugin, TicketCalendarPlugin '''|''' WikiCalendarMacro, WikiTicketCalendarMacro '''|''' TeamCalendarPlugin, GoogleCalendarPlugin, CalendarPlugin '''|''' [http://success.tracpath.com/blog/2014/02/26/wiki-ganttchart-plugin-for-trac-and-tracpath tracpath.com] Note: * 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 date differently. It is up to you (or your team) to define them. * This plugin is designed to use with the time tracking plugin: TimingAndEstimationPlugin, TracHoursPlugin and it is designed to ignore the `Completed Percents` of a closed ticket. In case of a closed ticket, `Total Hours` is used instead of `Completed Percents`. And '''it is strongly recommended to use with the time tracking plugin'''. [[BR]] Compared to TracJsGanttPlugin, this plugin does not compute the `Completed Percents` from custom ticket fields like 'remaininghours' or 'estimatedhours', but you set the completion value in the range of 0 to 100% in the ticket form, manually. The automated computed `Completed Percents` is not meaning actual progress rate. In case of a opened ticket, It should be evaluated together with `Total Hours`. Timezone issue: * This plugin is designed for timezone-less. All users and Trac server should have same timezone. == Bugs/Feature Requests == If you have any issues, [http://sourceforge.jp/ticket/newticket.php?group_id=3068&component=1062 create a new ticket] in Shibuya.trac: * [http://sourceforge.jp/projects/shibuya-trac/ticket/?component%5B%5D=1062&component_mode%5B%5D=eq&status%5B%5D=1&status%5B%5D=2 http://sourceforge.jp/projects/shibuya-trac/ticket] == Screenshots == Click on the thumbnails for larger versions of the screenshots. {{{ #!html

Thumbnail: Gantt chart view
Gantt chart view

Thumbnail: Calendar view
Calendar view

Thumbnail: Ticket creation
Ticket creation example

}}} == Download and Installation == === 'A' Method: for 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 'B' method below is recommended. [[BR]] === 'B' Method: for Trac 0.12 (Multilingual) === You can check out !GanttCalendarPlugin from [http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk here] using Subversion, or [http://sourceforge.jp/projects/shibuya-trac/svn/view/plugins/ganttcalendarplugin/trunk/?root=shibuya-trac browse the source] in Shibuya.trac. [[BR]] [http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk/ganttcalendar/locale/ Supported Languages]: English, German, Simplified Chinese, Japanese, Korean 1. Install tarball from original repository: {{{ #!sh easy_install "http://sourceforge.jp/projects/shibuya-trac/svn/view/plugins/ganttcalendarplugin/trunk/?root=shibuya-trac&view=tar" }}} or Use [https://github.com/jun66j5/tracganttcalendarplugin mirror repository]: {{{ #!sh easy_install https://github.com/jun66j5/tracganttcalendarplugin/tarball/trunk }}} 2. Configure components section in trac.ini (you can disable / enable per project) {{{ #!ini [components] .... ganttcalendar.admin.holidayadminpanel = enabled ganttcalendar.complete_by_close.completeticketobserver = enabled ganttcalendar.ticketcalendar.ticketcalendarplugin = enabled ganttcalendar.ticketgantt.ticketganttchartplugin = enabled ganttcalendar.ticketvalidator.ticketvalidator = enabled .... }}} 3. 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 }}} 4. Restart Web Server [[BR]] Date format for Start/End date: * accepted date formats: a numeric date format in the order of year, month, day ||||= '''Date Format''' =||||= '''Format Stirng''' =|| || ''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 legacy date format (YYYY/MM/DD), you have to change your project's trac.ini file: (if previously created tickets does not shown) {{{ #!ini [ganttcalendar] .... format = %Y/%m/%d .... }}} * '''CAUTION !!! ''' '''After some tickets are created, you should not change date format'''. If you want to change date format in this case, you should update value of custom fields in database directly. Display holidays: * This feature is experimental. Currently, [http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk/README.ko the holiday data is provided for Japanese and Korean user only]. === 'Other' Method: for Korean only === The [https://www.assembla.com/code/ganttcalendar-ko/subversion/nodes Korean version of GanttCalendarPlugin] (A.K.A. ganttcalendar-ko) is developed based on revision 592 of [http://svn.sourceforge.jp/svnroot/shibuya-trac/plugins/ganttcalendarplugin/trunk GanttCalendarPlugin], and the [#BMethod:forTrac0.12Multilingual Multilingual version] above (A.K.A. ganttcalendar-i18n) [https://www.assembla.com/code/ganttcalendar-ko/subversion/compare/62...38 is 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://subversion.assembla.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://subversion.assembla.com/svn/ganttcalendar-ko/branches/0.11 }}} == Remarks == * The UX was designed 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 [#OtherMethod:forKoreanonly Korean version], [#BMethod:forTrac0.12Multilingual Multilingual version]) was renewed by using code of TimingAndEstimationPlugin. * The Author of [#AMethod:forTrac0.11English English version] helped popularize [http://svn.sourceforge.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] [[BR]] == Authors/Contributors == {{{#!html }}} '''Original Author:''' [http://sourceforge.jp/users/okamototk Takashi Okamoto] '''Author of English version:''' [http://www.daveperrett.com/articles/2008/11/26/gantt-calendar-plugin-for-trac Dave Perrett] '''Author of Korean version:''' 강순권, [http://corpseplay.com/39 JSeo], [http://jinself.tistory.com/370 Genie] '''Author of Multilingual version:''' [http://sourceforge.jp/users/okamototk Takashi Okamoto], [http://sourceforge.jp/users/kabuchan kabuchan], [http://sourceforge.jp/users/gil gil], [http://sourceforge.jp/users/suzz ssuzuki], [http://jinself.tistory.com/370 Genie] [[BR]] '''Contributors:''' [http://d.hatena.ne.jp/tomo_snowbug/20090922 tomo_snowbug], [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://sourceforge.jp/users/kanu かぬ], [http://sourceforge.jp/users/jun66j5 Jun Omae] (A.K.A. jun66j5), [http://sourceforge.jp/users/sutra Sutra Zhou] (support for Simplified Chinese), [http://sourceforge.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, [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/calendar only)