[[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 Note: * 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 meaning of start and end date of a ticket displayed in the chart is at the discretion of you. Usually, you set the planned time period, though you cannot see in the gantt chart if completion had started earlier than planned, was interrupted or has finished later. For a review of the work history, you may interpret start and end date to indicate the worked time period. This is up to you. 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, create a new ticket in Shibuya.trac: * 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: the numeric date in the order 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 edited tickets does not shown) {{{ #!ini [ganttcalendar] .... format = %Y/%m/%d .... }}} 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 == * Many features were developed 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 == '''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] '''Contributors:''' [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@... * Documentation: otaku42, ZoomQuiet, AdrianFritz, Chris.Nelson@…, rjollos, falkb, [http://www.codeforum.net/wiki/doku.php?id=trac#tracganttcalendar pitoosung] and 황가 [http://blog.naver.com/ejjungeo/50129709998 (ejjungeo)] (for Korean version) * Demo site Hosting: [http://kanon.ultimania.org Kanon LAB], [http://pack.hibuz.com Hibuz​]