NAME
RT::Extension::CommandByMail - Change metadata of ticket via email
SYNOPSIS
Status: stalled
Subject: change subject
AddAdminCc: boss@example.com
AddCc: dev1@example.com
AddCc: dev2@example.com
The comment/reply text goes here
DESCRIPTION
This extension allows you to manage tickets via email interface. You may
put commands into the beginning of a mail, and extension will apply
them. See the list of commands in the
RT::Interface::Email::Filter::TakeAction docs.
CAVEAT: commands are line oriented, so you can't expand to multiple
lines for each command, i.e. values can't contains new lines. The module
also currently expects and parses text, not HTML.
SECURITY
This extension has no extended auth system; so all security issues that
apply to the RT in general also apply to the extension.
INSTALLATION
perl Makefile.PL
make
make install
May need root permissions
Edit your /opt/rt4/etc/RT_SiteConfig.pm
Add this line:
Set(@Plugins, ( @Plugins, "RT::Extension::CommandByMail" ));
As well as:
Set(@MailPlugins, qw(Auth::MailFrom Filter::TakeAction));
If you already have a @MailPlugins configuration line, add
Filter::TakeAction after any authentication plugins (such as
Auth::MailFrom or Auth::Crypt).
Restart your webserver
CONFIGURATION
$CommandByMailGroup
You may set a $CommandByMailGroup to a particular group ID in
RT_SiteConfig. If set, only members of this group may perform commands
by mail.
$CommandByMailHeader
You may set this configuration value to the name of a header to examine
as well. For example:
Set($CommandByMailHeader, "X-RT-Command");
$CommandByMailOnlyHeaders
If set, the body will not be examined, only the headers.
COMMANDS
This extension parses the body and headers of incoming messages for list
commands. Format of commands is:
Command: value
Command: value
...
See the list of commands in the RT::Interface::Email::Filter::TakeAction
docs.
CAVEATS
This extension is incompatible with UnsafeEmailCommands RT option.
AUTHOR
Jesse Vincent <jesse@bestpractical.com> Ruslan U. Zakirov
<ruz@bestpractical.com> Kevin Falcone <falcone@bestpractical.com> Shawn
Moore <sartak@bestpractical.com>
BUGS
All bugs should be reported via email to
L<bug-RT-Extension-CommandByMail@rt.cpan.org|mailto:bug-RT-Extension-CommandByMail@rt.cpan.org>
or via the web at
L<rt.cpan.org|http://rt.cpan.org/Public/Dist/Display.html?Name=RT-Extension-CommandByMail>.
LICENCE AND COPYRIGHT
Copyright (c) 2006-2014, Best Practical Solutions, LLC. All rights
reserved.
This module is free software; you can redistribute it and/or modify it
under the same terms as Perl itself. See perlartistic.