.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "RT::Extension::JSGantt 3pm" .TH RT::Extension::JSGantt 3pm "2023-03-05" "perl v5.36.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" RT::Extension::JSGantt \- Gantt charts for your tickets .SH "DESCRIPTION" .IX Header "DESCRIPTION" This extension uses the Starts and Due dates, along with ticket dependencies, to produce Gantt charts. .SH "INSTALLATION" .IX Header "INSTALLATION" .ie n .IP """perl Makefile.PL""" 4 .el .IP "\f(CWperl Makefile.PL\fR" 4 .IX Item "perl Makefile.PL" .PD 0 .ie n .IP """make""" 4 .el .IP "\f(CWmake\fR" 4 .IX Item "make" .ie n .IP """make install""" 4 .el .IP "\f(CWmake install\fR" 4 .IX Item "make install" .PD May need root permissions .IP "Create or edit a file in \fI/etc/request\-tracker5/RT_SiteConfig.d\fR" 4 .IX Item "Create or edit a file in /etc/request-tracker5/RT_SiteConfig.d" If you are using \s-1RT 4.2\s0 or greater, add this line: .Sp .Vb 1 \& Plugin(\*(AqRT::Extension::JSGantt\*(Aq); .Ve .Sp For \s-1RT 4.0,\s0 add this line: .Sp .Vb 1 \& Set(@Plugins, qw(RT::Extension::JSGantt)); .Ve .Sp or add \f(CW\*(C`RT::Extension::JSGantt\*(C'\fR to your existing \f(CW@Plugins\fR line. .IP "Clear your mason cache" 4 .IX Item "Clear your mason cache" .Vb 1 \& rm \-rf /var/cache/request\-tracker5/mason_data/obj .Ve .IP "Restart your webserver" 4 .IX Item "Restart your webserver" .SH "CONFIGURATION" .IX Header "CONFIGURATION" .Vb 6 \& Set( \& %JSGanttOptions, \& DefaultFormat => \*(Aqday\*(Aq, # or week or month or quarter \& ShowOwner => 1, \& ShowProgress => 1, \& ShowDuration => 1, \& \& # Configurable JSGantt options \& # https://code.google.com/p/jsgantt/wiki/Documentation#4._Instantiate_JSGantt_using_() \& # CaptionType => \*(AqResource\*(Aq, \& # ShowStartDate => 1, \& # ShowEndDate => 1, \& # DateInputFormat => \*(Aqmm/dd/yyyy\*(Aq, \& # DateDisplayFormat => \*(Aqmm/dd/yyyy\*(Aq, \& # FormatArr => q|\*(Aqday\*(Aq,\*(Aqweek\*(Aq,\*(Aqmonth\*(Aq,\*(Aqquarter\*(Aq|, \& \& # define your own color scheme: \& # ColorScheme => [\*(Aqff0000\*(Aq, \*(Aqffff00\*(Aq, \*(Aqff00ff\*(Aq, \*(Aq00ff00\*(Aq, \*(Aq00ffff\*(Aq, \*(Aq0000ff\*(Aq], \& \& # we color owners consistently by default, you can disable it via: \& # ColorSchemeByOwner => 0, \& \& # you can specify colors to use, unspecified owners will be \& # assigned to some color automatically: \& # ColorSchemeByOwner => { root => \*(Aqff0000\*(Aq, foo => \*(Aq00ff00\*(Aq }, \& \& # if can\*(Aqt find both start and end dates, use this color \& NullDatesColor => 333, \& \& # to calculate day length \& WorkingHoursPerDay => 8, \& \& # used to set start/end if one exists but the other does not \& DefaultDays => 7, \& ); .Ve .SH "METHODS" .IX Header "METHODS" .SS "AllRelatedTickets" .IX Subsection "AllRelatedTickets" Given a ticket, return all the relative tickets, including the original ticket. .SS "TicketsInfo" .IX Subsection "TicketsInfo" Given tickets, resolve useful info for jsgantt.js Returns a 2 elements array, 1st is the ids arrayref, 2nd is the info hashref. .SS "GetTimeRange" .IX Subsection "GetTimeRange" Given a ticket, resolve it's start/end. Returns an array like ( \f(CW$start_obj\fR, \f(CW$start\fR, \f(CW$end_obj\fR, \f(CW$end\fR ) \&\f(CW$start\fR and \f(CW$end\fR are strings like 3/21/2011 .SH "UPGRADING" .IX Header "UPGRADING" .SS "DateDayBeforeMonth" .IX Subsection "DateDayBeforeMonth" Prior to version 1.02, there was an undocumented \s-1RT\s0 config option \&\f(CW\*(C`DateDayBeforeMonth\*(C'\fR. If you have DateDayBeforeMonth set in your \s-1RT,\s0 you can make JSGantt do the same thing by setting \f(CW\*(C`DateDisplayFormat\*(C'\fR in RT_SiteConfig.pm: .PP .Vb 6 \& Set( \& %JSGanttOptions, \& ... \& # DateDisplayFormat => \*(Aqdd/mm/yyyy\*(Aq, \& ... \& ); .Ve .SH "AUTHOR" .IX Header "AUTHOR" Best Practical Solutions, \s-1LLC\s0 .SH "BUGS" .IX Header "BUGS" All bugs should be reported via email to .PP .Vb 1 \& L .Ve .PP or via the web at .PP .Vb 1 \& L. .Ve .SH "LICENSE AND COPYRIGHT" .IX Header "LICENSE AND COPYRIGHT" This software is Copyright (c) 2014\-2021 by Best Practical Solutions .PP This is free software, licensed under: .PP .Vb 1 \& The GNU General Public License, Version 2, June 1991 .Ve