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

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

okay bestie, welcome to the User Contributed Perl Documentation for RT::Extension::JSGantt — literally the cutest way to make your tickets look like a whole timeline. pull up a chair, we're doing this together 🫶

---

✨ NAME ✨

RT::Extension::JSGantt — Gantt charts for your tickets 🎀

---

🌸 DESCRIPTION 🌸

so basically this extension takes your Starts and Due dates, plus all the ticket dependencies, and serves you up some Gantt charts. that's it, that's the whole vibe. it's giving project-manager main character energy and honestly? obsessed 💅

---

🦋 INSTALLATION 🦋

first things first, run these:

perl Makefile.PL
make
make install

heads up: the make install step may need root permissions, so don't come for me when it yells at you 🙈

Create or edit a file in /etc/request-tracker5/RT_SiteConfig.d ✨

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

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

if you're on RT 4.0, add this line instead:

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

or honestly just add RT::Extension::JSGantt to your existing @Plugins line, whatever's easier, no cap 🫶

Clear your mason cache (yes it's mandatory, yes it's annoying):

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

Restart your webserver and boom, you're done 💖

---

💜 CONFIGURATION 💜

here's the whole config situation, drop it in like this:

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,
);

like, look at all those options bestie, we are thriving 🌈

---

⭐ METHODS ⭐

🎀 AllRelatedTickets

give it a ticket, and it hands you back all the relative tickets — including the original ticket itself. yes, the whole friend group 🫂

🎀 TicketsInfo

give it tickets and it resolves the useful info for jsgantt.js. it returns a 2 element array — element 1 is the ids arrayref, element 2 is the info hashref. cute and efficient ✨

🎀 GetTimeRange

give it a ticket and it resolves its start/end. returns an array like:

( $start_obj, $start, $end_obj, $end )

where $start and $end are strings like 3/21/2011. iconic date format, we love to see it 💅

---

🧚 UPGRADING 🧚

🎀 DateDayBeforeMonth

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

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

lowkey a glow-up from undocumented to fully supported 💖

---

🌟 AUTHOR 🌟

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

---

💀 BUGS 💀

found a bug? (not me manifesting it 🙈) report it 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>.

please do report them, the devs wanna know fr fr 🫶

---

👑 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, you ate that 💅✨ this was RT::Ex...SGantt(3pm) — perl v5.36.0, dated 2023-09-25 🎀💖 go forth and Gantt chart your little heart out, ily, bye 🦋🌈