Maintenance for ConfirmEdit extension.
[toast/cookiecaptcha.git] / Captcha.php
1 <?php
2
3 class SimpleCaptcha {
4
5         function getCaptcha() {
6                 $a = mt_rand( 0, 100 );
7                 $b = mt_rand( 0, 10 );
8
9                 /* Minus sign is used in the question. UTF-8,
10                    since the api uses text/plain, not text/html */
11                 $op = mt_rand( 0, 1 ) ? '+' : '−';
12
13                 // No space before and after $op, to ensure correct
14                 // directionality.
15                 $test = "$a$op$b";
16                 $answer = ( $op == '+' ) ? ( $a + $b ) : ( $a - $b );
17                 return array( 'question' => $test, 'answer' => $answer );
18         }
19
20         function addCaptchaAPI( &$resultArr ) {
21                 $captcha = $this->getCaptcha();
22                 $index = $this->storeCaptcha( $captcha );
23                 $resultArr['captcha']['type'] = 'simple';
24                 $resultArr['captcha']['mime'] = 'text/plain';
25                 $resultArr['captcha']['id'] = $index;
26                 $resultArr['captcha']['question'] = $captcha['question'];
27         }
28
29         /**
30          * Insert a captcha prompt into the edit form.
31          * This sample implementation generates a simple arithmetic operation;
32          * it would be easy to defeat by machine.
33          *
34          * Override this!
35          *
36          * @return string HTML
37          */
38         function getForm() {
39                 $captcha = $this->getCaptcha();
40                 $index = $this->storeCaptcha( $captcha );
41
42                 return "<p><label for=\"wpCaptchaWord\">{$captcha['question']}</label> = " .
43                         Xml::element( 'input', array(
44                                 'name' => 'wpCaptchaWord',
45                                 'id'   => 'wpCaptchaWord',
46                                 'tabindex' => 1 ) ) . // tab in before the edit textarea
47                         "</p>\n" .
48                         Xml::element( 'input', array(
49                                 'type'  => 'hidden',
50                                 'name'  => 'wpCaptchaId',
51                                 'id'    => 'wpCaptchaId',
52                                 'value' => $index ) );
53         }
54
55         /**
56          * Insert the captcha prompt into an edit form.
57          * @param OutputPage $out
58          */
59         function editCallback( &$out ) {
60                 $out->addWikiText( $this->getMessage( $this->action ) );
61                 $out->addHTML( $this->getForm() );
62         }
63
64         /**
65          * Show a message asking the user to enter a captcha on edit
66          * The result will be treated as wiki text
67          *
68          * @param $action Action being performed
69          * @return string
70          */
71         function getMessage( $action ) {
72                 $name = 'captcha-' . $action;
73                 $text = wfMessage( $name )->text();
74                 # Obtain a more tailored message, if possible, otherwise, fall back to
75                 # the default for edits
76                 return wfMessage( $name, $text )->isDisabled() ? wfMessage( 'captcha-edit' )->text() : $text;
77         }
78
79         /**
80          * Inject whazawhoo
81          * @fixme if multiple thingies insert a header, could break
82          * @param $form HTMLForm
83          * @return bool true to keep running callbacks
84          */
85         function injectEmailUser( &$form ) {
86                 global $wgCaptchaTriggers, $wgOut, $wgUser;
87                 if ( $wgCaptchaTriggers['sendemail'] ) {
88                         if ( $wgUser->isAllowed( 'skipcaptcha' ) ) {
89                                 wfDebug( "ConfirmEdit: user group allows skipping captcha on email sending\n" );
90                                 return true;
91                         }
92                         $form->addFooterText(
93                                 "<div class='captcha'>" .
94                                 $wgOut->parse( $this->getMessage( 'sendemail' ) ) .
95                                 $this->getForm() .
96                                 "</div>\n" );
97                 }
98                 return true;
99         }
100
101         /**
102          * Inject whazawhoo
103          * @fixme if multiple thingies insert a header, could break
104          * @param QuickTemplate $template
105          * @return bool true to keep running callbacks
106          */
107         function injectUserCreate( &$template ) {
108                 global $wgCaptchaTriggers, $wgOut, $wgUser;
109                 if ( $wgCaptchaTriggers['createaccount'] ) {
110                         if ( $wgUser->isAllowed( 'skipcaptcha' ) ) {
111                                 wfDebug( "ConfirmEdit: user group allows skipping captcha on account creation\n" );
112                                 return true;
113                         }
114                         $template->set( 'header',
115                                 "<div class='captcha'>" .
116                                 $wgOut->parse( $this->getMessage( 'createaccount' ) ) .
117                                 $this->getForm() .
118                                 "</div>\n" );
119                 }
120                 return true;
121         }
122
123         /**
124          * Inject a captcha into the user login form after a failed
125          * password attempt as a speedbump for mass attacks.
126          * @fixme if multiple thingies insert a header, could break
127          * @param $template QuickTemplate
128          * @return bool true to keep running callbacks
129          */
130         function injectUserLogin( &$template ) {
131                 if ( $this->isBadLoginTriggered() ) {
132                         global $wgOut;
133                         $template->set( 'header',
134                                 "<div class='captcha'>" .
135                                 $wgOut->parse( $this->getMessage( 'badlogin' ) ) .
136                                 $this->getForm() .
137                                 "</div>\n" );
138                 }
139                 return true;
140         }
141
142         /**
143          * When a bad login attempt is made, increment an expiring counter
144          * in the memcache cloud. Later checks for this may trigger a
145          * captcha display to prevent too many hits from the same place.
146          * @param User $user
147          * @param string $password
148          * @param int $retval authentication return value
149          * @return bool true to keep running callbacks
150          */
151         function triggerUserLogin( $user, $password, $retval ) {
152                 global $wgCaptchaTriggers, $wgCaptchaBadLoginExpiration, $wgMemc;
153                 if ( $retval == LoginForm::WRONG_PASS && $wgCaptchaTriggers['badlogin'] ) {
154                         $key = $this->badLoginKey();
155                         $count = $wgMemc->get( $key );
156                         if ( !$count ) {
157                                 $wgMemc->add( $key, 0, $wgCaptchaBadLoginExpiration );
158                         }
159
160                         $wgMemc->incr( $key );
161                 }
162                 return true;
163         }
164
165         /**
166          * Check if a bad login has already been registered for this
167          * IP address. If so, require a captcha.
168          * @return bool
169          * @access private
170          */
171         function isBadLoginTriggered() {
172                 global $wgMemc, $wgCaptchaTriggers, $wgCaptchaBadLoginAttempts;
173                 return $wgCaptchaTriggers['badlogin'] && intval( $wgMemc->get( $this->badLoginKey() ) ) >= $wgCaptchaBadLoginAttempts;
174         }
175
176         /**
177          * Check if the IP is allowed to skip captchas
178          */
179         function isIPWhitelisted() {
180                 global $wgCaptchaWhitelistIP;
181
182                 if ( $wgCaptchaWhitelistIP ) {
183                         global $wgRequest;
184
185                         // Compat: WebRequest::getIP is only available since MW 1.19.
186                         $ip = method_exists( $wgRequest, 'getIP' ) ? $wgRequest->getIP() : wfGetIP();
187
188                         foreach ( $wgCaptchaWhitelistIP as $range ) {
189                                 if ( IP::isInRange( $ip, $range ) ) {
190                                         return true;
191                                 }
192                         }
193                 }
194                 return false;
195         }
196
197         /**
198          * Internal cache key for badlogin checks.
199          * @return string
200          * @access private
201          */
202         function badLoginKey() {
203                 global $wgRequest;
204                 // Compat: WebRequest::getIP is only available since MW 1.19.
205                 $ip = method_exists( $wgRequest, 'getIP' ) ? $wgRequest->getIP() : wfGetIP();
206                 return wfMemcKey( 'captcha', 'badlogin', 'ip', $ip );
207         }
208
209         /**
210          * Check if the submitted form matches the captcha session data provided
211          * by the plugin when the form was generated.
212          *
213          * Override this!
214          *
215          * @param string $answer
216          * @param array $info
217          * @return bool
218          */
219         function keyMatch( $answer, $info ) {
220                 return $answer == $info['answer'];
221         }
222
223         // ----------------------------------
224
225         /**
226          * @param EditPage $editPage
227          * @param string $action (edit/create/addurl...)
228          * @return bool true if action triggers captcha on editPage's namespace
229          */
230         function captchaTriggers( &$editPage, $action ) {
231                 global $wgCaptchaTriggers, $wgCaptchaTriggersOnNamespace;
232                 // Special config for this NS?
233                 if ( isset( $wgCaptchaTriggersOnNamespace[$editPage->mTitle->getNamespace()][$action] ) )
234                         return $wgCaptchaTriggersOnNamespace[$editPage->mTitle->getNamespace()][$action];
235
236                 return ( !empty( $wgCaptchaTriggers[$action] ) ); // Default
237         }
238
239         /**
240          * @param $editPage EditPage
241          * @param $newtext string
242          * @param $section string
243          * @param $merged bool
244          * @return bool true if the captcha should run
245          */
246         function shouldCheck( &$editPage, $newtext, $section, $merged = false ) {
247                 $this->trigger = '';
248                 $title = $editPage->mArticle->getTitle();
249
250                 global $wgUser;
251                 if ( $wgUser->isAllowed( 'skipcaptcha' ) ) {
252                         wfDebug( "ConfirmEdit: user group allows skipping captcha\n" );
253                         return false;
254                 }
255                 if ( $this->isIPWhitelisted() )
256                         return false;
257
258
259                 global $wgEmailAuthentication, $ceAllowConfirmedEmail;
260                 if ( $wgEmailAuthentication && $ceAllowConfirmedEmail &&
261                         $wgUser->isEmailConfirmed() ) {
262                         wfDebug( "ConfirmEdit: user has confirmed mail, skipping captcha\n" );
263                         return false;
264                 }
265
266                 if ( $this->captchaTriggers( $editPage, 'edit' ) ) {
267                         // Check on all edits
268                         global $wgUser;
269                         $this->trigger = sprintf( "edit trigger by '%s' at [[%s]]",
270                                 $wgUser->getName(),
271                                 $title->getPrefixedText() );
272                         $this->action = 'edit';
273                         wfDebug( "ConfirmEdit: checking all edits...\n" );
274                         return true;
275                 }
276
277                 if ( $this->captchaTriggers( $editPage, 'create' )  && !$editPage->mTitle->exists() ) {
278                         // Check if creating a page
279                         global $wgUser;
280                         $this->trigger = sprintf( "Create trigger by '%s' at [[%s]]",
281                                 $wgUser->getName(),
282                                 $title->getPrefixedText() );
283                         $this->action = 'create';
284                         wfDebug( "ConfirmEdit: checking on page creation...\n" );
285                         return true;
286                 }
287
288                 if ( $this->captchaTriggers( $editPage, 'addurl' ) ) {
289                         // Only check edits that add URLs
290                         if ( $merged ) {
291                                 // Get links from the database
292                                 $oldLinks = $this->getLinksFromTracker( $title );
293                                 // Share a parse operation with Article::doEdit()
294                                 $editInfo = $editPage->mArticle->prepareTextForEdit( $newtext );
295                                 $newLinks = array_keys( $editInfo->output->getExternalLinks() );
296                         } else {
297                                 // Get link changes in the slowest way known to man
298                                 $oldtext = $this->loadText( $editPage, $section );
299                                 $oldLinks = $this->findLinks( $editPage, $oldtext );
300                                 $newLinks = $this->findLinks( $editPage, $newtext );
301                         }
302
303                         $unknownLinks = array_filter( $newLinks, array( &$this, 'filterLink' ) );
304                         $addedLinks = array_diff( $unknownLinks, $oldLinks );
305                         $numLinks = count( $addedLinks );
306
307                         if ( $numLinks > 0 ) {
308                                 global $wgUser;
309                                 $this->trigger = sprintf( "%dx url trigger by '%s' at [[%s]]: %s",
310                                         $numLinks,
311                                         $wgUser->getName(),
312                                         $title->getPrefixedText(),
313                                         implode( ", ", $addedLinks ) );
314                                 $this->action = 'addurl';
315                                 return true;
316                         }
317                 }
318
319                 global $wgCaptchaRegexes;
320                 if ( $wgCaptchaRegexes ) {
321                         // Custom regex checks
322                         $oldtext = $this->loadText( $editPage, $section );
323
324                         foreach ( $wgCaptchaRegexes as $regex ) {
325                                 $newMatches = array();
326                                 if ( preg_match_all( $regex, $newtext, $newMatches ) ) {
327                                         $oldMatches = array();
328                                         preg_match_all( $regex, $oldtext, $oldMatches );
329
330                                         $addedMatches = array_diff( $newMatches[0], $oldMatches[0] );
331
332                                         $numHits = count( $addedMatches );
333                                         if ( $numHits > 0 ) {
334                                                 global $wgUser;
335                                                 $this->trigger = sprintf( "%dx %s at [[%s]]: %s",
336                                                         $numHits,
337                                                         $regex,
338                                                         $wgUser->getName(),
339                                                         $title->getPrefixedText(),
340                                                         implode( ", ", $addedMatches ) );
341                                                 $this->action = 'edit';
342                                                 return true;
343                                         }
344                                 }
345                         }
346                 }
347
348                 return false;
349         }
350
351         /**
352          * Filter callback function for URL whitelisting
353          * @param string url to check
354          * @return bool true if unknown, false if whitelisted
355          * @access private
356          */
357         function filterLink( $url ) {
358                 global $wgCaptchaWhitelist;
359                 $source = wfMessage( 'captcha-addurl-whitelist' )->inContentLanguage()->text();
360
361                 $whitelist = wfMessage( 'captcha-addurl-whitelist', $source )->isDisabled()
362                         ? false
363                         : $this->buildRegexes( explode( "\n", $source ) );
364
365                 $cwl = $wgCaptchaWhitelist !== false ? preg_match( $wgCaptchaWhitelist, $url ) : false;
366                 $wl  = $whitelist          !== false ? preg_match( $whitelist, $url )          : false;
367
368                 return !( $cwl || $wl );
369         }
370
371         /**
372          * Build regex from whitelist
373          * @param string lines from [[MediaWiki:Captcha-addurl-whitelist]]
374          * @return string Regex or bool false if whitelist is empty
375          * @access private
376          */
377         function buildRegexes( $lines ) {
378                 # Code duplicated from the SpamBlacklist extension (r19197)
379
380                 # Strip comments and whitespace, then remove blanks
381                 $lines = array_filter( array_map( 'trim', preg_replace( '/#.*$/', '', $lines ) ) );
382
383                 # No lines, don't make a regex which will match everything
384                 if ( count( $lines ) == 0 ) {
385                         wfDebug( "No lines\n" );
386                         return false;
387                 } else {
388                         # Make regex
389                         # It's faster using the S modifier even though it will usually only be run once
390                         // $regex = 'http://+[a-z0-9_\-.]*(' . implode( '|', $lines ) . ')';
391                         // return '/' . str_replace( '/', '\/', preg_replace('|\\\*/|', '/', $regex) ) . '/Si';
392                         $regexes = '';
393                         $regexStart = '/^https?:\/\/+[a-z0-9_\-.]*(';
394                         $regexEnd = ')/Si';
395                         $regexMax = 4096;
396                         $build = false;
397                         foreach ( $lines as $line ) {
398                                 // FIXME: not very robust size check, but should work. :)
399                                 if ( $build === false ) {
400                                         $build = $line;
401                                 } elseif ( strlen( $build ) + strlen( $line ) > $regexMax ) {
402                                         $regexes .= $regexStart .
403                                                 str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $build ) ) .
404                                                 $regexEnd;
405                                         $build = $line;
406                                 } else {
407                                         $build .= '|' . $line;
408                                 }
409                         }
410                         if ( $build !== false ) {
411                                 $regexes .= $regexStart .
412                                         str_replace( '/', '\/', preg_replace( '|\\\*/|', '/', $build ) ) .
413                                         $regexEnd;
414                         }
415                         return $regexes;
416                 }
417         }
418
419         /**
420          * Load external links from the externallinks table
421          * @param $title Title
422          * @return Array
423          */
424         function getLinksFromTracker( $title ) {
425                 $dbr = wfGetDB( DB_SLAVE );
426                 $id = $title->getArticleID(); // should be zero queries
427                 $res = $dbr->select( 'externallinks', array( 'el_to' ),
428                         array( 'el_from' => $id ), __METHOD__ );
429                 $links = array();
430                 foreach ( $res as $row ) {
431                         $links[] = $row->el_to;
432                 }
433                 return $links;
434         }
435
436         /**
437          * Backend function for confirmEdit() and confirmEditAPI()
438          * @param $editPage EditPage
439          * @param $newtext string
440          * @param $section
441          * @param $merged bool
442          * @return bool false if the CAPTCHA is rejected, true otherwise
443          */
444         private function doConfirmEdit( $editPage, $newtext, $section, $merged = false ) {
445                 global $wgRequest;
446                 if ( $wgRequest->getVal( 'captchaid' ) ) {
447                         $wgRequest->setVal( 'wpCaptchaId', $wgRequest->getVal( 'captchaid' ) );
448                 }
449                 if ( $wgRequest->getVal( 'captchaword' ) ) {
450                         $wgRequest->setVal( 'wpCaptchaWord', $wgRequest->getVal( 'captchaword' ) );
451                 }
452                 if ( $this->shouldCheck( $editPage, $newtext, $section, $merged ) ) {
453                         return $this->passCaptcha();
454                 } else {
455                         wfDebug( "ConfirmEdit: no need to show captcha.\n" );
456                         return true;
457                 }
458         }
459
460         /**
461          * The main callback run on edit attempts.
462          * @param EditPage $editPage
463          * @param string $newtext
464          * @param string $section
465          * @param bool $merged
466          * @return bool true to continue saving, false to abort and show a captcha form
467          */
468         function confirmEdit( $editPage, $newtext, $section, $merged = false ) {
469                 if ( defined( 'MW_API' ) ) {
470                         # API mode
471                         # The CAPTCHA was already checked and approved
472                         return true;
473                 }
474                 if ( !$this->doConfirmEdit( $editPage, $newtext, $section, $merged ) ) {
475                         $editPage->showEditForm( array( &$this, 'editCallback' ) );
476                         return false;
477                 }
478                 return true;
479         }
480
481         /**
482          * A more efficient edit filter callback based on the text after section merging
483          * @param EditPage $editPage
484          * @param string $newtext
485          * @return bool
486          */
487         function confirmEditMerged( $editPage, $newtext ) {
488                 return $this->confirmEdit( $editPage, $newtext, false, true );
489         }
490
491         function confirmEditAPI( $editPage, $newtext, &$resultArr ) {
492                 if ( !$this->doConfirmEdit( $editPage, $newtext, false, false ) ) {
493                         $this->addCaptchaAPI( $resultArr );
494                         return false;
495                 }
496
497                 return true;
498         }
499
500         /**
501          * Hook for user creation form submissions.
502          * @param User $u
503          * @param string $message
504          * @return bool true to continue, false to abort user creation
505          */
506         function confirmUserCreate( $u, &$message ) {
507                 global $wgCaptchaTriggers, $wgUser;
508                 if ( $wgCaptchaTriggers['createaccount'] ) {
509                         if ( $wgUser->isAllowed( 'skipcaptcha' ) ) {
510                                 wfDebug( "ConfirmEdit: user group allows skipping captcha on account creation\n" );
511                                 return true;
512                         }
513                         if ( $this->isIPWhitelisted() )
514                                 return true;
515
516                         $this->trigger = "new account '" . $u->getName() . "'";
517                         if ( !$this->passCaptcha() ) {
518                                 $message = wfMessage( 'captcha-createaccount-fail' )->text();
519                                 return false;
520                         }
521                 }
522                 return true;
523         }
524
525         /**
526          * Hook for user login form submissions.
527          * @param $u User
528          * @param $pass
529          * @param $retval
530          * @return bool true to continue, false to abort user creation
531          */
532         function confirmUserLogin( $u, $pass, &$retval ) {
533                 if ( $this->isBadLoginTriggered() ) {
534                         if ( $this->isIPWhitelisted() )
535                                 return true;
536
537                         $this->trigger = "post-badlogin login '" . $u->getName() . "'";
538                         if ( !$this->passCaptcha() ) {
539                                 // Emulate a bad-password return to confuse the shit out of attackers
540                                 $retval = LoginForm::WRONG_PASS;
541                                 return false;
542                         }
543                 }
544                 return true;
545         }
546
547         /**
548          * Check the captcha on Special:EmailUser
549          * @param $from MailAddress
550          * @param $to MailAddress
551          * @param $subject String
552          * @param $text String
553          * @param $error String reference
554          * @return Bool true to continue saving, false to abort and show a captcha form
555          */
556         function confirmEmailUser( $from, $to, $subject, $text, &$error ) {
557                 global $wgCaptchaTriggers, $wgUser;
558                 if ( $wgCaptchaTriggers['sendemail'] ) {
559                         if ( $wgUser->isAllowed( 'skipcaptcha' ) ) {
560                                 wfDebug( "ConfirmEdit: user group allows skipping captcha on email sending\n" );
561                                 return true;
562                         }
563                         if ( $this->isIPWhitelisted() )
564                                 return true;
565
566                         if ( defined( 'MW_API' ) ) {
567                                 # API mode
568                                 # Asking for captchas in the API is really silly
569                                 $error = wfMessage( 'captcha-disabledinapi' )->text();
570                                 return false;
571                         }
572                         $this->trigger = "{$wgUser->getName()} sending email";
573                         if ( !$this->passCaptcha() ) {
574                                 $error = wfMessage( 'captcha-sendemail-fail' )->text();
575                                 return false;
576                         }
577                 }
578                 return true;
579         }
580
581         /**
582          * @param $module ApiBase
583          * @param $params array
584          * @return bool
585          */
586         public function APIGetAllowedParams( &$module, &$params ) {
587                 if ( !$module instanceof ApiEditPage ) {
588                         return true;
589                 }
590                 $params['captchaword'] = null;
591                 $params['captchaid'] = null;
592
593                 return true;
594         }
595
596         /**
597          * @param $module ApiBae
598          * @param $desc array
599          * @return bool
600          */
601         public function APIGetParamDescription( &$module, &$desc ) {
602                 if ( !$module instanceof ApiEditPage ) {
603                         return true;
604                 }
605                 $desc['captchaid'] = 'CAPTCHA ID from previous request';
606                 $desc['captchaword'] = 'Answer to the CAPTCHA';
607
608                 return true;
609         }
610
611         /**
612          * Given a required captcha run, test form input for correct
613          * input on the open session.
614          * @return bool if passed, false if failed or new session
615          */
616         function passCaptcha() {
617                 $info = $this->retrieveCaptcha();
618                 if ( $info ) {
619                         global $wgRequest;
620                         if ( $this->keyMatch( $wgRequest->getVal( 'wpCaptchaWord' ), $info ) ) {
621                                 $this->log( "passed" );
622                                 $this->clearCaptcha( $info );
623                                 return true;
624                         } else {
625                                 $this->clearCaptcha( $info );
626                                 $this->log( "bad form input" );
627                                 return false;
628                         }
629                 } else {
630                         $this->log( "new captcha session" );
631                         return false;
632                 }
633         }
634
635         /**
636          * Log the status and any triggering info for debugging or statistics
637          * @param string $message
638          */
639         function log( $message ) {
640                 wfDebugLog( 'captcha', 'ConfirmEdit: ' . $message . '; ' .  $this->trigger );
641         }
642
643         /**
644          * Generate a captcha session ID and save the info in PHP's session storage.
645          * (Requires the user to have cookies enabled to get through the captcha.)
646          *
647          * A random ID is used so legit users can make edits in multiple tabs or
648          * windows without being unnecessarily hobbled by a serial order requirement.
649          * Pass the returned id value into the edit form as wpCaptchaId.
650          *
651          * @param array $info data to store
652          * @return string captcha ID key
653          */
654         function storeCaptcha( $info ) {
655                 if ( !isset( $info['index'] ) ) {
656                         // Assign random index if we're not udpating
657                         $info['index'] = strval( mt_rand() );
658                 }
659                 CaptchaStore::get()->store( $info['index'], $info );
660                 return $info['index'];
661         }
662
663         /**
664          * Fetch this session's captcha info.
665          * @return mixed array of info, or false if missing
666          */
667         function retrieveCaptcha() {
668                 global $wgRequest;
669                 $index = $wgRequest->getVal( 'wpCaptchaId' );
670                 return CaptchaStore::get()->retrieve( $index );
671         }
672
673         /**
674          * Clear out existing captcha info from the session, to ensure
675          * it can't be reused.
676          */
677         function clearCaptcha( $info ) {
678                 CaptchaStore::get()->clear( $info['index'] );
679         }
680
681         /**
682          * Retrieve the current version of the page or section being edited...
683          * @param EditPage $editPage
684          * @param string $section
685          * @return string
686          * @access private
687          */
688         function loadText( $editPage, $section ) {
689                 $rev = Revision::newFromTitle( $editPage->mTitle );
690                 if ( is_null( $rev ) ) {
691                         return "";
692                 } else {
693                         $text = $rev->getText();
694                         if ( $section != '' ) {
695                                 global $wgParser;
696                                 return $wgParser->getSection( $text, $section );
697                         } else {
698                                 return $text;
699                         }
700                 }
701         }
702
703         /**
704          * Extract a list of all recognized HTTP links in the text.
705          * @param $editpage EditPage
706          * @param $text string
707          * @return array of strings
708          */
709         function findLinks( &$editpage, $text ) {
710                 global $wgParser, $wgUser;
711
712                 $options = new ParserOptions();
713                 $text = $wgParser->preSaveTransform( $text, $editpage->mTitle, $wgUser, $options );
714                 $out = $wgParser->parse( $text, $editpage->mTitle, $options );
715
716                 return array_keys( $out->getExternalLinks() );
717         }
718
719         /**
720          * Show a page explaining what this wacky thing is.
721          */
722         function showHelp() {
723                 global $wgOut;
724                 $wgOut->setPageTitle( wfMessage( 'captchahelp-title' )->text() );
725                 $wgOut->addWikiMsg( 'captchahelp-text' );
726                 if ( CaptchaStore::get()->cookiesNeeded() ) {
727                         $wgOut->addWikiMsg( 'captchahelp-cookies-needed' );
728                 }
729         }
730 }