forked from bestpractical/rt-extension-commandbymail
-
Notifications
You must be signed in to change notification settings - Fork 1
/
README
100 lines (68 loc) · 2.89 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
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