From: PeterThoeny Date: Thu, 30 Jan 2003 07:43:00 +0000 (+0000) Subject: none X-Git-Url: https://git.openafs.org/?p=openafs-wiki.git;a=commitdiff_plain;h=4356569947baa80bcae05542532ab2eb5c333118 none --- diff --git a/TWiki/TWikiSiteTools.mdwn b/TWiki/TWikiSiteTools.mdwn index 8a1b608..7311c2f 100644 --- a/TWiki/TWikiSiteTools.mdwn +++ b/TWiki/TWikiSiteTools.mdwn @@ -1,6 +1,6 @@
-# TWikiSiteTools +# TWiki Site Tools _Utilities for searching, navigation, and monitoring site activity_ @@ -29,14 +29,28 @@ _Utilities for searching, navigation, and monitoring site activity_ ## WebNotify Recent Changes Alert -Each TWiki web has an automatic email alert service that sends a list of recent changes on a preset schedule, like once a day. Users can subscribe and unsubscribe using [[WebNotify]] in each web. The Perl script `mailnotify` is called by a deamon in regular intervals. The script sends an automated email to subscribed users if topics were changed in a web within last interval. +Each TWiki web has an automatic email alert service that sends a list of recent changes on a preset schedule, like once a day. Users can subscribe and unsubscribe using [[WebNotify]] in each web. The Perl script `mailnotify` is called by a background process at regular intervals. The script sends an automated email to subscribed users if topics were changed in a web since the script was last run. -- You can create a [[WebNotify]] using [[TWikiVariables]] with **%NOTIFYTOPIC%** +- You can create a [[WebNotify]] link using [[TWikiVariables]] with **%NOTIFYTOPIC%** + +TWiki handles WebNotify entries that include the [[WikiName]] of a user or a [[TWikiGroup|Main/TWikiGroups]] and an optional e-mail address. Example entries in WebNotify: + + * Main.FredBloggs + * Main.FredBloggs - secondary@home.com + * Main.EngineeringGroup + +The first entry is the default form, the notification gets sent to the e-mail address specified in the user's home page. The second entry lists an alternative e-mail address. The third entry specifies a group, the notification gets sent to each member of the group. + +You can also use `%MAINWEB%` instead of `Main`, but this is not necessary even if you have renamed the main web by configuring `$mainWebname` in `TWiki.cfg`. ### Configuring Outgoing Mail %WIKITOOLNAME% will use the **Net::SMTP** module if it is installed on your system. Set this with the **SMTPMAILHOST** variable in [[TWikiPreferences]]. +The notify e-mail uses the default `changes.tmpl` template, or a skin if activated in the [[TWikiPreferences]]. + +mailnotify also relies on two hidden files in each `TWiki/data/[web]` directory: `.changes` and `.mailnotify.` Make sure both are writable by your web server process. `.changes` contains a list of changes; go ahead and make this empty. `.mailnotify` contains a timestamp of the last time notification was done. + You can use an external mail program, like **sendmail**, if the `Net::SMTP` module is not installed. Set the program path in **$mailProgram** in **TWiki.cfg**. - %H% Net::SMTP can be easily disabled (ex: if there is an installation error) by setting **SMTPMAILHOST** in [[TWikiPreferences]] to an empty value. @@ -106,4 +120,4 @@ This is simply a preset `SEARCH`. The number of topics listed by the `limit` par > %SEARCH{"\.*" scope="topic" regex="on" nosearch="on"}% --- [[MikeMannix]] - 01 Dec 2001 +-- [[MikeMannix]] - 01 Dec 2001 %BR% -- [[PeterThoeny]] - 30 Jan 2003