Changes between Initial Version and Version 1 of TracNotification


Ignore:
Timestamp:
11/14/05 13:36:26 (19 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