Opened 9 years ago
Closed 9 years ago
Last modified 9 years ago
#11658 closed enhancement (fixed)
Merge Trac notification documentation
|Reported by:||Ryan J Ollos||Owned by:||Ryan J Ollos|
Description (last modified by )
The following documentation was removed from the TracNotification page in this change. The Option documentation will be updated using this info.
smtp_enabled: Enable email notification.
smtp_from: Email address to use for Sender-headers in notification emails.
smtp_from_name: Sender name to use for Sender-headers in notification emails.
smtp_from_author: (since 1.0) Use the author of a change (the reporter of a new ticket, or the author of a comment) as the
From:header value in notification e-mails (default: false). If the author hasn't set an e-mail address,
smtp_from_nameare used instead.
smtp_replyto: Email address to use for Reply-To-headers in notification emails.
smtp_default_domain: (since 0.10) Append the specified domain to addresses that do not contain one. Fully qualified addresses are not modified. The default domain is appended to all username/login for which an email address cannot be found from the user settings.
smtp_always_cc: List of email addresses to always send notifications to. Typically used to post ticket changes to a dedicated mailing list.
smtp_always_bcc: (since 0.10) List of email addresses to always send notifications to, but keeps addresses not visible from other recipients of the notification email
smtp_subject_prefix: (since 0.10.1) Text that is inserted before the subject of the email. Set to "__default__" by default, to mean a prefix like [project_name].
always_notify_reporter: Always send notifications to any address in the reporter field (default: false).
always_notify_owner: (since 0.9) Always send notifications to the address in the owner field (default: false).
always_notify_updater: (since 0.10) Always send notifications to the person who causes the ticket property change and to any previous updater of that ticket (default: true).
use_public_cc: (since 0.10) Addresses in To: (owner, reporter) and Cc: lists are visible by all recipients (default is Bcc: - hidden copy).
use_short_addr: (since 0.10) Enable delivery of notifications to addresses that do not contain a domain (i.e. do not end with @<domain.com>).This option is useful for intranets, where the SMTP server can handle local addresses and map the username/login to a local mailbox. See also
smtp_default_domain. Do not use this option with a public SMTP server.
ignore_domains: (since 0.11) Comma-separated list of domains that should not be considered part of email addresses (for usernames with Kerberos domains).
admit_domains: (since 0.11) Comma-separated list of domains that should be considered as valid for email addresses (such as localdomain).
mime_encoding: (since 0.10) This option allows selecting the MIME encoding scheme. Supported values:
none: default value, uses 7bit encoding if the text is plain ASCII, or 8bit otherwise.
base64: works with any kind of content. May cause some issues with touchy anti-spam/anti-virus engines.
quoted-printable: best for european languages (more compact than base64) if 8bit encoding cannot be used.
ambiguous_char_width: (since 0.12.2) Which width of ambiguous characters (e.g. 'single' or 'double') should be used in the table of notification mail. If 'single', the same width as characters in US-ASCII. This is expected by most users. If 'double', twice the width of US-ASCII characters. This is expected by CJK users.
ticket_subject_template: (since 0.11) A Genshi text template snippet used to get the notification subject.
batch_subject_template: (since 1.0) Like ticket_subject_template but for batch modifications.
email_sender: (since 0.12) Name of the component implementing
IEmailSender. This component is used by the notification system to send emails. Trac currently provides the following components:
SmtpEmailSender: connects to an SMTP server (default).
SendmailEmailSender: runs a
smtp_replyto (or both) must be set, otherwise Trac refuses to send notification mails.
The following options are specific to email delivery through SMTP.
smtp_server: SMTP server used for notification messages.
smtp_port: (since 0.9) Port used to contact the SMTP server.
smtp_user: (since 0.9) User name for authentication SMTP account.
smtp_password: (since 0.9) Password for authentication SMTP account.
use_tls: (since 0.10) Toggle to send notifications via a SMTP server using TLS, such as GMail.
The following option is specific to email delivery through a
sendmail_path: (since 0.12) Path to the sendmail executable. The sendmail program must accept the
Change History (6)
comment:1 by , 9 years ago
comment:2 by , 9 years ago
|Status:||new → assigned|
comment:3 by , 9 years ago
|Release Notes:||modified (diff)|
|Summary:||Update Trac notification document → Update Trac notification documentation|
comment:4 by , 9 years ago
|Milestone:||1.0.2 → 1.1.2|
|Summary:||Update Trac notification documentation → Merge Trac notification documentation|
|Type:||defect → enhancement|
Proposed changes in log:rjollos.git:t11658.
comment:5 by , 9 years ago
|Status:||assigned → closed|
Committed to trunk in .
comment:6 by , 9 years ago
|Release Notes:||modified (diff)|
I was motivated by this edit. I can't see any reason to keep the same documentation in multiple places.