{{{ #!text/x-rst ============================== Trac Wiki Notification Plugin ============================== Trac Wiki Notification 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. You can find more info on the `Trac WikiNotification `_ site where bugs and new feature requests should go to. The http://wikinotification.ufsoft.org/ site is having many problems. It was down and slow and then I cannot post anything, neither from work, nor from home, even after I register and login. Everytime I got the same message with same IP address which was not possible to be same when I did it from work and home. Submission rejected as potential spam (IP 10.1.0.4 blacklisted by bsb.empty.us, sc.surbl.org) There is a bug I want to report: When trac is behind the firewall using reverse proxy, the redirect failed as it uses `abs_href` instead simple `href` in the web_ui.py file. I removed `abs_` and it worked file. Enabling the Plugin ------------------- It's as simple as:: [components] wikinotification.* = enabled And optionally: ctxtnavadd.* = enabled Available Config Options ------------------------ These are the options available to include on your *trac.ini*. ===================== ==================== ================================ **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* Email address(es) to always send notifications to, addresses do not appear publicly (Bcc:). --------------------- -------------------- -------------------------------- *smtp_always_cc* *empty* Email address(es) to always send notifications to, addresses can be see by all recipients (Cc:). --------------------- -------------------- -------------------------------- *smtp_from* trac.wiki\@localhost Sender address to use in notification emails. --------------------- -------------------- -------------------------------- *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. ===================== ==================== ================================ Download and Installation ------------------------- Trac WikiNotification can be installed with `Easy Install `_ by typing:: > easy_install TracWikiNotification }}} Some notes for the noobs amongst us: 1. {{{easy_install}}} is run from the command line (on Linux) not from within Python. 2. 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). 3. Make sure to add the new plugin to {{{trac.ini}}}: {{{ [components] ctxtnavadd.* = enabled wikinotification.* = enabled }}} 4. 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 }}}