RT::Ex...SGantt(3pm)

✨ RT::Ex...SGantt 💖

okay bestie, sit down, we're doing the RT::Ex...SGantt(3pm) page from the User Contributed Perl Documentation section and it's literally so good. it's a Perl manual page, it lives in section 3pm, and it's about making your tickets look pretty in a Gantt chart. slay.

---

🎀 NAME 🎀

RT::Extension::JSGantt — Gantt charts for your tickets. that's it, that's the whole name. iconic.

---

🌈 DESCRIPTION 🌈

so here's the vibe: this extension takes your Starts and Due dates, plus your ticket dependencies, and turns them into Gantt charts. that's the whole thing. no cap.

---

💅 INSTALLATION 💅

run these, in this order, no skips:

perl Makefile.PL
make
make install

heads up: make install may need root permissions. like, sudo energy. 👑

then you gotta create or edit a file in /etc/request-tracker5/RT_SiteConfig.d — pick your era:

• if you're on RT 4.2 or greater, add this line:

Plugin('RT::Extension::JSGantt');

• if you're on RT 4.0... wait, RT 4.0, add this line:

Set(@Plugins, qw(RT::Extension::JSGantt));

• or honestly just add RT::Extension::JSGantt to your existing @Plugins line. whatever works for you, bestie. 🫶

Clear your mason cache — yes you have to, don't fight it:

rm -rf /var/cache/request-tracker5/mason_data/obj

Restart your webserver. that's the last step. go off. 🔥

---

🦋 CONFIGURATION 🦋

here's the whole config block, exactly as it comes. don't @ me, just copy it:

Set(
    %JSGanttOptions,
    DefaultFormat => 'day', # 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       => 'Resource',
    # ShowStartDate     => 1,
    # ShowEndDate       => 1,
    # DateInputFormat   => 'mm/dd/yyyy',
    # DateDisplayFormat => 'mm/dd/yyyy',
    # FormatArr         => q|'day','week','month','quarter'|,

    # define your own color scheme:
    # ColorScheme => ['ff0000', 'ffff00', 'ff00ff', '00ff00', '00ffff', '0000ff'],

    # 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 => 'ff0000', foo => '00ff00' },

    # if can't 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,
);

that's a whole lot of commented-out options and honestly? they're all just sitting there waiting for you. ✨

---

🌸 METHODS 🌸

AllRelatedTickets

given a ticket, return all the relative tickets — and yes, that includes the original ticket itself. it's giving main character energy, the original ticket is always invited. 👑

TicketsInfo

given tickets, resolve useful info for jsgantt.js. returns a 2 element array: the 1st is the ids arrayref, the 2nd is the info hashref. two things, in that order, always. 🫶

GetTimeRange

given a ticket, resolve its start/end. returns an array like ( $start_obj, $start, $end_obj, $end ). and $start and $end are strings like 3/21/2011. yes, that format. no, don't ask. 💀

---

🧚 UPGRADING 🧚

DateDayBeforeMonth

so prior to version 1.02, there was an undocumented RT config option called DateDayBeforeMonth. sneaky. if you have DateDayBeforeMonth set in your RT, you can make JSGantt do the same thing by setting DateDisplayFormat in RT_SiteConfig.pm, like so:

Set(
    %JSGanttOptions,
    ...
    # DateDisplayFormat => 'dd/mm/yyyy',
    ...
);

uncomment that line, live your day-before-month truth. 🎀

---

👑 AUTHOR 👑

Best Practical Solutions, LLC <modules@bestpractical.com>

---

🙈 BUGS 🙈

all bugs should be reported via email to

L<bug-RT-Extension-JSGantt@rt.cpan.org|mailto:bug-RT-Extension-JSGantt@rt.cpan.org>

or via the web at

L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-JSGantt>.

found a bug? tell them, don't suffer in silence bestie. 😭

---

💜 LICENSE AND COPYRIGHT 💜

this software is Copyright (c) 2014-2021 by Best Practical Solutions.

this is free software, licensed under:

The GNU General Public License, Version 2, June 1991

---

and that's the whole page, bestie!! 🎀 this one's running on perl v5.40.1, dated 2025-03-16, and it's filed under RT::Ex...SGantt(3pm) in the User Contributed Perl Documentation. go build a Gantt chart, you absolute icon. 💅✨🦋