Authen::PluggableCaptcha::Challenge
This is the base class for generating a captcha challenge
captcha challenges must support the following methods
->new( keygenerator_instance=> $keygenerator_instance ); ->validate( user_response=> $user_response ); validate must return : 1 success 0 failure -1 error
there are 3 public methods that must be available to other modules
'instructions' what a user should do 'user_prompt' what to prompt the user with this will be rendered by the render engine for image/audio this is probably the same as correct_response 'correct_response' the repsonse
Example: Image Authen::PluggableCaptcha: instructions: type in the letters you see user_prompt: abcdef correct_response: abcdef
Text Logic Authen::PluggableCaptcha: instructions: do this math problem user_prompt: what is 12 divided by 1 ? correct_response: 12
PARAMS are required name/value pairs. Required PARAMS are:
keymanager_instance TYPE
A reference to an object derived from Authen::PluggableCaptcha::KeyManager
Note that setters and getters are seperate. Setters should only be called from derived classes. Getters can be called anywhere from perl code.
validate the challege
returns: 1 on success 0 on failure -1 on error
This method MUST be overriden in a subclass
set the keymanager instance
get the keymanager instance
set the instructions text
get the instructions text
set the user_prompt text
get the user_prompt text
set the correct_response text
get the correct_response text
2 POD Errors
The following errors were encountered while parsing the POD:
=over without closing =back
=over is the last thing in the document?!
To install Authen::PluggableCaptcha, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Authen::PluggableCaptcha
CPAN shell
perl -MCPAN -e shell install Authen::PluggableCaptcha
For more information on module installation, please visit the detailed CPAN module installation guide.