Changes between Version 2 and Version 3 of TracNotification


Ignore:
Timestamp:
May 2, 2019, 9:45:05 AM (14 months ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracNotification

    v2 v3  
    99
    1010== Receiving Notification Mails
     11
    1112When 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.
    1213
     
    3233
    3334=== Configuration Options
    34 These are the available options for the `[notification]` section in trac.ini:
     35
     36These are the available options for the `[notification]` section in `trac.ini`:
    3537
    3638[[TracIni(notification)]]
    3739
    3840=== Example Configuration (SMTP)
     41
    3942{{{#!ini
    4043[notification]
     
    4750
    4851=== Example Configuration (`sendmail`)
     52
    4953{{{#!ini
    5054[notification]
     
    5761}}}
    5862
    59 === Subscriber Configuration
    60 The default subscriptions are configured in the `[notification-subscriber]` section in trac.ini:
    61 
    62 [[TracIni(notification-subscriber)]]
    63 
    64 Each user can override these defaults in his ''Notifications'' preferences.
    65 
    66 For 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 
    6863=== Customizing the e-mail subject
     64
    6965The 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:
    70 {{{#!genshi
     66{{{
    7167$prefix #$ticket.id: $summary
    7268}}}
     69
    7370The following variables are available in the template:
    7471
     
    8279The 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:
    8380
    84 {{{#!genshi
     81{{{
    8582$ticket_body_hdr
    8683$ticket_props
     
    118115
    119116== Sample Email
     117
    120118{{{
    121119#42: testing
     
    227225Alternatively, you can use `smtp_port = 25`.[[br]]
    228226You 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
     230To delete these notifications in Gmail, use the following filter:
     231{{{
     232from:(<smtp_from>) (("Reporter: <username>" -Changes -Comment) OR "Changes (by <username>)" OR "Comment (by <username>)")
     233}}}
     234
     235In Thunderbird, there is no such solution if you use IMAP, see http://kb.mozillazine.org/Filters_(Thunderbird)#Filtering_the_message_body.
     236
     237You can also add this plugin:
     238http://trac-hacks.org/wiki/NeverNotifyUpdaterPlugin, or vote for [trac:#2247] to be fixed.
    229239
    230240== Troubleshooting
     
    237247
    238248Typical error message:
    239 {{{#!sh
     249{{{
    240250  ...
    241251  File ".../smtplib.py", line 303, in connect
     
    250260telnet localhost 25
    251261}}}
     262
    252263This is because a regular user may connect to the SMTP server, but the web server cannot:
    253264{{{#!sh
     
    257268In 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.
    258269
    259 Relevant ML threads:
    260  * SELinux: http://article.gmane.org/gmane.comp.version-control.subversion.trac.general/7518
     270Relevant mailing list thread on SELinux: http://article.gmane.org/gmane.comp.version-control.subversion.trac.general/7518
    261271
    262272For SELinux in Fedora 10:
    263273{{{#!sh
    264 $ setsebool -P httpd_can_sendmail 1
     274setsebool -P httpd_can_sendmail 1
    265275}}}
    266276