wiki:WikiNotificationPlugin

Version 35 (modified by figaro, 8 years ago) (diff)

Updated pypi link

Trac Wiki Notification Plugin

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. See also AnnouncerPlugin for another notification possibility, which is agnostic to what is being watched.

Note: The user updating the wiki page won't be notified about his own changes.

Enabling the Plugin

It's as simple as:

[components]
wikinotification.* = enabled

And optionally:

ctxtnavadd.* = enabled

Available Configuration Options

These are the options available to include in your trac.ini under wiki-notification.

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 seen 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.

If you want to override these settings then you can include it like the following example:

[wiki-notification]
redirect_time = 5
smtp_always_bcc =
smtp_always_cc =
smtp_from = trac.wiki@localhost
use_public_cc = false

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 :))

  • Please note that older versions of the plugin may set a subject_template config value, similar to subject_template = $prefix $page.name $action. This is incompatible with Trac 0.12.2 and WNP 0.2.2, and if present will result in 'UndefinedError: "page" not defined'.

Bugs/Feature Requests

Please use GitHub for any issues you have with TracWikiNotification.

Download

Download the zipped source from GitHub.

There is also a version on PyPi.

Source

You can clone TracWikiNotification from GitHub using git, or browse the source on GitHub.

Installation

Run the following to install this plugin:

pip install TracWikiNotification

For more information, please follow the Trac documentation on how to install plugins.

Author/Contributors

Author: s0undt3ch
Maintainer: mitar
Contributors: