Trac Plugin to allow email notification of changes on wiki pages
Project description
Trac WikiNotification is a plugin that allows users(even anonymous, as long as email is set) to select the wiki pages that they wish to be notified(by email) when a change occurs on it.
Note: The user updating the wiki page won’t be notified about his own changes.
You can find more info on the trac WikiNotification site where bugs and new feature requests should go to.
Enabling the Plugin
It’s as simple as:
[components] wikinotification.* = enabled
smtp_enabled has to be enabled in notification configuration section.
Available Configuration Options
These are the options available to include on your trac.ini under wiki-notification. Some of them you can configure through web admin interface.
Config Setting |
Default Value |
Explanation |
redirect_time |
5 (in seconds) |
The default seconds a redirect should take when watching/un-watching a wiki page. This value is also definable per user, ie, user is able to configure this, of course for himself. |
smtp_always_bcc |
empty |
Comma separated list of email address(es) to always send notifications to, addresses do not appear publicly (Bcc:). |
smtp_always_cc |
empty |
Comma separated list of email address(es) to always send notifications to, addresses can be seen by all recipients (Cc:). |
smtp_from |
trac.wiki@localhost |
Sender address to use in notification emails. |
from_name |
None |
Sender name to use in notification emails. Defaults to project name. |
use_public_cc |
False |
Recipients can see email addresses of other CC’ed recipients. If this option is disabled(the default), recipients are put on BCC. |
attach_diff |
False |
Send changes diff as an attachment instead of on the email text body. |
subject_template |
$prefix $page.name $action |
A Genshi text template snippet used to get the notification subject. |
banned_addresses |
empty |
Comma separated list of email addresses to never send notifications to. |
If you want to override these settings then you can include it like the following example:
[wiki-notification] redirect_time = 5 smtp_always_bcc = someone@somedomain, another.one@somedomain smtp_always_cc = someone.else@somedomain smtp_from = trac.wiki@localhost from_name = Custom Name use_public_cc = false attach_diff = true subject_template = Foo $prefix $page.name $action banned_addresses = banned.user1@somedomain, banned.user2@somedomain
Note: For an up-to-date version of this info please read this.
Download and Installation
Trac WikiNotification can be installed with Easy Install by typing:
> sudo easy_install TracWikiNotification
To install the development version:
> sudo easy_install http://wikinotification.ufsoft.org/svn/trunk
If you run Trac versions < 0.11.x do the following instead:
> sudo easy_install "TracWikiNotification<0.2.0"
Trac 0.11 support And Latest WikiNotification Release
As of time of this writing (Mar 3 2008), trac>=0.11 only is supported. You won’t need ctxnavadd, aka, TracCtxtnavAdd no more.
Aditional Notes(from user input)
easy_install is run from the command line (on Linux) not from within Python.
After installing any plugin for Trac you’ll need to restart Apache to see it (not all changes to trac.ini require a restart but adding a plugin does).
Make sure to add the new plugin to trac.ini :
[components] wikinotification.* = enabled
Also should be noted that the trac.ini configuration for the wiki notification should look something like:
[wiki-notification] smtp_always_cc = someone@somedomain smtp_from = trac.wiki@localhost
Another note: a user will never get a notice of his/her own wiki modification (which is a little tricky when testing the plugin :))
Tweaking/Customizing The Notification Email Template
You can, if you wish, tweak the notification email template sent to your users.
Copy the wiki_notification_email_template.txt file to your trac environment templates/ sub-directory and tweak it to your needs.
Make sure you read the Genshi Text Templates documentation to see if you don’t break any of the logic in that template.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
File details
Details for the file TracWikiNotification-0.4.zip.
File metadata
- Download URL: TracWikiNotification-0.4.zip
- Upload date:
- Size: 25.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 23f5d97faa740b72f88d758126ed1018221c9bc5b4e4b7316971c3e738b511a7 |
|
| MD5 | 8570d9489152c9cf2cd4b0aa345b5616 |
|
| BLAKE2b-256 | b690330421ac8895f8ed78e13d72bbd3fdff0a217c662073a21faa8b7457adb9 |
File details
Details for the file TracWikiNotification-0.4.tar.gz.
File metadata
- Download URL: TracWikiNotification-0.4.tar.gz
- Upload date:
- Size: 14.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | c4d05f9c0ef5aec68b323686c29ccfcdd101fc10702d74806a265ce219363fcf |
|
| MD5 | 4d3593260354dd4d2a1a754a86be6df7 |
|
| BLAKE2b-256 | b93e0973908d345ad2175e56d9c0b83fcd9faaf6ed15e10bd067e41f4b189ca7 |
File details
Details for the file TracWikiNotification-0.4.tar.bz2.
File metadata
- Download URL: TracWikiNotification-0.4.tar.bz2
- Upload date:
- Size: 13.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 624bc66b6d0da68a10a051755c8c98549b6dc4a11642cff47b03141e52134159 |
|
| MD5 | a45fb10686993b7bf741381f23d0d9ac |
|
| BLAKE2b-256 | c43b8979bab2d35265db68f7ec57c80e9d7106f5c789a4360c97ba473302e126 |
