]> git.etc.gen.nz Git - spong.git/commitdiff
added information about the new predata and postdata spong-server modules
authorStephen L Johnson <sjohnson@monsters.org>
Wed, 29 May 2002 01:47:10 +0000 (01:47 +0000)
committerStephen L Johnson <sjohnson@monsters.org>
Wed, 29 May 2002 01:47:10 +0000 (01:47 +0000)
pod/developer-guide.pod

index 9710276382b9886aa452e25def9bf506b9141b7b..34453aa35e0c0f5fb83c0655be343f5ab6c84441 100755 (executable)
@@ -162,8 +162,30 @@ develops a fatal error, it should terminate using the die() or croak()
 functions depending on ones preference. Modules should just return upon a 
 successful invocation.  
 
+NEW
+
+There are two new types of Spong Server plugin modules: predata and postdata
+modules.  The predata modules are called just after a message is received but
+before the normal Spong processing is done. And a post module is called after
+the Server's normal processing. i
+
+Also in contrast to the old Spong Server data plugin modules all incoming
+messages a sent to the new predata and postdata modules, not just status
+messages.  Predata modules can even flag a message to tell the Spong Server to
+drop the message and ignore it.  This will allow you a great deal more access
+and control of the Server's incoming message processing. 
+
+Modules are called a predictable, controlable order. There are run in the order
+of the sorted registry hash keys. This allows you to create modules that have
+run dependencies. 
+
+And there is a new API to go along with the new modules. Now parameters are
+passed in a Perl hash. This simplifies the module interface to the server. The
+message type is determined by the C<cmd> field. Message hash details are 
+in the L<spong-server-mod-template> document.
+
 See L<spong-server-mod-template> for an example of how to code a
-B<spong-server> Server Data Module.
+B<spong-server> Server Data Modules
 
 =head2 CLIENT MODULES