=====Text Captcha Module for Userregistration=====

{{lastedit}}

Based on comments the docs server and the [[Docs:UserRegistrationValidationFramework | URInviteCodeModule]] here is URTextCaptchaModule. If you use this module, users have to answer one question right before they can register.

====Install====

1. Save the following as **libs/UR/URTextCaptchaModule/URTextCaptchaModule.php**:

%%(php)
<?php
/**
* Require the correct answer for a randomly choosen question for successful registration.
*
* Based on ideas from http://www.punbb.fr/forums/viewtopic.php?pid=18554#p18554
*
* This UR (user registration) verification module requires the
* user to enter the correct answer to a question (password) for a successful
* registration.
*
* To implement, set the following in wikka.config.php:
* 'UR_validation_modules' => 'URTextCaptchaModule'
* 'UR_captcha_questions' => array(
* 'First question' => 'Answer',
* 'Second question' => 'Answer',
* ),
* (If combined with other modules, separate each module with a
* comma.)
*
* @version 0.2
* @see libs/userregistration.class.php
* @see URAuth, URAuthTmpl
*
* @license http://www.gnu.org/copyleft/gpl.html GNU General Public License
* @filesource
*
* @author {@link http://wikkawiki.org/BrianKoontz Brian Koontz} (Invite Code module)
* @author {@link http://wikkawiki.org/NilsLindenberg NilsLindenberg} (extended)
*
* @see libs/userregistration.class.php
* @see URAuth, URAuthTmpl
*
* @todo i18n
* @todo Add number to the md5 to get some more randomness?
*/

include_once('libs/userregistration.class.php');

class URTextCaptchaModule extends URAuthTmpl
{
/**
* Array for questions (key) and answers (value) for the captcha.
*/
var $captcha_questions;

/**
* Constructor. Load questions and answers from the config file.
*/
function URTextCaptchaModule(&$wakka)
{
$this->URAuthTmpl($wakka);
if(isset($wakka->config['UR_captcha_questions']))
{
$this->captcha_questions = $wakka->config['UR_captcha_questions'];
}
}

/**
* Display input form with question, answer and encoded question (hidden field).
*/
function URAuthTmplDisplay()
{
if(!isset($this->captcha_questions) || !is_array($this->captcha_questions))
{
echo '<em class="error">Error in URTextCaptcha module</em>';
}
else {
$questions=array_keys($this->captcha_questions);
if (FALSE === $questions)
{
echo '<em class="error">Error in URTextCaptcha module</em>';
return;
}
//choose random-question
$nr = rand(0,count($this->captcha_questions)-1);

echo '<label for="UR_captcha">'.$questions[$nr].'</label>'."\n";
echo '<input type="text" name="UR_captcha" id="UR_captcha" size="10" />'."\n";
echo '<input name="UR_cap_q" value="'.md5($questions[$nr]).'" type="hidden" />';
}
}

/**
* Verify if the encoded question exists and if the answer is correct.
*/
function URAuthTmplVerify()
{
if(!isset($this->captcha_questions))
{
return FALSE;
}
if(isset($_POST['UR_captcha']) && isset($_POST['UR_cap_q']))
{
foreach ($this->captcha_questions as $k => $v)
{
if (md5($k) == $_POST['UR_cap_q'])
{
if ($v == $_POST['UR_captcha']) return TRUE;
}
}
}
return FALSE;
}
}
?>
%%

2. Activate it:

in **wikka.config.php** add:
%%(php)
'UR_validation_modules' => 'URTextCaptchaModule',
%%

3a. Formulate some questions + answers and add them to **wikka.config.php**
%%(php)
'UR_captcha_questions' => array(
'First question' => 'Answer',
'Second question' => 'Answer',
),
%%

3b. Of course it is possible to use it with only an regiter code, too:

%%(php)
'UR_captcha_questions' => array(
'Please enter the registration code provided by your admin' => 'registercode',
),
%%

----
CategoryURModules
CategoryUserContributions