Shawn M Moore > RTx-Calendar-0.08 > RTx::Calendar

Download:
RTx-Calendar-0.08.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  4
Open  3
View/Report Bugs
Module Version: 0.08   Source   Latest Release: RTx-Calendar-0.17

NAME ^

RTx::Calendar - Calendar for RT due tasks

VERSION ^

This document describes version 0.07 of RTx::Calendar

DESCRIPTION ^

This RT extension provides a calendar view for your tickets and your reminders so you see when is your next due ticket. You can find it in the menu Search->Calendar.

There's a portlet to put on your home page (see Prefs/MyRT.html)

You can also enable ics (ICal) feeds for your default calendar and all your private searches in Prefs/Calendar.html. Authentication is magic number based so that you can give those feeds to other people.

INSTALLATION ^

If you upgrade from 0.02, see next part before.

You need to install those three modules :

  * Date::ICal
  * Data::ICal
  * DateTime::Set

Install it like a standard perl module

 perl Makefile.PL
 make
 make install

If your RT is not in the default path (/opt/rt3) you must set RTHOME before doing the Makefile.PL

CONFIGURATION ^

Base configuration

In RT 3.8 and later, to enable calendar plugin, you must add something like that in your etc/RT_SiteConfig.pm :

  Set(@Plugins,(qw(RTx::Calendar)));

To use MyCalendar portlet you must add MyCalendar to $HomepageComponents in etc/RT_SiteConfig.pm like that :

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

To enable private searches ICal feeds, you need to give CreateSavedSearch and LoadSavedSearch rights to your users.

Display configuration

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

    Set($CalendarDisplayOwner, 1);

You can change which fields show up in the popup display when you mouse over a date in etc/RT_SiteConfig.pm :

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

ICAL feed configuration

By default, tickets are todo and reminders event. You can change this by setting $RT::ICalTicketType and $RT::ICalReminderType in etc/RT_SiteConfig.pm :

  Set($ICalTicketType,   "Data::ICal::Entry::Event");
  Set($ICalReminderType ,"Data::ICal::Entry::Todo");

USAGE ^

A small help section is available in /Prefs/Calendar.html

UPGRADE FROM 0.02 ^

As I've change directory structure, if you upgrade from 0.02 you need to delete old files manually. Go in RTHOME/share/html (by default /opt/rt3/share/html) and delete those files :

  rm -rf Callbacks/RTx-Calendar
  rm Tools/Calendar.html

RTx-Calendar may work without this but it's not very clean.

BUGS ^

AUTHORS ^

Nicolas Chuche <nchuche@barna.be>

Idea borrowed from redmine's calendar (Thanks Jean-Philippe).

COPYRIGHT ^

Copyright 2007 by Nicolas Chuche <nchuche@barna.be>

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

See http://www.perl.com/perl/misc/Artistic.html

syntax highlighting: