CaptchaExtendedAction extends CCaptchaAction

in package

• Application

Yii extended captcha supporting more complex formulas and masking techniques.

  1) unzip CaptchaExtended.zip files into ../protected/extensions/captchaExtended/*.*

2) Register class paths to [CaptchaExtendedAction] and [CaptchaExtendedValidator], e.g. in components/controller.php:

	public function init(){
		// import class paths for captcha extended
		Yii::$classMap = array_merge( Yii::$classMap, array(
			'CaptchaExtendedAction' => Yii::getPathOfAlias('ext.captchaExtended').DIRECTORY_SEPARATOR.'CaptchaExtendedAction.php',
			'CaptchaExtendedValidator' => Yii::getPathOfAlias('ext.captchaExtended').DIRECTORY_SEPARATOR.'CaptchaExtendedValidator.php'
		));
	}

  3) Define action in controller, e.g. SiteController:

	public function actions(){
		return array(
			'captcha'=>array(
				'class'=>'CaptchaExtendedAction',
			),
		);
	}

  4) Define client validation in model::rules():

	public function rules(){
		return array(
			array('verifyCode', 'CaptchaExtendedValidator', 'allowEmpty'=>!CCaptcha::checkRequirements()),
		);
	}

   5) If needed, collect localized strings via CLI command "yiic message messages/config.php" and translate captcha related strings.

   6) If needed, you can tune captcha modes and visibility options:
	  - In "words" mode, you can place your own file [words.txt] or [words.yourlanguage.txt]
	  - If needed, set the dots density [0-100], the number of through lines [0-] or fillSections [0-], font and background colors

   7) Test & enjoy!

Table of Contents

Constants

MODE_DEFAULT  = 'default'

MODE_LOGICAL  = 'logical'

MODE_MATH  = 'math'

MODE_MATHVERBAL  = 'mathverbal'

MODE_WORDS  = 'words'

Properties

$density  : mixed

Dots density around characters 0 - 100%

$fileWords  : mixed

Path to the file to be used for generating random words in "words" mode

$fillSections  : mixed

The number of sections to be filled with random flood color

$lines  : mixed

The number of lines drawn through the generated captcha picture

$mode  : mixed

Captcha mode, supported values are [logical, words, mathverbal, math, default].

$offset  : int

$regenerateOnValid  : mixed

If True, regenerate captcha if user enters valid code

Methods

getVerifyCode()  : string

Gets the verification code.

getVerifyResult()  : mixed

Return verification result expected by user

run()  : mixed

Run action

validate()  : whether

Validates the input to see if it matches the generated code.

generateValidationHashCI()  : mixed

Return hash for case insensitive result (converted to lowercase)

generateVerifyCode()  : string

Generates a new verification code.

getCodeLogical()  : mixed

Return code for logical formula like min(one,7,four)

getCodeMath()  : mixed

Return code for math mode like 9+1= or 95-5=

getCodeMathVerbal()  : mixed

Return code for verbal math mode like "How much is 1 plus 1 ?"

getCodeWords()  : mixed

Return code for random words from text file.

getNumber()  : mixed

Return verbal representation for supplied number, like 1 => one

getNumbers()  : mixed

Return numbers 0..9 translated into word

purifyWord()  : mixed

Return captcha word without dirty characters like *,/,{,},.. Retain diacritics if unicode supported.

renderImage()  : string

Renders the CAPTCHA image based on the code.