Jim Brandt > RT-Extension-Announce-0.06 > RT-Extension-Announce

Download:
RT-Extension-Announce-0.06.tar.gz

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Source   Latest Release: RT-Extension-Announce-0.07

NAME ^

RT-Extension-Announce - Display announcements as a banner on RT pages.

INSTALLATION ^

perl Makefile.PL
make
make install

May need root permissions

Edit your /opt/rt4/etc/RT_SiteConfig.pm

Add these lines:

    Set(@Plugins, qw(RT::Extension::Announce));
    Set(@CustomFieldValuesSources, (qw(RT::CustomFieldValues::AnnounceGroups)));

or add RT::Extension::Announce to your existing @Plugins line.

make initdb

Run this in the install directory where you ran the previous make commands.

Clear your mason cache
    rm -rf /opt/rt4/var/mason_data/obj
Restart your webserver

DESCRIPTION ^

The Announce extension gives you an easy way to insert announcements on the RT homepage so all users can see the message. You may want to display a banner during maintenance or an unscheduled outage to make sure the people fielding customer tickets know that something is going on.

DETAILS ^

When you install the extension, a new queue is created called RTAnnounce. To post an announcement, create a ticket in that queue. The extension displays on the RT homepage the subject and most recent correspondence on active tickets in the RTAnnounce queue. As the incident or maintenance progresses, just reply to the ticket and the announcement will be updated with the latest information.

When multiple announcements are active, they are ordered by the last update time with the announcement with the most recent update coming first.

When the incident is over, resolve the ticket and the announcement will be removed.

Comments on announce tickets are not shown in the announcement. However, comments are visible on the ticket for users who have permission to view the full ticket. If you have multiple announcements, a new comment updates the last updated time and will move the announcement to the top of the list.

ANNOUNCEMENT GROUPS ^

The RTAnnounce queue has a custom field called 'Announcement Groups' which you can use to manage who will see an announcement. If you set no value, all users will see the announcement. If you set one or more RT groups, only memebers of those groups will see it.

PERMISSIONS ^

By default, the announements are static text. If you give users the ShowTicket right on the RTAnnounce queue, the announcements will have links to the source tickets. This will allow users to see the history of an announcement or see longer messages that might be truncated on the homepage.

The RTAnnounce queue is a regular queue, so you can control access to creating announcements the same way you manage permissions on other queues.

In addition to setting permissions, you may not want to send the typical 'ticket create' email messages, so you could change or customize the scrips that run or create new templates. If you send announcement messages to an email list, you could create a list user in RT and add it as a CC to the announcement queue. Then messages posted for announcement in RT will also be sent to the notification list.

CONFIGURATION ^

You can change the name of the queue used for announcements. First edit the RTAnnounce queue in RT and change its name to your new name. Add a line to your RT_SiteConfig.pm to set that new value:

    Set($RTAnnounceQueue, 'Custom Announce Name');

Then clear your mason cache and restart your server.

AUTHOR ^

Jim Brandt <jbrandt@bestpractical.com>

BUGS ^

All bugs should be reported via http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-Announce or bug-RT-Extension-Announce@rt.cpan.org.

LICENSE AND COPYRIGHT ^

This software is Copyright (c) 2012 by Best Practical Solutions, LLC

This is free software, licensed under:

  The GNU General Public License, Version 2, June 1991
syntax highlighting: