[[ShowPath]]
[[PageOutline]]

= 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:CC]}}} in description ||
|| mailto_cc: || ticket@test.nl ||  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 that ''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 in email2trac.conf if you want to send an email to the ticket email address.