Demo CAPTCHA (not for production usage) and base class for real CAPTCHAs. More...

Inheritance diagram for SimpleCaptcha:

[legend]

Collaboration diagram for SimpleCaptcha:

[legend]

Public Member Functions
	addCaptchaAPI (&$resultArr)

	addFormInformationToOutput (OutputPage $out, array $formInformation)
	Processes the given $formInformation array and adds the options (see getFormInformation()) to the given OutputPage object.

	addFormToOutput (OutputPage $out, $tabIndex=1)
	Uses getFormInformation() to get the CAPTCHA form and adds it to the given OutputPage object.

	APIGetAllowedParams (&$module, &$params, $flags)

	buildRegexes ( $lines)
	Build regex from whitelist.

	captchaTriggers ( $title, $action)

	clearCaptcha ( $index)
	Clear out existing captcha info from the session, to ensure it can't be reused.

	confirmEditMerged ( $context, $content, $status, $summary, $user, $minorEdit)
	An efficient edit filter callback based on the text after section merging.

	confirmEmailUser ( $from, $to, $subject, $text, &$error)
	Check the captcha on Special:EmailUser.

	createAuthenticationRequest ()

	describeCaptchaType ()
	Describes the captcha type for API clients.

	editShowCaptcha ( $editPage)
	Insert the captcha prompt into an edit form.

	filterLink ( $url)
	Filter callback function for URL whitelisting.

	findLinks ( $title, $text)
	Extract a list of all recognized HTTP links in the text.

	getCaptcha ()
	Returns an array with 'question' and 'answer' keys.

	getCaptchaInfo ( $captchaData, $id)

	getError ()
	Return the error from the last passCaptcha* call.

	getFormInformation ( $tabIndex=1)
	Insert a captcha prompt into the edit form.

	getLinksFromTracker ( $title)
	Load external links from the externallinks table.

	getMessage ( $action)
	Show a message asking the user to enter a captcha on edit The result will be treated as wiki text.

	increaseBadLoginCounter ( $username)
	Increase bad login counter after a failed login.

	injectEmailUser (&$form)
	Inject whazawhoo @fixme if multiple thingies insert a header, could break.

	isBadLoginPerUserTriggered ( $u)
	Is the per-user captcha triggered?

	isBadLoginTriggered ()
	Check if a bad login has already been registered for this IP address.

	isIPWhitelisted ()
	Check if the current IP is allowed to skip captchas.

	keyMatch ( $answer, $info)
	Check if the submitted form matches the captcha session data provided by the plugin when the form was generated.

	loadText ( $title, $section, $flags=Revision::READ_LATEST)
	Retrieve the current version of the page or section being edited...

	log ( $message)
	Log the status and any triggering info for debugging or statistics.

	needCreateAccountCaptcha (User $creatingUser=null)
	Logic to check if we need to pass a captcha for the current user to create a new account, or not.

	onAuthChangeFormFields (array $requests, array $fieldInfo, array &$formDescriptor, $action)
	Modify the apprearance of the captcha field.

	passCaptchaFromRequest (WebRequest $request, User $user)
	Given a required captcha run, test form input for correct input on the open session.

	passCaptchaLimited ( $index, $word, User $user)
	Checks, if the user reached the amount of false CAPTCHAs and give him some vacation or run self::passCaptcha() and clear counter if correct.

	passCaptchaLimitedFromRequest (WebRequest $request, User $user)
	Checks, if the user reached the amount of false CAPTCHAs and give him some vacation or run self::passCaptcha() and clear counter if correct.

	resetBadLoginCounter ( $username)
	Reset bad login counter after a successful login.

	retrieveCaptcha ( $index)
	Fetch this session's captcha info.

	setAction ( $action)

	setTrigger ( $trigger)

	shouldCheck (WikiPage $page, $content, $section, $context, $oldtext=null)

	showEditFormFields (&$editPage, &$out)
	Show error message for missing or incorrect captcha on EditPage.

	showHelp ()
	Show a page explaining what this wacky thing is.

	storeCaptcha ( $info)
	Generate a captcha session ID and save the info in PHP's session storage.

	triggersCaptcha ( $action, $title=null)
	Checks, whether the passed action should trigger a CAPTCHA.

Protected Member Functions
	getCaptchaParamsFromRequest (WebRequest $request)

	isAPICaptchaModule ( $module)

	passCaptcha ( $index, $word)
	Given a required captcha run, test form input for correct input on the open session.

Protected Attributes
string	$action
	Used to select the right message.

string	$trigger
	Used in log messages.

Static Protected Attributes
static	$messagePrefix = 'captcha-'

Private Member Functions
	badLoginKey ()
	Internal cache key for badlogin checks.

	badLoginPerUserKey ( $username)
	Cache key for badloginPerUser checks.

	buildValidIPs (array $input)
	From a list of unvalidated input, get all the valid IP addresses and IP ranges from it.

	doConfirmEdit (WikiPage $page, $newtext, $section, IContextSource $context)
	Backend function for confirmEditMerged()

	getWikiIPWhitelist (Message $msg)
	Get the on-wiki IP whitelist stored in [[MediaWiki:Captcha-ip-whitelist]] page from cache if possible.

Private Attributes
boolean null	$captchaSolved = null
	Was the CAPTCHA already passed and if yes, with which result?

Detailed Description

Demo CAPTCHA (not for production usage) and base class for real CAPTCHAs.

Definition at line 8 of file Captcha.php.

Member Function Documentation

◆ addCaptchaAPI()

SimpleCaptcha::addCaptchaAPI ( & $resultArr )

Parameters

array &$resultArr

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 71 of file Captcha.php.

References describeCaptchaType(), getCaptcha(), and storeCaptcha().

Referenced by confirmEditMerged().

◆ addFormInformationToOutput()

SimpleCaptcha::addFormInformationToOutput	(	OutputPage	$out,
		array	$formInformation )

Processes the given $formInformation array and adds the options (see getFormInformation()) to the given OutputPage object.

Parameters

OutputPage	$out	The OutputPage object to which the form should be added
array	$formInformation

Definition at line 160 of file Captcha.php.

References $out.

Referenced by addFormToOutput(), and injectEmailUser().

◆ addFormToOutput()

SimpleCaptcha::addFormToOutput	(	OutputPage	$out,
			$tabIndex = 1 )

Uses getFormInformation() to get the CAPTCHA form and adds it to the given OutputPage object.

Parameters

OutputPage	$out	The OutputPage object to which the form should be added
int	$tabIndex	See self::getFormInformation

Definition at line 149 of file Captcha.php.

References addFormInformationToOutput(), and getFormInformation().

Referenced by editShowCaptcha(), and showEditFormFields().

◆ APIGetAllowedParams()

SimpleCaptcha::APIGetAllowedParams	(	&	$module,
		&	$params,
			$flags )

Parameters

ApiBase	&$module
array	&$params
int	$flags

Returns: bool

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 931 of file Captcha.php.

References $params, isAPICaptchaModule(), and ApiBase\PARAM_HELP_MSG.

◆ badLoginKey()

SimpleCaptcha::badLoginKey ( )

private

Internal cache key for badlogin checks.

Returns: string

Definition at line 431 of file Captcha.php.

References $wgRequest, and wfGlobalCacheKey().

Referenced by increaseBadLoginCounter().

◆ badLoginPerUserKey()

SimpleCaptcha::badLoginPerUserKey ( $username )

private

Cache key for badloginPerUser checks.

Parameters

string $username

Returns: string

Definition at line 442 of file Captcha.php.

References $username, User\getCanonicalName(), and wfGlobalCacheKey().

Referenced by increaseBadLoginCounter(), and resetBadLoginCounter().

◆ buildRegexes()

SimpleCaptcha::buildRegexes ( $lines )

Build regex from whitelist.

Parameters

string $lines string from [[MediaWiki:Captcha-addurl-whitelist]]

Returns: array Regexes

Access:\n private

Definition at line 690 of file Captcha.php.

References $line, $lines, $matches, $opt, $options, $value, and wfDebug().

Referenced by filterLink().

◆ buildValidIPs()

SimpleCaptcha::buildValidIPs ( array $input )

private

From a list of unvalidated input, get all the valid IP addresses and IP ranges from it.

Note that only lines with just the IP address or IP range is considered as valid. Whitespace is allowed but if there is any other character on the line, it's not considered as a valid entry.

Parameters

string[] $input

Returns: string[] of valid IP addresses and IP ranges

Definition at line 412 of file Captcha.php.

References $input.

Referenced by getWikiIPWhitelist().

◆ captchaTriggers()

SimpleCaptcha::captchaTriggers	(		$title,
			$action )

Parameters

Title	$title
string	$action	(edit/create/addurl...)

Returns: bool true if action triggers captcha on $title's namespace

Deprecated: since 1.5.1 Use triggersCaptcha instead

Definition at line 469 of file Captcha.php.

References triggersCaptcha().

◆ clearCaptcha()

SimpleCaptcha::clearCaptcha ( $index )

Clear out existing captcha info from the session, to ensure it can't be reused.

Parameters

string $index

Definition at line 1081 of file Captcha.php.

References CaptchaStore\get().

Referenced by passCaptcha().

◆ confirmEditMerged()

SimpleCaptcha::confirmEditMerged	(	$context,
		$content,
		$status,
		$summary,
		$user,
		$minorEdit )

An efficient edit filter callback based on the text after section merging.

Parameters

RequestContext	$context
Content	$content
Status	$status
string	$summary
User	$user
bool	$minorEdit

Returns: bool

Definition at line 815 of file Captcha.php.

References $context, addCaptchaAPI(), EditPage\AS_HOOK_ERROR_EXPECTED, doConfirmEdit(), and wfDebug().

◆ confirmEmailUser()

SimpleCaptcha::confirmEmailUser	(		$from,
			$to,
			$subject,
			$text,
		&	$error )

Check the captcha on Special:EmailUser.

Parameters

MailAddress	$from
MailAddress	$to
string	$subject
string	$text
string	&$error

Returns: bool true to continue saving, false to abort and show a captcha form

Definition at line 890 of file Captcha.php.

References $wgRequest, $wgUser, isIPWhitelisted(), passCaptchaLimitedFromRequest(), CaptchaTriggers\SENDEMAIL, triggersCaptcha(), and wfDebug().

◆ createAuthenticationRequest()

SimpleCaptcha::createAuthenticationRequest ( )

Returns: CaptchaAuthenticationRequest

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 1141 of file Captcha.php.

References getCaptcha(), and storeCaptcha().

◆ describeCaptchaType()

SimpleCaptcha::describeCaptchaType ( )

Describes the captcha type for API clients.

Returns: array An array with keys 'type' and 'mime', and possibly other implementation-specific

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 84 of file Captcha.php.

Referenced by addCaptchaAPI().

◆ doConfirmEdit()

SimpleCaptcha::doConfirmEdit	(	WikiPage	$page,
			$newtext,
			$section,
		IContextSource	$context )

private

Backend function for confirmEditMerged()

Parameters

WikiPage	$page
string	$newtext
string	$section
IContextSource	$context

Returns: bool false if the CAPTCHA is rejected, true otherwise

Definition at line 783 of file Captcha.php.

References $context, $request, $section, $wgRequest, $wgUser, passCaptchaLimitedFromRequest(), shouldCheck(), and wfDebug().

Referenced by confirmEditMerged().

◆ editShowCaptcha()

SimpleCaptcha::editShowCaptcha ( $editPage )

Insert the captcha prompt into an edit form.

Parameters

EditPage $editPage

Definition at line 209 of file Captcha.php.

References $context, $out, addFormToOutput(), getMessage(), and text.

◆ filterLink()

SimpleCaptcha::filterLink ( $url )

Filter callback function for URL whitelisting.

Parameters

string $url string to check

Returns: bool true if unknown, false if whitelisted

Access:\n private

Definition at line 659 of file Captcha.php.

References $source, buildRegexes(), and wfMessage().

◆ findLinks()

SimpleCaptcha::findLinks	(		$title,
			$text )

Extract a list of all recognized HTTP links in the text.

Parameters

Title	$title
string	$text

Returns: array of strings

Definition at line 1116 of file Captcha.php.

References $options, $out, $wgParser, and $wgUser.

Referenced by shouldCheck().

◆ getCaptcha()

SimpleCaptcha::getCaptcha ( )

Returns an array with 'question' and 'answer' keys.

Subclasses might use different structure. Since MW 1.27 all subclasses must implement this method.

Returns: array

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 53 of file Captcha.php.

Referenced by addCaptchaAPI(), createAuthenticationRequest(), and getFormInformation().

◆ getCaptchaInfo()

SimpleCaptcha::getCaptchaInfo	(		$captchaData,
			$id )

Parameters

array	$captchaData	Data given by getCaptcha
string	$id	ID given by storeCaptcha

