Edgewall Software

Changes between Version 89 and Version 90 of TracNotification


Ignore:
Timestamp:
Nov 14, 2016, 1:30:36 AM (7 years ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • TracNotification

    v89 v90  
    11= Email Notification of Ticket Changes
    22[[TracGuideToc]]
    3 [[TranslatedPages]]
    43
    54Trac supports notification of ticket changes via email.
     
    109
    1110== Receiving Notification Mails
    12 
    1311When reporting a new ticket or adding a comment, enter a valid email address or your Trac username in the ''reporter'', ''assigned to/owner'' or ''cc'' field. Trac will automatically send you an email when changes are made to the ticket, depending on how notification is configured.
    1412
     
    3432
    3533=== Configuration Options
    36 
    37 These are the available options for the `[notification]` section in `trac.ini`:
     34These are the available options for the `[notification]` section in trac.ini:
    3835
    3936[[TracIni(notification)]]
    4037
    4138=== Example Configuration (SMTP)
    42 
    4339{{{#!ini
    4440[notification]
     
    5147
    5248=== Example Configuration (`sendmail`)
    53 
    5449{{{#!ini
    5550[notification]
     
    6257}}}
    6358
     59=== Subscriber Configuration
     60The default subscriptions are configured in the `[notification-subscriber]` section in trac.ini:
     61
     62[[TracIni(notification-subscriber)]]
     63
     64Each user can override these defaults in his ''Notifications'' preferences.
     65
     66For example to unsubscribe from notifications for one's own changes and comments, the rule "Never notify: I update a ticket" should be added above other subscription rules.
     67
    6468=== Customizing the e-mail subject
    65 
    6669The e-mail subject can be customized with the `ticket_subject_template` option, which contains a [http://genshi.edgewall.org/wiki/Documentation/text-templates.html Genshi text template] snippet. The default value is:
    67 {{{
     70{{{#!genshi
    6871$prefix #$ticket.id: $summary
    6972}}}
    70 
    7173The following variables are available in the template:
    7274
     
    8082The notification e-mail content is generated based on `ticket_notify_email.txt` in `trac/ticket/templates`. You can add your own version of this template by adding a `ticket_notify_email.txt` to the templates directory of your environment. The default looks like this:
    8183
    82 {{{
     84{{{#!genshi
    8385$ticket_body_hdr
    8486$ticket_props
     
    116118
    117119== Sample Email
    118 
    119120{{{
    120121#42: testing
     
    226227Alternatively, you can use `smtp_port = 25`.[[br]]
    227228You should not use `smtp_port = 465`. Doing so may deadlock your ticket submission. Port 465 is reserved for the SMTPS protocol, which is not supported by Trac. See [trac:comment:2:ticket:7107 #7107] for details.
    228  
    229 == Filtering notifications for one's own changes and comments
    230 
    231 To delete these notifications in Gmail, use the following filter:
    232 {{{
    233 from:(<smtp_from>) (("Reporter: <username>" -Changes -Comment) OR "Changes (by <username>)" OR "Comment (by <username>)")
    234 }}}
    235 
    236 In Thunderbird, there is no such solution if you use IMAP, see http://kb.mozillazine.org/Filters_(Thunderbird)#Filtering_the_message_body.
    237 
    238 You can also add this plugin:
    239 http://trac-hacks.org/wiki/NeverNotifyUpdaterPlugin, or vote for [trac:#2247] to be fixed.
    240229
    241230== Troubleshooting
     
    248237
    249238Typical error message:
    250 {{{
     239{{{#!sh
    251240  ...
    252241  File ".../smtplib.py", line 303, in connect
     
    261250telnet localhost 25
    262251}}}
    263 
    264252This is because a regular user may connect to the SMTP server, but the web server cannot:
    265253{{{#!sh
     
    269257In such a case, you need to configure your server so that the web server is authorized to post to the SMTP server. The actual settings depend on your Linux distribution and current security policy. You may find help in the Trac [trac:MailingList MailingList] archive.
    270258
    271 Relevant mailing list thread on SELinux: http://article.gmane.org/gmane.comp.version-control.subversion.trac.general/7518
     259Relevant ML threads:
     260 * SELinux: http://article.gmane.org/gmane.comp.version-control.subversion.trac.general/7518
    272261
    273262For SELinux in Fedora 10:
    274263{{{#!sh
    275 setsebool -P httpd_can_sendmail 1
     264$ setsebool -P httpd_can_sendmail 1
    276265}}}
    277266