ChWsbCaptcha Class Reference

Inheritance diagram for ChWsbCaptcha:

Public Member Functions
	__construct ($aObject)
	display ($bDynamicMode=false)
	check ()
	getUserResponse ()
	isAvailable ()

Static Public Member Functions
static	getObjectInstance ($sObject=false)

Protected Attributes
	$_sObject
	$_aObject

Detailed Description

CAPTCHA objects.

Default captcha is stored in 'sys_captcha_default' setting option.

Creating the Captcha object:

Add record to 'sys_objects_captcha' table:

• object: name of the captcha object, in the format: vendor prefix, underscore, module prefix, underscore, internal identifier or nothing; for example: ch_blogs - custom captcha in blogs module.
• title: captcha title.
• override_class_name: user defined class name which is derived from one of base captcha classes.
• override_class_file: the location of the user defined class, leave it empty if class is located in system folders.

Example of usage

Display captcha:

ch_import('ChWsbCaptcha'); // import captcha class
$oCaptcha = ChWsbCaptcha::getObjectInstance(); // get default captcha object instance
if ($oCaptcha) // check if captcha is available for using
    echo $oCaptcha->display (); // output HTML which will automatically show captcha

Check captcha:

ch_import('ChWsbCaptcha'); // import captcha class
$oCaptcha = ChWsbCaptcha::getObjectInstance(); // get default captcha object instance
if ($oCaptcha && $oCaptcha->check ()) // check if captcha is correct
    echo 'captcha is OK';
else
    echo 'captcha is incorrect'; //

Definition at line 54 of file ChWsbCaptcha.php.

Constructor & Destructor Documentation

__construct()

ChWsbCaptcha::__construct

(

$aObject

)

Constructor

Parameters

$aObject

array of captcha options

Definition at line 63 of file ChWsbCaptcha.php.

Member Function Documentation

check()

ChWsbCaptcha::check

(

)

Check captcha.

Reimplemented in ChBaseCaptchaReCAPTCHA.

Definition at line 114 of file ChWsbCaptcha.php.

display()

ChWsbCaptcha::display

(

$bDynamicMode = false

)

Display captcha.

Parameters

$bDynamicMode

- is AJAX mode or not, if true then HTML code with captcha is loaded dynamically.

Reimplemented in ChBaseCaptchaReCAPTCHA.

Definition at line 106 of file ChWsbCaptcha.php.

getObjectInstance()

static ChWsbCaptcha::getObjectInstance (   $sObject = false )

static

Get captcha object instance by object name

Parameters

$sObject

object name

Returns

object instance or false on error

Definition at line 74 of file ChWsbCaptcha.php.

getUserResponse()

ChWsbCaptcha::getUserResponse

(

)

Return text entered by user

Reimplemented in ChBaseCaptchaReCAPTCHA.

Definition at line 122 of file ChWsbCaptcha.php.

isAvailable()

ChWsbCaptcha::isAvailable

(

)

Check if captcha is available, like all API keys are specified.

Reimplemented in ChBaseCaptchaReCAPTCHA.

Definition at line 130 of file ChWsbCaptcha.php.

Member Data Documentation

$_aObject

ChWsbCaptcha::$_aObject

protected

Definition at line 57 of file ChWsbCaptcha.php.

$_sObject

ChWsbCaptcha::$_sObject

protected

Definition at line 56 of file ChWsbCaptcha.php.

---

The documentation for this class was generated from the following file:

• inc/classes/ChWsbCaptcha.php