Changes between Initial Version and Version 1 of TracNotification


Ignore:
Timestamp:
Sep 2, 2005, 10:21:58 AM (14 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracNotification

    v1 v1  
     1= Email Notification of Ticket Changes =
     2[[TracGuideToc]]
     3
     4Trac supports basic notification for ticket changes using email.
     5
     6Email notification is useful to keep users up-to-date on tickets/issues of interest, and also provides a convenient way to post ticket changes to a dedicated mailing list. '''Note:''' As an example, this is how the [http://lists.edgewall.com/archive/trac-tickets/ Trac-tickets] mailing list works.
     7
     8Disabled by default, notification can be activated and configured in [wiki:TracIni trac.ini].
     9
     10== Receiving Notification ==
     11When reporting a new ticket or adding a comment, enter a validing email address in the ''reporter'', ''editor'' or ''cc'' field. Trac will automatically send you an email when changes are made to the ticket.
     12
     13This is useful to keep up-to-date on an issue or enhancement request that interests you.
     14
     15== Configuring SMTP Notification ==
     16
     17=== Config Options ===
     18These are the available options for the ''[notification]'' section in trac.ini.
     19 * '''smtp_enabled''': Enable notification.
     20 * '''smtp_server''': SMTP server used for notification messages.
     21 * '''smtp_from''': Email address to use for ''Sender''-headers in notification emails.
     22 * '''smtp_replyto''': Email address to use for ''Reply-To''-headers in notification emails.
     23 * '''smtp_always_cc''': List of email addresses to always send notifications to. ''Typically used to post ticket changes to a dedicated mailing list.''
     24 * '''always_notify_reporter''':  Always send notifications to any address in the reporter field.
     25
     26Either '''smtp_from''' or '''smtp_replyto''' (or both) ''must'' be set, otherwise Trac refuses to send notification mails.
     27
     28=== Example Configuration ===
     29
     30{{{
     31[notification]
     32smtp_enabled = true
     33smtp_server = mail.example.com
     34smtp_from = notifier@example.com
     35smtp_replyto = myproj@projects.example.com
     36smtp_always_cc = ticketmaster@example.com, theboss+myproj@example.com
     37}}}
     38
     39== Sample Email ==
     40{{{
     41#42: testing
     42---------------------------+------------------------------------------------
     43       Id:  42             |      Status:  assigned               
     44Component:  report system  |    Modified:  Fri Apr  9 00:04:31 2004
     45 Severity:  major          |   Milestone:  0.9                     
     46 Priority:  lowest         |     Version:  0.6                     
     47    Owner:  anonymous      |    Reporter:  jonas@example.com               
     48---------------------------+------------------------------------------------
     49Changes:
     50  * component:  changset view => search system
     51  * priority:  low => highest
     52  * owner:  jonas => anonymous
     53  * cc:  daniel@example.com =>
     54         daniel@example.com, jonas@example.com
     55  * status:  new => assigned
     56
     57Comment:
     58I'm interested too!
     59
     60--
     61Ticket URL: <http://example.com/trac/ticket/42>
     62My Project <http://myproj.example.com/>
     63}}}
     64----
     65See also: TracTickets, TracIni, TracGuide