TIP There is a newer version of this plugin available for testing.
TIP ImmediateNotifyPlugin is not installed on Foswiki.org.

Immediate Notify Plugin

Please read Foswiki:Extensions.MailerContrib.

This is a plugin that allows users to be immediately notified when topics or webs are modified.

Syntax Rules

Once the plugin is installed, users can register for notification in the WebImmediateNotify topics by including their username as an entry in a list. In order to recieve notifications, they must also configure their desired notification method. Since SMTP and Jabber are currently the only available methods, this consists of:
  • Adding a line "      * Set IMMEDIATENOTIFYMETHOD = Jabber" (or "SMTP", respectively) to their topic.
  • Adding a line "Jabber: jabber_user@jabber_server.org" to their topic for notification per Jabber (no configuration is needed for SMTP).

ImmediateNotifyPlugin Global Settings

  • One line description, shown in the TextFormattingRules topic:
    • Set SHORTDESCRIPTION = Allows immediate notification of topic changes through SMTP or Jabber

  • Notification method configuration:
    • Set METHODS = SMTP
  • Jabber method configuration:
    • Set JABBER_USERNAME =
    • Set JABBER_PASSWORD =
    • Set JABBER_SERVER =

  • Debug plugin: (See output in data/debug.txt)
    • Set DEBUG = 0

Plugin Installation Instructions

Note: You do not need to install anything on the browser to use this plugin. The following instructions are for the administrator who installs the plugin on the server where Foswiki is running.

  • Download the ZIP/TGZ file from the Plugin web (see below)
  • Unzip ImmediateNotifyPlugin.zip in your Foswiki installation directory. Content:
    File: Description:
    lib/Foswiki/Plugins/ImmediateNotifyPlugin.pm  
    lib/Foswiki/Plugins/ImmediateNotifyPlugin/Jabber.pm  
    lib/Foswiki/Plugins/ImmediateNotifyPlugin/SMTP.pm  
    data/System/ImmediateNotifyPlugin.txt  
    templates/smtp.immediatenotify.tmpl  

  • Set up notification methods (default is SMTP)
    • Currently the only available methods are via SMTP and Jabber.
      • SMTP
        • The site's configuration is used - no additional configuration is needed.
      • Jabber
        • Set up a Jabber account for the wiki with a standard client.
        • Set JABBER_USERNAME, JABBER_PASSWORD, and JABBER_SERVER in the plugin topic.
  • Visit configure in your Foswiki installation, and enable the plugin in the {Plugins} section.
  • Create a WebImmediateNotify topic in each web for users to list their names in for notification.

Plugin Info

Plugin Author: TWiki:Main/WalterMundt & TWiki:Main/JuergenPabel
Plugin Version: v0.3.1 (05 Jan 2010)
Change History:  
05 Jan 2010 Ported to Foswiki (Foswiki:Main.WillNoris)
21 May 2007 Bugs:Item3969 - 8bit email fix (Foswiki:Main.WillNorris)
26 Jul 2006: (v0.3) - Foswiki:Main.SteffenPoulsen: Ported to TWiki-4 / Dakar
16 Mar 2003: Added support for groups and SMTP
03 Feb 2003: Initial version
CPAN Dependencies: CPAN:XML::Stream, CPAN:Net::Jabber (2.0) (Only for Jabber notifications, SMTP notifications will work without these CPAN modules)
Other Dependencies: none
Perl Version: > 5.6.1
Plugin Home: http://foswiki.org/Extensions/ImmediateNotifyPlugin
Support: http://foswiki.org/Support/ImmediateNotifyPlugin

Related Topics: DefaultPreferences, SitePreferences, Plugins, DefaultPlugin

-- TWiki:Main/WalterMundt - 04 Feb 2003, TWiki:Main/JuergenPabel - 16 Mar 2003
I Attachment Action Size Date Who Comment
ImmediateNotifyPlugin.md5md5 ImmediateNotifyPlugin.md5 manage 186 bytes 06 Jan 2010 - 01:01 WillNorris  
ImmediateNotifyPlugin.sha1sha1 ImmediateNotifyPlugin.sha1 manage 210 bytes 06 Jan 2010 - 01:01 WillNorris  
ImmediateNotifyPlugin.tgztgz ImmediateNotifyPlugin.tgz manage 7 K 06 Jan 2010 - 01:01 WillNorris  
ImmediateNotifyPlugin.zipzip ImmediateNotifyPlugin.zip manage 10 K 06 Jan 2010 - 01:00 WillNorris  
ImmediateNotifyPlugin_installerEXT ImmediateNotifyPlugin_installer manage 4 K 06 Jan 2010 - 01:01 WillNorris  
Topic revision: r1 - 06 Jan 2010, WillNorris
The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License    Legal Imprint    Privacy Policy