Returns: string Description of the captcha. Format is not specified; could be text, HTML, URL...

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 183 of file Captcha.php.

◆ getCaptchaParamsFromRequest()

SimpleCaptcha::getCaptchaParamsFromRequest ( WebRequest $request )

protected

Parameters

WebRequest $request

Returns: array [ captcha ID, captcha solution ]

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 961 of file Captcha.php.

References $request.

Referenced by passCaptchaFromRequest(), and passCaptchaLimitedFromRequest().

◆ getError()

SimpleCaptcha::getError ( )

Return the error from the last passCaptcha* call.

Not implemented but needed by some child classes.

Returns: mixed

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 43 of file Captcha.php.

◆ getFormInformation()

SimpleCaptcha::getFormInformation ( $tabIndex = 1 )

Insert a captcha prompt into the edit form.

This sample implementation generates a simple arithmetic operation; it would be easy to defeat by machine.

Override this!

It is not guaranteed that the CAPTCHA will load synchronously with the main page content. So you can not rely on registering handlers before page load. E.g.:

NOT SAFE: $( window ).on( 'load', handler ) SAFE: $( handler )

However, if the HTML is loaded dynamically via AJAX, the following order will be used.

headitems => modulestyles + modules => add main HTML to DOM when modulestyles + modules are ready.

Parameters

int $tabIndex Tab index to start from

Returns: array Associative array with the following keys: string html - Main HTML array modules (optional) - Array of ResourceLoader module names array modulestyles (optional) - Array of ResourceLoader module names to be included as style-only modules. array headitems (optional) - Head items (see OutputPage::addHeadItems), as a numeric array of raw HTML strings. Do not use unless no other option is feasible.

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 120 of file Captcha.php.

References getCaptcha(), and storeCaptcha().

Referenced by addFormToOutput(), and injectEmailUser().

◆ getLinksFromTracker()

SimpleCaptcha::getLinksFromTracker ( $title )

Load external links from the externallinks table.

Parameters

Title $title

Returns: array

Definition at line 763 of file Captcha.php.

References $dbr, $res, DB_REPLICA, and wfGetDB().

Referenced by shouldCheck().

◆ getMessage()

SimpleCaptcha::getMessage ( $action )

Show a message asking the user to enter a captcha on edit The result will be treated as wiki text.

Parameters

string $action Action being performed

Returns: Message

Reimplemented in ReCaptchaNoCaptcha.

Definition at line 229 of file Captcha.php.

References $action, and wfMessage().

Referenced by editShowCaptcha(), FancyCaptcha\onAuthChangeFormFields(), and showEditFormFields().

◆ getWikiIPWhitelist()

SimpleCaptcha::getWikiIPWhitelist ( Message $msg )

private

Get the on-wiki IP whitelist stored in [[MediaWiki:Captcha-ip-whitelist]] page from cache if possible.

Parameters

Message $msg whitelist Message on wiki

Returns: array whitelisted IP addresses or IP ranges, empty array if no whitelist

Definition at line 378 of file Captcha.php.

References $cache, and buildValidIPs().

Referenced by isIPWhitelisted().

◆ increaseBadLoginCounter()

SimpleCaptcha::increaseBadLoginCounter ( $username )

Increase bad login counter after a failed login.

The user might be required to solve a captcha if the count is high.

Parameters

string $username TODO use Throttler

Definition at line 273 of file Captcha.php.

References $cache, $username, CaptchaTriggers\BAD_LOGIN, CaptchaTriggers\BAD_LOGIN_PER_USER, badLoginKey(), badLoginPerUserKey(), and triggersCaptcha().

◆ injectEmailUser()

SimpleCaptcha::injectEmailUser ( & $form )

Inject whazawhoo @fixme if multiple thingies insert a header, could break.

Parameters

HTMLForm &$form

Returns: bool true to keep running callbacks

Definition at line 245 of file Captcha.php.

References $out, addFormInformationToOutput(), getFormInformation(), CaptchaTriggers\SENDEMAIL, triggersCaptcha(), and wfDebug().

◆ isAPICaptchaModule()

SimpleCaptcha::isAPICaptchaModule ( $module )

protected

Parameters

ApiBase $module

Returns: bool

Definition at line 921 of file Captcha.php.

Referenced by ReCaptcha\APIGetAllowedParams(), ReCaptchaNoCaptcha\APIGetAllowedParams(), and APIGetAllowedParams().

