Skip to topic | Skip to bottom
Home

TWiki
TWiki.ImmediateNotifyPluginr1.9 - 06 Mar 2005 - 19:43 - FabioVitalitopic end

Start of topic | Skip to actions

Immediate Notify Plugin

This is a plugin that allows users to register 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.

  • 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 TWiki is running.

  • Download the ZIP file and necessary patches from the Plugin web (see below)
  • Patch your TWiki installation to add the new plugin hook:
    • In the lib/TWiki/ directory, run the command patch < /path/to/afterSaveHandler.patch
  • Patch the Net::Jabber Perl module.
    • Find Jabber.pm
    • In the directory containing Jabber.pm, run the command patch < /path/to/net_jabber_taint_fix.patch
  • Unzip ImmediateNotifyPlugin.zip in your twiki installation directory. Content:
    File: Description:
    data/TWiki/ImmediateNotifyPlugin.txt Plugin topic
    data/TWiki/ImmediateNotifyPlugin.txt,v Plugin topic repository
    lib/TWiki/Plugins/ImmediateNotifyPlugin.pm Plugin Perl module
    lib/TWiki/Plugins/ImmediateNotifyPlugin/*.pm Notification method Perl modules
    templates/immediatenotify-*.tmpl Message templates for the notification methods
  • Set up notification methods
    • 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.
  • 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: 16 Mar 2003 (V0.2)
Change History:  
16 Mar 2003: Added support for groups and SMTP
03 Feb 2003: Initial version
CPAN Dependencies: XML::Stream, Net::Jabber (w/patch)
Other Dependencies: none
Perl Version: 5.6.1 (untested on earlier versions)
Plugin Home: http://TWiki.org/cgi-bin/view/Plugins/ImmediateNotifyPlugin
Feedback: http://TWiki.org/cgi-bin/view/Plugins/ImmediateNotifyPluginDev

Related Topics: TWikiPreferences, TWikiPlugins, DefaultPlugin

-- TWiki:Main/JuergenPabel - 16 Mar 2003
to top


You are here: TWiki > ImmediateNotifyPlugin

to top

Copyright © Fabio Vitali 2017 Last update of ImmediateNotifyPlugin on 06 Mar 2005 - 19:43 by FabioVitali