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

If you are using RT 4.2 or greater, add this line:

Plugin('RT::Extension::CommandByMail');

For RT 4.0, add this line:

Set(@Plugins, qw(RT::Extension::CommandByMail));

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

Regardless of which version of RT, also Filter::TakeAction to your @MailPlugins configuration, as follows:

Set(@MailPlugins, qw(Auth::MailFrom Filter::TakeAction));

Be sure to include Auth::MailFrom in the list as well.

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

Best Practical Solutions, LLC <modules@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>.

LICENSE AND COPYRIGHT

This software is Copyright (c) 2014 by Best Practical Solutions

This is free software, licensed under:

The GNU General Public License, Version 2, June 1991

cpanm RT::Extension::CommandByMail

perl -MCPAN -e shell
install RT::Extension::CommandByMail