◆ isBadLoginPerUserTriggered()

SimpleCaptcha::isBadLoginPerUserTriggered ( $u )

Is the per-user captcha triggered?

Parameters

User | string $u User object, or name

Returns: bool|null False: no, null: no, but it will be triggered next time

Definition at line 330 of file Captcha.php.

References $cache, CaptchaTriggers\BAD_LOGIN_PER_USER, and triggersCaptcha().

◆ isBadLoginTriggered()

SimpleCaptcha::isBadLoginTriggered ( )

Check if a bad login has already been registered for this IP address.

If so, require a captcha.

Returns: bool

Access:\n private

Definition at line 316 of file Captcha.php.

References $cache, CaptchaTriggers\BAD_LOGIN, and triggersCaptcha().

◆ isIPWhitelisted()

SimpleCaptcha::isIPWhitelisted ( )

Check if the current IP is allowed to skip captchas.

This checks the whitelist from two sources. 1) From the server-side config array $wgCaptchaWhitelistIP 2) From the local [[MediaWiki:Captcha-ip-whitelist]] message

Returns: bool true if whitelisted, false if not

Definition at line 350 of file Captcha.php.

References $wgRequest, getWikiIPWhitelist(), and wfMessage().

Referenced by confirmEmailUser(), needCreateAccountCaptcha(), and shouldCheck().

◆ keyMatch()

SimpleCaptcha::keyMatch	(		$answer,
			$info )

Check if the submitted form matches the captcha session data provided by the plugin when the form was generated.

Override this!

Parameters

string	$answer
array	$info

Returns: bool

Reimplemented in FancyCaptcha, MathCaptcha, and QuestyCaptcha.

Definition at line 457 of file Captcha.php.

Referenced by passCaptcha().

◆ loadText()

SimpleCaptcha::loadText	(	$title,
		$section,
		$flags = Revision::READ_LATEST )

Retrieve the current version of the page or section being edited...

Parameters

Title	$title
string	$section
int	$flags	Flags for Revision loading methods

Returns: string

Access:\n private

Definition at line 1093 of file Captcha.php.

References $rev, $section, and $wgParser.

Referenced by shouldCheck().

◆ log()

SimpleCaptcha::log ( $message )

Log the status and any triggering info for debugging or statistics.

Parameters

string $message

Definition at line 1043 of file Captcha.php.

References wfDebugLog().

Referenced by passCaptcha(), and passCaptchaLimited().

◆ needCreateAccountCaptcha()

SimpleCaptcha::needCreateAccountCaptcha ( User $creatingUser = null )

Logic to check if we need to pass a captcha for the current user to create a new account, or not.

Parameters

User | null $creatingUser

Returns: bool true to show captcha, false to skip captcha

Definition at line 864 of file Captcha.php.

References $wgUser, CaptchaTriggers\CREATE_ACCOUNT, isIPWhitelisted(), triggersCaptcha(), and wfDebug().

◆ onAuthChangeFormFields()

SimpleCaptcha::onAuthChangeFormFields	(	array	$requests,
		array	$fieldInfo,
		array &	$formDescriptor,
			$action )

Modify the apprearance of the captcha field.

Parameters

AuthenticationRequest[]	$requests
array	$fieldInfo	Field description as given by AuthenticationRequest::mergeFieldInfo
array	&$formDescriptor	A form descriptor suitable for the HTMLForm constructor
string	$action	One of the AuthManager::ACTION_* constants

Reimplemented in FancyCaptcha, MathCaptcha, QuestyCaptcha, ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 1154 of file Captcha.php.

References $req, and $requests.

◆ passCaptcha()

SimpleCaptcha::passCaptcha	(		$index,
			$word )

protected

Given a required captcha run, test form input for correct input on the open session.

Parameters

string	$index	Captcha idenitifier
string	$word	Captcha solution

Returns: bool if passed, false if failed or new session

Reimplemented in ReCaptchaNoCaptcha, ReCaptcha, and FancyCaptcha.

Definition at line 1013 of file Captcha.php.

References $captchaSolved, clearCaptcha(), keyMatch(), log(), and retrieveCaptcha().

Referenced by passCaptchaFromRequest(), and passCaptchaLimited().

◆ passCaptchaFromRequest()

SimpleCaptcha::passCaptchaFromRequest	(	WebRequest	$request,
		User	$user )

Given a required captcha run, test form input for correct input on the open session.

Parameters

WebRequest	$request
User	$user

Returns: bool if passed, false if failed or new session

Definition at line 1001 of file Captcha.php.

References getCaptchaParamsFromRequest(), list, and passCaptcha().

◆ passCaptchaLimited()

SimpleCaptcha::passCaptchaLimited	(		$index,
			$word,
		User	$user )

Checks, if the user reached the amount of false CAPTCHAs and give him some vacation or run self::passCaptcha() and clear counter if correct.

Parameters

string	$index	Captcha idenitifier
string	$word	Captcha solution
User	$user	User for throttling captcha solving attempts

Returns: bool

See also: self::passCaptcha()

Definition at line 977 of file Captcha.php.

References log(), and passCaptcha().

Referenced by passCaptchaLimitedFromRequest().

◆ passCaptchaLimitedFromRequest()

SimpleCaptcha::passCaptchaLimitedFromRequest	(	WebRequest	$request,
		User	$user )

Checks, if the user reached the amount of false CAPTCHAs and give him some vacation or run self::passCaptcha() and clear counter if correct.

Parameters

WebRequest	$request
User	$user

Returns: bool

Definition at line 952 of file Captcha.php.

References getCaptchaParamsFromRequest(), list, and passCaptchaLimited().

Referenced by confirmEmailUser(), and doConfirmEdit().

◆ resetBadLoginCounter()

SimpleCaptcha::resetBadLoginCounter ( $username )

Reset bad login counter after a successful login.

Parameters

string $username

Definition at line 303 of file Captcha.php.

References $cache, $username, CaptchaTriggers\BAD_LOGIN_PER_USER, badLoginPerUserKey(), and triggersCaptcha().

◆ retrieveCaptcha()

SimpleCaptcha::retrieveCaptcha ( $index )

Fetch this session's captcha info.

Parameters

string $index

Returns: array|false array of info, or false if missing

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 1072 of file Captcha.php.

References CaptchaStore\get().

Referenced by FancyCaptcha\passCaptcha(), passCaptcha(), and FancyCaptcha\showImage().

◆ setAction()

SimpleCaptcha::setAction ( $action )

Parameters

string $action

Definition at line 27 of file Captcha.php.

References $action.

◆ setTrigger()

SimpleCaptcha::setTrigger ( $trigger )

Parameters

string $trigger

Definition at line 34 of file Captcha.php.

References $trigger.

◆ shouldCheck()

SimpleCaptcha::shouldCheck	(	WikiPage	$page,
			$content,
			$section,
			$context,
			$oldtext = null )

Parameters

WikiPage	$page
Content \| string	$content
string	$section
IContextSource	$context
string \| null	$oldtext	The content of the revision prior to $content When null this will be loaded from the database.

Returns: bool true if the captcha should run

Definition at line 517 of file Captcha.php.

References $context, $request, $section, CONTENT_MODEL_WIKITEXT, findLinks(), getLinksFromTracker(), RequestContext\getMain(), WikiPage\getTitle(), isIPWhitelisted(), loadText(), WikiPage\prepareContentForEdit(), triggersCaptcha(), and wfDebug().

Referenced by doConfirmEdit().

◆ showEditFormFields()

SimpleCaptcha::showEditFormFields	(	&	$editPage,
		&	$out )

Show error message for missing or incorrect captcha on EditPage.

Parameters

EditPage	&$editPage
OutputPage	&$out

Definition at line 192 of file Captcha.php.

References $out, addFormToOutput(), getMessage(), and text.

◆ showHelp()

SimpleCaptcha::showHelp ( )

Show a page explaining what this wacky thing is.

Reimplemented in QuestyCaptcha.

Definition at line 1129 of file Captcha.php.

References $wgOut, CaptchaStore\get(), text, and wfMessage().

◆ storeCaptcha()

SimpleCaptcha::storeCaptcha ( $info )

Generate a captcha session ID and save the info in PHP's session storage.

(Requires the user to have cookies enabled to get through the captcha.)

A random ID is used so legit users can make edits in multiple tabs or windows without being unnecessarily hobbled by a serial order requirement. Pass the returned id value into the edit form as wpCaptchaId.

Parameters

array $info data to store

Returns: string captcha ID key

Reimplemented in ReCaptcha, and ReCaptchaNoCaptcha.

Definition at line 1058 of file Captcha.php.

References CaptchaStore\get().

Referenced by FancyCaptcha\addCaptchaAPI(), MathCaptcha\addCaptchaAPI(), QuestyCaptcha\addCaptchaAPI(), addCaptchaAPI(), createAuthenticationRequest(), FancyCaptcha\getFormInformation(), MathCaptcha\getFormInformation(), QuestyCaptcha\getFormInformation(), getFormInformation(), and FancyCaptcha\showImage().

◆ triggersCaptcha()

SimpleCaptcha::triggersCaptcha	(		$action,
			$title = null )

Checks, whether the passed action should trigger a CAPTCHA.

The optional $title parameter will be used to check namespace specific CAPTCHA triggers.

Parameters

string	$action	The CAPTCHA trigger to check (see CaptchaTriggers for ConfirmEdit built-in triggers)
Title \| null	$title	An optional Title object, if the namespace specific triggers should be checked, too.

Returns: bool True, if the action should trigger a CAPTCHA, false otherwise

Definition at line 483 of file Captcha.php.

References $action, $result, CaptchaTriggers\EXT_REG_ATTRIBUTE_NAME, and ExtensionRegistry\getInstance().

Referenced by captchaTriggers(), confirmEmailUser(), increaseBadLoginCounter(), injectEmailUser(), isBadLoginPerUserTriggered(), isBadLoginTriggered(), needCreateAccountCaptcha(), resetBadLoginCounter(), and shouldCheck().

Member Data Documentation

◆ $action

string SimpleCaptcha::$action

protected

Used to select the right message.

One of sendmail, createaccount, badlogin, edit, create, addurl.

Definition at line 19 of file Captcha.php.

Referenced by ReCaptchaNoCaptcha\getMessage(), getMessage(), FancyCaptcha\onAuthChangeFormFields(), setAction(), and triggersCaptcha().

◆ $captchaSolved

boolean null SimpleCaptcha::$captchaSolved = null

private

Was the CAPTCHA already passed and if yes, with which result?

Definition at line 12 of file Captcha.php.

Referenced by passCaptcha().

◆ $messagePrefix

SimpleCaptcha::$messagePrefix = 'captcha-'

staticprotected

Definition at line 9 of file Captcha.php.

◆ $trigger

string SimpleCaptcha::$trigger

protected

Used in log messages.

Definition at line 22 of file Captcha.php.

Referenced by setTrigger().

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

extensions/ConfirmEdit/SimpleCaptcha/Captcha.php

Public Member Functions

Protected Member Functions

Protected Attributes

Static Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Member Function Documentation

◆ addCaptchaAPI()

◆ addFormInformationToOutput()

◆ addFormToOutput()

◆ APIGetAllowedParams()

◆ badLoginKey()

◆ badLoginPerUserKey()

◆ buildRegexes()

◆ buildValidIPs()

◆ captchaTriggers()

◆ clearCaptcha()

◆ confirmEditMerged()

◆ confirmEmailUser()

◆ createAuthenticationRequest()

◆ describeCaptchaType()

◆ doConfirmEdit()

◆ editShowCaptcha()

◆ filterLink()

◆ findLinks()

◆ getCaptcha()

◆ getCaptchaInfo()

◆ getCaptchaParamsFromRequest()

◆ getError()

◆ getFormInformation()

◆ getLinksFromTracker()

◆ getMessage()

◆ getWikiIPWhitelist()

◆ increaseBadLoginCounter()

◆ injectEmailUser()

◆ isAPICaptchaModule()

◆ isBadLoginPerUserTriggered()

◆ isBadLoginTriggered()

◆ isIPWhitelisted()

◆ keyMatch()

◆ loadText()

◆ log()

◆ needCreateAccountCaptcha()

◆ onAuthChangeFormFields()

◆ passCaptcha()

◆ passCaptchaFromRequest()

◆ passCaptchaLimited()

◆ passCaptchaLimitedFromRequest()

◆ resetBadLoginCounter()

◆ retrieveCaptcha()

◆ setAction()

◆ setTrigger()

◆ shouldCheck()

◆ showEditFormFields()

◆ showHelp()

◆ storeCaptcha()

◆ triggersCaptcha()

Member Data Documentation

◆ $action

◆ $captchaSolved

◆ $messagePrefix

◆ $trigger