NCHUCHE / RTx-Calendar-0.07 / README 

            

              
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

              
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.
    You can find screenshots on
    http://gaspard.mine.nu/dotclear/index.php?tag/rtx-calendar
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
    * compatible only with RT 3.6 for the moment. If someone need
    compatibility with 3.4 I can work on this. And I will work on 3.7
    compatibility later.
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