"There is no time like the pleasant." - George Bergman

Table of Contents [Hide/Show]


Edit

Overview

The purpose of this plugin is to allow the admin of a screwturn wiki to watch certain pages and/or categories and send a notification email to one or more email addresses.

Download: PageChangeAlerts.zip

Full source is included in this file as well as the compiled dll. Source is released to the public domain and may be used in any way you like. No support is offered or implied. If I'm able, I will answer questions.

Edit

Installation/usage

Install the dll (PageChangeAlerts.dll) using the providers tab within the wiki's admin page. After it's loaded, select the PageChangeAlerts provider and select configure. In the configuration box, you will type one or more lines. Each line will represent a page or category you wish to track and who should be notified when/if that item changes.

Each line consists of 3 parts separated by a "|" character:

  • The first part is the word "Page" or "Category". The plugin is relatively forgiving about the spelling as long as the first character is "p" or "c". Anything else in the first part will cause that line to be ignored.
  • The second part is the name of the page or category you wish to track. Spelling must be correct but it's not case-sensitive. If you set the page name to "*", this line will watch all pages.
  • The 3rd part is a list of email addresses that should be notified. If the email address associated with the person that made the change is on this list, they will not get an email.

Page|MainPage|address1@domain.com,address2@domain.com
Category|Draft|address1@domain.com
Page|*|address3@domain.com

The combination of the first 2 parts must be unique. If you list the same category or page twice, the last one is the one that will be used.

Logic note: if the email address that is supposed to be notified is the same as the address of the person making the change, that email will not be sent. No point annoying yourself with notifications about the thing you just did.

Edit

Sample email

A Wiki page or category you are subscribed to has been updated. Contact the Wiki admin (adminaddress@domain.com)
if you wish to be unsubscribed from this page.

Page Name: Page Title (PageName)
Categories: cat1, cat2
URL: http://server/wiki/Pagename.ashx
Update by username at timestamp
Update type: PageModified

Edit

Known issues

Changes to the discussion pages don't cause the event I'm watching to fire as of the latest version of the wiki (2.0.31). When/if that behavior is updated on the wiki, I'll update this plugin (if needed) accordingly.

Discussion thread: http://www.screwturn.eu/forum/viewtopic.php?f=8&t=4177&p=7544

Edit

Release notes

  • 06-Oct-2008 - Changed to use the FindUser method instead of scanning the AllUsers array. See this thread for more info.

ScrewTurn Wiki version 2.0.33. Current Page Count: 23. Some of the icons created by FamFamFam.