Alex Vandiver > RT-Extension-CommandByMail > RT::Extension::CommandByMail

Download:
RT-Extension-CommandByMail-1.00.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  9
Open  7
View/Report Bugs
Module Version: 1.00   Source  

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
syntax highlighting: