[[PageOutline(2-5,Contents,pullout)]]
= A script to send E-Mail notification of changes to Wiki pages =

{{{
#!html
<div class="system-message" float="left" overflow="auto">
<b>Notice:</b> This script is deprecated. Please see the <a href="http://trac-hacks.org/wiki/WatchlistPlugin">WatchlistPlugin</a> and <a href="http://trac-hacks.org/wiki/AnnouncerPlugin">AnnouncerPlugin</a> for supported alternatives.</div>
}}}

== Description ==

The WikiNotifyScript extracts a list of E-Mail addresses from a TracWiki page and mails a list of Wiki changes to them.

The page is parsed for any TracWiki lists. Each list entry is expected to be an E-Mail address. eg.

{{{
= Notify these users of changes to the Wiki =
  * alec@swapoff.org
  * trac@swapoff.org
}}}

Here are the command line arguments for WikiNotifyScript:

{{{
trac-wiki-notify <trac-url> <trac-path> <wiki-notification-page> <time-delta> <from-address> [<smtp-server>]
}}}

I use the page WikiNotify for this purpose, though any page can be used.

== Bugs/Feature Requests == 

Existing bugs and feature requests for WikiNotifyScript are 
[report:9?COMPONENT=WikiNotifyScript here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=WikiNotifyScript&owner=athomas new ticket].

== Download ==

download:wikinotifyscript

== Source ==

You can check out the source for WikiNotifyScript from Subversion at http://trac-hacks.org/svn/wikinotifyscript.

== Example ==

Here is an example of using the script on [wiki:SwapOff SwapOff.org]:

{{{
/usr/local/bin/trac-wiki-notify http://svn.swapoff.org/trachacks/ /srv/trac/trachacks WikiNotify 3600 trac@swapoff.org
}}}

Actually, I use something like the following to do notification for all my Trac instances at once:

{{{
cd /srv/trac; for d in */db; do d=`dirname $d`; /usr/local/bin/trac-wiki-notify http://svn.swapoff.org/$d/ /srv/trac/$d WikiNotify 3600 trac@swapoff.org 10.0.0.254; done
}}}


== Author/Contributors ==

'''Author:''' [wiki:athomas athomas] [[BR]]
'''Maintainer:''' ''none (deprecated)'' [[BR]]
'''Contributors:'''