Changes between Version 1 and Version 2 of TracNotification


Ignore:
Timestamp:
2017-02-06T16:24:15-04:00 (7 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracNotification

    v1 v2  
    99
    1010== Receiving Notification Mails
    11 
    1211When 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.
    1312
     
    3332
    3433=== Configuration Options
    35 
    36 These are the available options for the `[notification]` section in `trac.ini`:
     34These are the available options for the `[notification]` section in trac.ini:
    3735
    3836[[TracIni(notification)]]
    3937
    4038=== Example Configuration (SMTP)
    41 
    4239{{{#!ini
    4340[notification]
     
    5047
    5148=== Example Configuration (`sendmail`)
    52 
    5349{{{#!ini
    5450[notification]
     
    6157}}}
    6258
     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
    6368=== Customizing the e-mail subject
    64 
    6569The 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:
    66 {{{
     70{{{#!genshi
    6771$prefix #$ticket.id: $summary
    6872}}}
    69 
    7073The following variables are available in the template:
    7174
     
    7982The 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:
    8083
    81 {{{
     84{{{#!genshi
    8285$ticket_body_hdr
    8386$ticket_props
     
    115118
    116119== Sample Email
    117 
    118120{{{
    119121#42: testing
     
    225227Alternatively, you can use `smtp_port = 25`.[[br]]
    226228You 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.
    227  
    228 == Filtering notifications for one's own changes and comments
    229 
    230 To delete these notifications in Gmail, use the following filter:
    231 {{{
    232 from:(<smtp_from>) (("Reporter: <username>" -Changes -Comment) OR "Changes (by <username>)" OR "Comment (by <username>)")
    233 }}}
    234 
    235 In Thunderbird, there is no such solution if you use IMAP, see http://kb.mozillazine.org/Filters_(Thunderbird)#Filtering_the_message_body.
    236 
    237 You can also add this plugin:
    238 http://trac-hacks.org/wiki/NeverNotifyUpdaterPlugin, or vote for [trac:#2247] to be fixed.
    239229
    240230== Troubleshooting
     
    247237
    248238Typical error message:
    249 {{{
     239{{{#!sh
    250240  ...
    251241  File ".../smtplib.py", line 303, in connect
     
    260250telnet localhost 25
    261251}}}
    262 
    263252This is because a regular user may connect to the SMTP server, but the web server cannot:
    264253{{{#!sh
     
    268257In 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.
    269258
    270 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
    271261
    272262For SELinux in Fedora 10:
    273263{{{#!sh
    274 setsebool -P httpd_can_sendmail 1
     264$ setsebool -P httpd_can_sendmail 1
    275265}}}
    276266