Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 html
Octocat-spinner-32 inc
Octocat-spinner-32 lib
Octocat-spinner-32 .gitignore
Octocat-spinner-32 CHANGES
Octocat-spinner-32 IDEA
Octocat-spinner-32 MANIFEST.SKIP
Octocat-spinner-32 META.yml
Octocat-spinner-32 Makefile.PL
Octocat-spinner-32 README
Octocat-spinner-32 TODO
README
NAME
    RTx::Calendar - Calendar for RT due tasks

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 two modules :

      * 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
    All bugs should be reported via
    <http://rt.cpan.org/Public/Dist/Display.html?Name=RTx-Calendar> or
    bug-RTx-Calendar@rt.cpan.org.

AUTHORS
    Best Practical Solutions

    Nicolas Chuche <nchuche@barna.be>

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

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

    Copyright 2010-2012 by Best Practical Solutions.

    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>
Something went wrong with that request. Please try again.