diff options
Diffstat (limited to 'extensions/ConfirmEdit/Captcha.php')
| -rw-r--r-- | extensions/ConfirmEdit/Captcha.php | 894 |
1 files changed, 894 insertions, 0 deletions
diff --git a/extensions/ConfirmEdit/Captcha.php b/extensions/ConfirmEdit/Captcha.php new file mode 100644 index 00000000..1d781ae8 --- /dev/null +++ b/extensions/ConfirmEdit/Captcha.php @@ -0,0 +1,894 @@ +<?php + +/** + * Object encapsulating a captcha process. The captcha has two elements: it must be able + * to generate a frontend HTML representation of itself which can be presented to the user, + * which provides inputs for users to provide their interpretation of the captcha; and it + * must be able to retrieve that data from a subsequently-submitted request and validate + * whether the user got the data correct. + */ +abstract class Captcha { + + /** + * @var String + */ + protected $id; + + /** + * Information about the captcha, in array form + * @var $info Array + */ + protected $info; + + /** + * Whether this captcha exists in the storage + * @var Bool + */ + protected $exists; + + /** + * Generate a new empty Captcha. This is guaranteed to return a Captcha object if it + * does not throw an exception + * + * @return Captcha subclass + */ + public final static function factory() { + global $wgCaptchaClass; + $obj = new $wgCaptchaClass; + if ( $obj instanceof Captcha ) { + return $obj; + } else { + throw new MWException( "Invalid Captcha class $wgCaptchaClass, must extend Captcha" ); + } + } + + /** + * Instantiate a new Captcha object for a given Id + * + * @param $id Int + * @return Captcha + */ + public final static function newFromId( $id ){ + $obj = self::factory(); + $obj->setId( $id ); + return $obj->exists() + ? $obj + : null; + } + + /** + * Instantiate a brand new captcha, never seen before. + * + * @return Captcha + */ + public final static function newRandom(){ + $obj = self::factory(); + $obj->generateNew(); + return $obj; + } + + /** + * Protected constructor - use only the factory methods above to instantiate captchas, + * or you may end up with the wrong type of object + */ + protected function __construct(){} + + /** + * Get the captcha Id + * + * @return String + */ + public function getId(){ + return $this->id; + } + + /** + * Set the Id internally. Don't include wierd things like entities or characters that + * need to be HTML-escaped, you'll just be creating more work and pain for yourself... + * + * @param $id String + */ + protected function setId( $id ){ + $this->id = $id; + } + + /** + * Initialise $this->info etc with information needed to make this object a new, + * (ideally) never-seen-before captcha. Implementations should not save the data in + * the store in this function, as the captcha may not ever be used. + * + * @return Array of captcha info + */ + # FIXME: detail + protected abstract function generateNew(); + + /** + * Save a generated captcha in storage somewhere where it won't be lost between + * requests. 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. + */ + protected function store() { + // Assign random index if we're not udpating + if ( !isset( $this->info['index'] ) ) { + if( !$this->getId() ){ + $this->setId( strval( mt_rand() ) ); + } + $this->info['index'] = $this->getId(); + } + CaptchaStore::get()->store( $this->info['index'], $this->info ); + } + + /** + * Fetch the data for this captcha from the CaptchaStore. This requires $this->id + * to be set. + * + * @return Array|Bool: Array of info, or false if missing + */ + protected function retrieve() { + if( $this->getId() === null ){ + return null; + } + if( $this->info === null ){ + $this->info = CaptchaStore::get()->retrieve( $this->getId() ); + $this->exists = $this->info !== false; + } + return $this->info; + } + + /** + * Clear the information about this captcha from the CaptchaStore, so it cannot + * be reused at a later date. + */ + protected function delete() { + if( $this->getId() !== null ){ + CaptchaStore::get()->clear( $this->getId() ); + } + } + + /** + * Whether this captcha exists. $this->setId() must have been called from some context + * + * @return Bool + */ + public function exists(){ + if( $this->exists === null ){ + $this->retrieve(); + } + return $this->exists; + } + + /** + * Load some data from a WebRequest. Implementations must load all data they need + * from the request in this function, they must not use the global $wgRequest, as + * in the post-1.18 environment they may not necessarily be the same. + * + * @param $request WebRequest + * @param $field HTMLCaptchaField will be passed if the captcha is part of an HTMLForm + */ + public abstract function loadFromRequest( WebRequest $request, HTMLCaptchaField $field = null ); + + /** + * Return the data that would be needed to pass the captcha challenge through the API. + * Implementations must return an array with at least the following parameters: + * 'type' - a unique description of the type of challenge. This could be + * the class name + * 'mime' - the MIME type of the challenge + * 'id' - the captcha Id produced by getId() + * Implementations should document how the user should use the provided data to answer + * the captcha. + * + * Implementations may return False to indicate that it is not possible to represent + * the challenge via the API. API actions protected by such a captcha will be disabled. + * + * @return Array|Bool + */ + public abstract function getApiParams(); + + /** + * Return the HTML which will be placed in the 'input' table cell of an HTMLForm. + * Implementations must include input fields which will perpetuate the captcha Id and + * any special data, as well as providing a means for the user to answer the captcha. + * Implementations should not include any help or label text, as these will be set in + * the label-message and help-message attributes of the HTMLCaptchafield. + * Implementations should honour the options set in the HTMLFormField such as + * $field->mName and $field->mReadonly. + * + * @param $field HTMLCaptchaField + * @return String raw HTML + */ + public abstract function getFormHTML( HTMLCaptchaField $field ); + + /** + * Return the HTML which will be used in legacy forms which do not implement HTMLForm + * Implementations must include input fields which will perpetuate the captcha Id and + * any other necessary data, as well as providing a means for the user to answer the + * captcha, and any relevant descriptions and instructions. + * + * @return String raw HTML + */ + public abstract function getFreeflowHTML(); + + /** + * Using the parameters loaded from the web request, check the captcha, maybe delete + * it if that's desirable, do any other necessary cleanup, and return Bool + * @return Bool whether the captcha was successfully answered + */ + public abstract function checkCaptcha(); +} + +class SimpleCaptcha { + + function getCaptcha() { + $a = mt_rand( 0, 100 ); + $b = mt_rand( 0, 10 ); + + /* Minus sign is used in the question. UTF-8, + since the api uses text/plain, not text/html */ + $op = mt_rand( 0, 1 ) ? '+' : '−'; + + $test = "$a $op $b"; + $answer = ( $op == '+' ) ? ( $a + $b ) : ( $a - $b ); + return array( 'question' => $test, 'answer' => $answer ); + } + + function addCaptchaAPI( &$resultArr ) { + $captcha = $this->getCaptcha(); + $index = $this->storeCaptcha( $captcha ); + $resultArr['captcha']['type'] = 'simple'; + $resultArr['captcha']['mime'] = 'text/plain'; + $resultArr['captcha']['id'] = $index; + $resultArr['captcha']['question'] = $captcha['question']; + } + + /** + * 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! + * + * @return string HTML + */ + function getForm() { + $captcha = $this->getCaptcha(); + $index = $this->storeCaptcha( $captcha ); + + return "<p><label for=\"wpCaptchaWord\">{$captcha['question']}</label> = " . + Xml::element( 'input', array( + 'name' => 'wpCaptchaWord', + 'id' => 'wpCaptchaWord', + 'tabindex' => 1 ) ) . // tab in before the edit textarea + "</p>\n" . + Xml::element( 'input', array( + 'type' => 'hidden', + 'name' => 'wpCaptchaId', + 'id' => 'wpCaptchaId', + 'value' => $index ) ); + } + + /** + * Insert the captcha prompt into an edit form. + * @param OutputPage $out + */ + function editCallback( &$out ) { + $out->addWikiText( $this->getMessage( $this->action ) ); + $out->addHTML( $this->getForm() ); + } + + /** + * Show a message asking the user to enter a captcha on edit + * The result will be treated as wiki text + * + * @param $action Action being performed + * @return string + */ + function getMessage( $action ) { + $name = 'captcha-' . $action; + $text = wfMsg( $name ); + # Obtain a more tailored message, if possible, otherwise, fall back to + # the default for edits + return wfEmptyMsg( $name, $text ) ? wfMsg( 'captcha-edit' ) : $text; + } + + /** + * Inject whazawhoo + * @fixme if multiple thingies insert a header, could break + * @param $form HTMLForm + * @return bool true to keep running callbacks + */ + function injectEmailUser( &$form ) { + global $wgCaptchaTriggers, $wgOut, $wgUser; + if ( $wgCaptchaTriggers['sendemail'] ) { + if ( $wgUser->isAllowed( 'skipcaptcha' ) ) { + wfDebug( "ConfirmEdit: user group allows skipping captcha on email sending\n" ); + return true; + } + $form->addFooterText( + "<div class='captcha'>" . + $wgOut->parse( $this->getMessage( 'sendemail' ) ) . + $this->getForm() . + "</div>\n" ); + } + return true; + } + + /** + * Inject whazawhoo + * @fixme if multiple thingies insert a header, could break + * @param QuickTemplate $template + * @return bool true to keep running callbacks + */ + function injectUserCreate( &$template ) { + global $wgCaptchaTriggers, $wgOut, $wgUser; + if ( $wgCaptchaTriggers['createaccount'] ) { + if ( $wgUser->isAllowed( 'skipcaptcha' ) ) { + wfDebug( "ConfirmEdit: user group allows skipping captcha on account creation\n" ); + return true; + } + $template->set( 'header', + "<div class='captcha'>" . + $wgOut->parse( $this->getMessage( 'createaccount' ) ) . + $this->getForm() . + "</div>\n" ); + } + return true; + } + + /** + * Inject a captcha into the user login form after a failed + * password attempt as a speedbump for mass attacks. + * @fixme if multiple thingies insert a header, could break + * @param $template QuickTemplate + * @return bool true to keep running callbacks + */ + function injectUserLogin( &$template ) { + if ( $this->isBadLoginTriggered() ) { + global $wgOut; + $template->set( 'header', + "<div class='captcha'>" . + $wgOut->parse( $this->getMessage( 'badlogin' ) ) . + $this->getForm() . + "</div>\n" ); + } + return true; + } + + /** + * When a bad login attempt is made, increment an expiring counter + * in the memcache cloud. Later checks for this may trigger a + * captcha display to prevent too many hits from the same place. + * @param User $user + * @param string $password + * @param int $retval authentication return value + * @return bool true to keep running callbacks + */ + function triggerUserLogin( $user, $password, $retval ) { + global $wgCaptchaTriggers, $wgCaptchaBadLoginExpiration, $wgMemc; + if ( $retval == LoginForm::WRONG_PASS && $wgCaptchaTriggers['badlogin'] ) { + $key = $this->badLoginKey(); + $count = $wgMemc->get( $key ); + if ( !$count ) { + $wgMemc->add( $key, 0, $wgCaptchaBadLoginExpiration ); + } + $count = $wgMemc->incr( $key ); + } + return true; + } + + /** + * Check if a bad login has already been registered for this + * IP address. If so, require a captcha. + * @return bool + * @access private + */ + function isBadLoginTriggered() { + global $wgMemc, $wgCaptchaBadLoginAttempts; + return intval( $wgMemc->get( $this->badLoginKey() ) ) >= $wgCaptchaBadLoginAttempts; + } + + /** + * Check if the IP is allowed to skip captchas + */ + function isIPWhitelisted() { + global $wgCaptchaWhitelistIP; + if ( $wgCaptchaWhitelistIP ) { + $ip = wfGetIp(); + foreach ( $wgCaptchaWhitelistIP as $range ) { + if ( IP::isInRange( $ip, $range ) ) { + return true; + } + } + } + return false; + } + + /** + * Internal cache key for badlogin checks. + * @return string + * @access private + */ + function badLoginKey() { + return wfMemcKey( 'captcha', 'badlogin', 'ip', wfGetIP() ); + } + + /** + * Check if the submitted form matches the captcha session data provided + * by the plugin when the form was generated. + * + * Override this! + * + * @param string $answer + * @param array $info + * @return bool + */ + function keyMatch( $answer, $info ) { + return $answer == $info['answer']; + } + + // ---------------------------------- + + /** + * @param EditPage $editPage + * @param string $action (edit/create/addurl...) + * @return bool true if action triggers captcha on editPage's namespace + */ + function captchaTriggers( &$editPage, $action ) { + global $wgCaptchaTriggers, $wgCaptchaTriggersOnNamespace; + // Special config for this NS? + if ( isset( $wgCaptchaTriggersOnNamespace[$editPage->mTitle->getNamespace()][$action] ) ) + return $wgCaptchaTriggersOnNamespace[$editPage->mTitle->getNamespace()][$action]; + + return ( !empty( $wgCaptchaTriggers[$action] ) ); // Default + } + + /** + * @param EditPage $editPage + * @param string $newtext + * @param string $section + * @return bool true if the captcha should run + */ + function shouldCheck( &$editPage, $newtext, $section, $merged = false ) { + $this->trigger = ''; + $title = $editPage->mArticle->getTitle(); + + global $wgUser; + if ( $wgUser->isAllowed( 'skipcaptcha' ) ) { + wfDebug( "ConfirmEdit: user group allows skipping captcha\n" ); + return false; + } + if ( $this->isIPWhitelisted() ) + return false; + + + global $wgEmailAuthentication, $ceAllowConfirmedEmail; + if ( $wgEmailAuthentication && $ceAllowConfirmedEmail && + $wgUser->isEmailConfirmed() ) { + wfDebug( "ConfirmEdit: user has confirmed mail, skipping captcha\n" ); + return false; + } + + if ( $this->captchaTriggers( $editPage, 'edit' ) ) { + // Check on all edits + global $wgUser; + $this->trigger = sprintf( "edit trigger by '%s' at [[%s]]", + $wgUser->getName(), + $title->getPrefixedText() ); + $this->action = 'edit'; + wfDebug( "ConfirmEdit: checking all edits...\n" ); + return true; + } + + if ( $this->captchaTriggers( $editPage, 'create' ) && !$editPage->mTitle->exists() ) { + // Check if creating a page + global $wgUser; + $this->trigger = sprintf( "Create trigger by '%s' at [[%s]]", + $wgUser->getName(), + $title->getPrefixedText() ); + $this->action = 'create'; + wfDebug( "ConfirmEdit: checking on page creation...\n" ); + return true; + } + + if ( $this->captchaTriggers( $editPage, 'addurl' ) ) { + // Only check edits that add URLs + if ( $merged ) { + // Get links from the database + $oldLinks = $this->getLinksFromTracker( $title ); + // Share a parse operation with Article::doEdit() + $editInfo = $editPage->mArticle->prepareTextForEdit( $newtext ); + $newLinks = array_keys( $editInfo->output->getExternalLinks() ); + } else { + // Get link changes in the slowest way known to man + $oldtext = $this->loadText( $editPage, $section ); + $oldLinks = $this->findLinks( $editPage, $oldtext ); + $newLinks = $this->findLinks( $editPage, $newtext ); + } + + $unknownLinks = array_filter( $newLinks, array( &$this, 'filterLink' ) ); + $addedLinks = array_diff( $unknownLinks, $oldLinks ); + $numLinks = count( $addedLinks ); + + if ( $numLinks > 0 ) { + global $wgUser; + $this->trigger = sprintf( "%dx url trigger by '%s' at [[%s]]: %s", + $numLinks, + $wgUser->getName(), + $title->getPrefixedText(), + implode( ", ", $addedLinks ) ); + $this->action = 'addurl'; + return true; + } + } + + global $wgCaptchaRegexes; + if ( $wgCaptchaRegexes ) { + // Custom regex checks + $oldtext = $this->loadText( $editPage, $section ); + + foreach ( $wgCaptchaRegexes as $regex ) { + $newMatches = array(); + if ( preg_match_all( $regex, $newtext, $newMatches ) ) { + $oldMatches = array(); + preg_match_all( $regex, $oldtext, $oldMatches ); + + $addedMatches = array_diff( $newMatches[0], $oldMatches[0] ); + + $numHits = count( $addedMatches ); + if ( $numHits > 0 ) { + global $wgUser; + $this->trigger = sprintf( "%dx %s at [[%s]]: %s", + $numHits, + $regex, + $wgUser->getName(), + $title->getPrefixedText(), + implode( ", ", $addedMatches ) ); + $this->action = 'edit'; + return true; + } + } + } + } + + return false; + } + + /** + * Filter callback function for URL whitelisting + * @param string url to check + * @return bool true if unknown, false if whitelisted + * @access private + */ + function filterLink( $url ) { + global $wgCaptchaWhitelist; + $source = wfMsgForContent( 'captcha-addurl-whitelist' ); + + $whitelist = wfEmptyMsg( 'captcha-addurl-whitelist', $source ) + ? false + : $this->buildRegexes( explode( "\n", $source ) ); + + $cwl = $wgCaptchaWhitelist !== false ? preg_match( $wgCaptchaWhitelist, $url ) : false; + $wl = $whitelist !== false ? preg_match( $whitelist, $url ) : false; + + return !( $cwl || $wl ); + } + + /** + * Build regex from whitelist + * @param string lines from [[MediaWiki:Captcha-addurl-whitelist]] + * @return string Regex or bool false if whitelist is empty + * @access private + */ + function buildRegexes( $lines ) { + # Code duplicated from the SpamBlacklist extension (r19197) + + # Strip comments and whitespace, then remove blanks + $lines = array_filter( array_map( 'trim', preg_replace( '/#.*$/', '', $lines ) ) ); + + # No lines, don't make a regex which will match everything + if ( count( $lines ) == 0 ) { + wfDebug( "No lines\n" ); + return false; + } else { + # Make regex + # It's faster using the S modifier even though it will usually only be run once + // $regex = 'http://+[a-z0-9_\-.]*(' . implode( '|', $lines ) . ')'; + // return '/' . str_replace( '/', '\/', preg_replace('|\\\*/|', '/', $regex) ) . '/Si'; + $regexes = ''; + $regexStart = '/^https?:\/\/+[a-z0-9_\-.]*('; + $regexEnd = ')/Si'; + $regexMax = 4096; + $build = false; + foreach ( $lines as $line ) { + // FIXME: not very robust size check, but should work. :) + if ( $build === false ) { + $build = $line; + } elseif ( strlen( $build ) + strlen( $line ) > $regexMax ) { + $regexes .= $regexStart . + str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $build ) ) . + $regexEnd; + $build = $line; + } else { + $build .= '|' . $line; + } + } + if ( $build !== false ) { + $regexes .= $regexStart . + str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $build ) ) . + $regexEnd; + } + return $regexes; + } + } + + /** + * Load external links from the externallinks table + * @param $title Title + * @return Array + */ + function getLinksFromTracker( $title ) { + $dbr = wfGetDB( DB_SLAVE ); + $id = $title->getArticleId(); // should be zero queries + $res = $dbr->select( 'externallinks', array( 'el_to' ), + array( 'el_from' => $id ), __METHOD__ ); + $links = array(); + foreach ( $res as $row ) { + $links[] = $row->el_to; + } + return $links; + } + + /** + * Backend function for confirmEdit() and confirmEditAPI() + * @return bool false if the CAPTCHA is rejected, true otherwise + */ + private function doConfirmEdit( $editPage, $newtext, $section, $merged = false ) { + if ( $this->shouldCheck( $editPage, $newtext, $section, $merged ) ) { + if ( $this->passCaptcha() ) { + return true; + } else { + return false; + } + } else { + wfDebug( "ConfirmEdit: no need to show captcha.\n" ); + return true; + } + } + + /** + * The main callback run on edit attempts. + * @param EditPage $editPage + * @param string $newtext + * @param string $section + * @param bool $merged + * @return bool true to continue saving, false to abort and show a captcha form + */ + function confirmEdit( $editPage, $newtext, $section, $merged = false ) { + if ( defined( 'MW_API' ) ) { + # API mode + # The CAPTCHA was already checked and approved + return true; + } + if ( !$this->doConfirmEdit( $editPage, $newtext, $section, $merged ) ) { + $editPage->showEditForm( array( &$this, 'editCallback' ) ); + return false; + } + return true; + } + + /** + * A more efficient edit filter callback based on the text after section merging + * @param EditPage $editPage + * @param string $newtext + */ + function confirmEditMerged( $editPage, $newtext ) { + return $this->confirmEdit( $editPage, $newtext, false, true ); + } + + + function confirmEditAPI( $editPage, $newtext, &$resultArr ) { + if ( !$this->doConfirmEdit( $editPage, $newtext, false, false ) ) { + $this->addCaptchaAPI( $resultArr ); + return false; + } + return true; + } + + /** + * Hook for user creation form submissions. + * @param User $u + * @param string $message + * @return bool true to continue, false to abort user creation + */ + function confirmUserCreate( $u, &$message ) { + global $wgCaptchaTriggers, $wgUser; + if ( $wgCaptchaTriggers['createaccount'] ) { + if ( $wgUser->isAllowed( 'skipcaptcha' ) ) { + wfDebug( "ConfirmEdit: user group allows skipping captcha on account creation\n" ); + return true; + } + if ( $this->isIPWhitelisted() ) + return true; + + $this->trigger = "new account '" . $u->getName() . "'"; + if ( !$this->passCaptcha() ) { + $message = wfMsg( 'captcha-createaccount-fail' ); + return false; + } + } + return true; + } + + /** + * Hook for user login form submissions. + * @param User $u + * @param string $message + * @return bool true to continue, false to abort user creation + */ + function confirmUserLogin( $u, $pass, &$retval ) { + if ( $this->isBadLoginTriggered() ) { + if ( $this->isIPWhitelisted() ) + return true; + + $this->trigger = "post-badlogin login '" . $u->getName() . "'"; + if ( !$this->passCaptcha() ) { + // Emulate a bad-password return to confuse the shit out of attackers + $retval = LoginForm::WRONG_PASS; + return false; + } + } + return true; + } + + /** + * Check the captcha on Special:EmailUser + * @param $from MailAddress + * @param $to MailAddress + * @param $subject String + * @param $text String + * @param $error String reference + * @return Bool true to continue saving, false to abort and show a captcha form + */ + function confirmEmailUser( $from, $to, $subject, $text, &$error ) { + global $wgCaptchaTriggers, $wgUser; + if ( $wgCaptchaTriggers['sendemail'] ) { + if ( $wgUser->isAllowed( 'skipcaptcha' ) ) { + wfDebug( "ConfirmEdit: user group allows skipping captcha on email sending\n" ); + return true; + } + if ( $this->isIPWhitelisted() ) + return true; + + if ( defined( 'MW_API' ) ) { + # API mode + # Asking for captchas in the API is really silly + $error = wfMsg( 'captcha-disabledinapi' ); + return false; + } + $this->trigger = "{$wgUser->getName()} sending email"; + if ( !$this->passCaptcha() ) { + $error = wfMsg( 'captcha-sendemail-fail' ); + return false; + } + } + return true; + } + + /** + * Given a required captcha run, test form input for correct + * input on the open session. + * @return bool if passed, false if failed or new session + */ + function passCaptcha() { + $info = $this->retrieveCaptcha(); + if ( $info ) { + global $wgRequest; + if ( $this->keyMatch( $wgRequest->getVal( 'wpCaptchaWord' ), $info ) ) { + $this->log( "passed" ); + $this->clearCaptcha( $info ); + return true; + } else { + $this->clearCaptcha( $info ); + $this->log( "bad form input" ); + return false; + } + } else { + $this->log( "new captcha session" ); + return false; + } + } + + /** + * Log the status and any triggering info for debugging or statistics + * @param string $message + */ + function log( $message ) { + wfDebugLog( 'captcha', 'ConfirmEdit: ' . $message . '; ' . $this->trigger ); + } + + /** + * 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. + * + * @param array $info data to store + * @return string captcha ID key + */ + function storeCaptcha( $info ) { + if ( !isset( $info['index'] ) ) { + // Assign random index if we're not udpating + $info['index'] = strval( mt_rand() ); + } + CaptchaStore::get()->store( $info['index'], $info ); + return $info['index']; + } + + /** + * Fetch this session's captcha info. + * @return mixed array of info, or false if missing + */ + function retrieveCaptcha() { + global $wgRequest; + $index = $wgRequest->getVal( 'wpCaptchaId' ); + return CaptchaStore::get()->retrieve( $index ); + } + + /** + * Clear out existing captcha info from the session, to ensure + * it can't be reused. + */ + function clearCaptcha( $info ) { + CaptchaStore::get()->clear( $info['index'] ); + } + + /** + * Retrieve the current version of the page or section being edited... + * @param EditPage $editPage + * @param string $section + * @return string + * @access private + */ + function loadText( $editPage, $section ) { + $rev = Revision::newFromTitle( $editPage->mTitle ); + if ( is_null( $rev ) ) { + return ""; + } else { + $text = $rev->getText(); + if ( $section != '' ) { + global $wgParser; + return $wgParser->getSection( $text, $section ); + } else { + return $text; + } + } + } + + /** + * Extract a list of all recognized HTTP links in the text. + * @param string $text + * @return array of strings + */ + function findLinks( &$editpage, $text ) { + global $wgParser, $wgUser; + + $options = new ParserOptions(); + $text = $wgParser->preSaveTransform( $text, $editpage->mTitle, $wgUser, $options ); + $out = $wgParser->parse( $text, $editpage->mTitle, $options ); + + return array_keys( $out->getExternalLinks() ); + } + + /** + * Show a page explaining what this wacky thing is. + */ + function showHelp() { + global $wgOut; + $wgOut->setPageTitle( wfMsg( 'captchahelp-title' ) ); + $wgOut->addWikiText( wfMsg( 'captchahelp-text' ) ); + if ( CaptchaStore::get()->cookiesNeeded() ) { + $wgOut->addWikiText( wfMsg( 'captchahelp-cookies-needed' ) ); + } + } +} |