RTx::Calendar(3pm)

💖 RTx::Calendar — the manual, but make it cute 💖

okay bestie, so this is the manual page for RTx::Calendar, a lil' thing from the User Contributed Perl Documentation section (you know, the (3pm) vibes ✨). It's a calendar for your RT due dates and honestly? it's giving organized queen energy. let's get into it 🎀

---

🌸 NAME 🌸

RTx::Calendar — a whole calendar for your RT due dates, periodt 📅

---

✨ DESCRIPTION ✨

so this RT extension hands you a calendar view of your tickets and your reminders, so you can literally see when your next due ticket is looming 👀 you'll find it hanging out in the ticket search sub navigation menu.

here's the tea tho: date fields in the search results are what get displayed/used in the calendar. like, for example, if you have a ticket with a due date, it will NOT show up on that date unless the Due field is actually included in the search result format. no Due field, no calendar entry, no cap 🫶

there's also a portlet you can drop on your home page (peep Prefs/MyRT.html) — scroll down to the CONFIGURATION section for the deets on adding it 💅

---

🌈 RT VERSION 🌈

works with RT 4.2, RT 4.4, and RT 5.0. iconic range honestly 👑

---

🛠️ INSTALLATION 🛠️

1. perl Makefile.PL
2. make
3. make install
   • might need root permissions bestie, don't fight it 💀
4. patch RT
   • apply this for versions prior to 4.4.2:

patch -p1 -d /path/to/rt < etc/tabs_privileged_callback.patch

5. Create or edit a file in /etc/request-tracker5/RT_SiteConfig.d
   • add this line:

Plugin('RTx::Calendar');

6. Clear your mason cache
   • ``` rm -rf /var/cache/request-tracker5/mason_data/obj

7. **Restart your webserver**

and that's it, you're slaying 🔥

---

# 💜 CONFIGURATION 💜

## 🌟 Base configuration

to use the `MyCalendar` portlet, you gotta add `MyCalendar` to `$HomepageComponents` in a file in `/etc/request-tracker5/RT_SiteConfig.d`:

Set($HomepageComponents, [qw(QuickCreate Quicksearch MyCalendar MyAdminQueues MySupportQueues MyReminders RefreshHomepage)]);

---

## 🦋 Display configuration

you can show the owner in each day box by adding this line to your `etc/RT_SiteConfig.pm`:

Set($CalendarDisplayOwner, 1);

and you can change which fields show up in the popup display when you mouse over a date, in a file in `/etc/request-tracker5/RT_SiteConfig.d`:

Set(@CalendarPopupFields, ('Status', 'OwnerObj->Name', 'DueObj->ISO'));

customize away, bestie 💅✨

---

# 🎀 USAGE 🎀

there's a small help section available at `/Search/Calendar.html` — go read it, it's right there for you 🫶

---

# 👑 AUTHOR 👑

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

originally written by **Nicolas Chuche** <nchuche@barna.be> — shoutout to the OGs 🌟

---

# 💀 BUGS 💀

found a bug? all bugs should be reported via email to:

L<bug-RTx-Calendar@rt.cpan.org|mailto:bug-RTx-Calendar@rt.cpan.org>

or via the web at:

L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RTx-Calendar>.

tell them everything, they wanna know 🙈

---

# 📜 LICENSE AND COPYRIGHT 📜

this software is Copyright (c) **2010-2022** by **Best Practical Solutions**

Copyright **2007-2009** by **Nicolas Chuche**

this is free software, licensed under:

> **The GNU General Public License, Version 2, June 1991**

---

<purple>and that's the whole page bestie!! this manual page was brought to you by **perl v5.36.0**, dated **2023-08-27** — love that for us 💖 stay due-date-obsessed, mwah 🎀✨</purple>