Edgewall Software

Changes between Version 103 and Version 104 of TracNotification


Ignore:
Timestamp:
Oct 15, 2019, 6:36:11 AM (5 years ago)
Author:
trac
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • TracNotification

    v103 v104  
    33[[TranslatedPages]]
    44
    5 Trac supports notification of ticket changes via email. 
     5Trac supports notification of ticket changes via email.
    66
    77Email notification is useful to keep users up-to-date on tickets of interest, and also provides a convenient way to post all ticket changes to a dedicated mailing list.
     
    1010
    1111== Receiving Notification Mails
    12 When 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.
     12When 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 may send you an email when changes are made to the ticket, depending on how your notification preferences are configured.
     13
     14Permission groups can also be entered in the CC field,
     15to notify all members of the group.
    1316
    1417=== How to use your username to receive notification mails
    1518
    16 To receive notification mails, you can either enter a full email address or your Trac username. To get notified with a simple username or login, you need to specify a valid email address in your [/prefs preferences]. 
     19To receive notification mails, you can either enter a full email address or your Trac username. To get notified with a simple username or login, you need to specify a valid email address in your [/prefs preferences].
    1720
    1821Alternatively, a default domain name ('''`smtp_default_domain`''') can be set in the TracIni file, see [#ConfigurationOptions Configuration Options] below. In this case, the default domain will be appended to the username, which can be useful for an "Intranet" kind of installation.
     
    3033== Configuring SMTP Notification
    3134
    32 '''Important:''' The [[TracIni#trac-base_url-option|[trac] base_url]] option must be configured for links in the notification message to be correctly generated. 
     35'''Important:''' The [[TracIni#trac-base_url-option|[trac] base_url]] option must be configured for links in the notification message to be correctly generated.
    3336
    3437=== Configuration Options
     
    106109The following variables are available in the template:
    107110
    108  * `env`: The project environment object (see [trac:source:branches/1.2-stable/trac/env.py env.py]).
     111 * `changes`: The ticket changes (prepared by [trac:source:/branches/1.4-stable/trac/ticket/model.py Ticket.get_change]).
     112 * `env`: The project environment (see [trac:source:/branches/1.4-stable/trac/env.py env.py]).
    109113 * `prefix`: The prefix defined in `smtp_subject_prefix`.
    110114 * `summary`: The ticket summary, with the old value if the summary was edited.
    111  * `ticket`: The ticket model object (see [trac:source:branches/1.2-stable/trac/ticket/model.py model.py]). Individual ticket fields can be accessed by appending the field name separated by a dot, eg `${ticket.milestone}`.
     115 * `ticket`: The ticket model object (see [trac:source:/branches/1.4-stable/trac/ticket/model.py model.py]). Individual ticket fields can be addressed by appending the field name separated by a dot, eg `$ticket.milestone`.
    112116
    113117=== Customizing the email content
     
    156160#42: testing
    157161---------------------------+------------------------------------------------
    158        Id:  42             |      Status:  assigned               
     162       Id:  42             |      Status:  assigned
    159163Component:  report system  |    Modified:  Fri Apr  9 00:04:31 2004
    160  Severity:  major          |   Milestone:  0.9                     
    161  Priority:  lowest         |     Version:  0.6                     
    162     Owner:  anonymous      |    Reporter:  jonas@example.com               
     164 Severity:  major          |   Milestone:  0.9
     165 Priority:  lowest         |     Version:  0.6
     166    Owner:  anonymous      |    Reporter:  jonas@example.com
    163167---------------------------+------------------------------------------------
    164168Changes: