Blog::Spam::Plugin::Sample - A sample plugin.
This is a sample plugin which is designed to demonstrate the functionality which a plugin may implement to be usefully called by Blog::Spam::Server.
As this is just an example plugin it does nothing useful.
The Blog::Spam::Server receives comment data, via XML::RPC, from remote clients.
These incoming comments, and associated meta-data, will be examined by each known plugin in turn. If a single plugin determines the comment is SPAM then all further testing is ceased.
This module is an example of one such plugin, and when the server is installed it will be called in order, along with any others.
For a plugin to be loaded it must live beneath the Blog::Spam::Plugin namespace.
There are two mandatory methods which must be implemented ("new" + "name"), three optional methods ("testComment", "expire", "logMessage").
The new and name methods are required for the plugin loading to succeed - the latter three optional methods are invoked at various points.
For example the testComment method will be called to test the state of an incoming comment "SPAM" or "OK". The expire method will be called periodically, if available, to carry out house-keeping tasks.
Finally the logMessage method will be invoked, when implemented, when the server has decided whether a message is SPAM or OK.
This method is called when the server is started, and all plugins are loaded. This method is mandatory.
Return the name of this plugin. This method is mandatory. (To allow the server to sort plugin names, and thus call them in order.)
This method is invoked upon the reception of an incoming comment to test.
The arguments are a pointer to the server object, and a hash of values read from the remote client. (These remote keys include such things as the IP address of the comment submitter, their name, their email address and the comment itself. For a full list please consult Blog::Spam::API.)
There are two valid return values "OK", which means the comment should be allowed to continue, and "SPAM" which means the plugin has determined the comment to be SPAM.
Optionally the SPAM result may be qualified with a human-readable explanation:
return "SPAM:This comment defames me";
Some plugins maintain state which must be expired. If this method is implemented it will be invoked upon a regular frequency, with the intention that a plugin may expire its state at that time.
There are two arguments, the first is a handle to the Blog::Spam::Server object, and the second is a frequency label:
This method has been called once per hour.
This method has been called once per day.
This method has been called once per week.
This method is optional.
This method will be called when the server wishes to log a result of a connection. ie. It will be called once for each received comment at the end of the testComment function.
The message structure, as submitted to testing, will be supplied as a hash, and this hash will contain a couple of additional keys:
The result of the test "OK" or "SPAM:[reson]".
If the result of the test was not "OK" then the name of the plugin which caused the rejection will be saved in this key.
The remote IP address of the client which submitted the message for testing.
http://www.steve.org.uk/
Copyright (c) 2008-2010 by Steve Kemp. All rights reserved.
This module is free software; you can redistribute it and/or modify it under the same terms as Perl itself. The LICENSE file contains the full text of the license.
To install Blog::Spam::API, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Blog::Spam::API
CPAN shell
perl -MCPAN -e shell install Blog::Spam::API
For more information on module installation, please visit the detailed CPAN module installation guide.