The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
RT-Extension-CommandByMail-0.17
River stage zero No dependents
++
/ RT::Extension::CommandByMail

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.