Version 18 (modified by bas, 17 years ago) (diff) |
---|
Configuration
After installation, edit email2trac.conf;; for your site. Most important parameter is project. below is a table which options there are with a short description and the default value:
NAME | VALUE | Description |
[DEFAULT] | REQUIRED | |
project: | /data/trac/jouvin | REQUIRED |
debug: | 1 | OPTIONAL, if set print some DEBUG info |
spam_level: | 4 | OPTIONAL, if set check for SPAM mail |
drop_spam: | 0 | OPTIONAL:, if set then reject mail marked as SPAM |
reply_all: | 1 | OPTIONAL, if set then put all CC-addresses in ticket CC-field |
umask: | 022 | OPTIONAL, Use this umask for saving attachments |
mailto_link: | 1 | OPTIONAL, if set then [mailto:reporter] in description |
mailto_cc: | ticket@… | OPTIONAL, Use ths address as CC in mailto line |
ticket_update: | 1 | OPTIONAL, if set then check if this is an update for a ticket |
email_header: | 1 | OPTIONAL, if set then show TO/CC fields in description |
trac_version: | 0.9 | OPTIONAL. if set then use this as version number, default 0.10 |
alternate_notify_template | a_ticket.css | OPTIONAL if set then use this style sheet for notify |
enable_syslog | 1 | OPTIONAL, if set log errors to syslog, note they are not mailed back to the reporter |
verbatim_format | 1 | OPTIONAL, default: 1, if unset then do not use format: {{{ mail body text }}] |
strip_signature | 1 | OPTIONAL, It will try to remove the user signature from the mail, default: 0 |
[bas] | OPTIONAL project declaration, also set project and use --project option | |
project: | /data/trac/bas | |
spam_level: | 2 | Override DEFAULT spam_level, can also be done for other options |
Spam
There are two configuration options to handle spam. Both options depend on the X-Spam-Score line in the message header. This line is set by a spam detecting program like SpamAssassin. It count the * in the X-Spam-Score line, eg:
spam_level: 4 drop_spam: 1
This setup drops all email with Spam-score greater the 4. With this setting the email below is rejected:
From lijuydru@example.com Tue Dec 5 12:47:04 2006 To: test@example.com Subject: Test MIME-Version: 1.0 Content-Type: text/plain; List-Id: 8 X-Scanned-By: MIMEDefang 2.56 on 145.100.16.144 X-Scanned-By: MIMEDefang 2.51 on 145.100.16.26 X-Scanned-By: MIMEDefang 2.56 on 145.100.16.144 X-Spam-Score: ***************************** (29.334) BAYES_99, HELO_DYNAMIC_DHCP,HELO_DYNAMIC_IPADDR,MSGID_FROM_MTA_ID, RCVD_IN_BL_SPAMCOP_NET,RCVD_IN_SORBS_DUL,RCVD_IN_XBL, SUBJ_ILLEGAL_CHARS, URIBL_JP_SURBL, URIBL_SBL, URIBL_SC_SURBL, WEIRD_PORT, autolearn=spam
Ticket Update
If you have enabled 'ticket_update' in email2trac.conf then you have to choose one of this options to make it work:
- Configure trac notification, eg:
(ticket address: ticket@test.nl) [notification] smtp_enabled = true smtp_always_cc = test@test.nl smtp_server = localhost smtp_from = ticket@test.nl always_notify_reporter = true
- Use the mailto_cc and mailto_link in email2trac.conf. This will add a html mail to link in the description field. If you click on this link it will open the default mail program which will send an email to the reporter and CC to the ticket address.