MyWackoSite : Wacko Wiki Recaptcha

Оглавление документа

1. Установка ReCaptcha на WackoWiki R4.2

2. Возможные проблемы и методы решения

2.1. Глобальные переменные в библиотеке ReCaptcha

2.2. Браузер “Opera” и ReCaptcha

3. Дополнительно: diff файлы.

4. Скрипт автоматической установки

5. Ссылки

1. Установка ReCaptcha на WackoWiki R4.2

1. Заходим на сайт

http://recaptcha.net/, регистрируемся, получаем private и public ключи для вашего домена, и скачиваем библиотеку с php-кодом.
Копируем ее себе на сайт, разархивируем. Запоминаем где у вас на сервере лежит файлик 'recaptchalib.php'.

2. Заходим в домашнюю директорию WackoWiki.

Редактируем файл «actions/registration.php»

В самое начало файла, до кода

<!--notypo-->
<?php

добавляем, заменяя :

<?php 
	/*Captcha BEGIN*/
	require_once('путь_до_файла_recaptchalib.php'); //здесь прописываем путь, где находится библиотека ReCaptcha

	$publickey = "public_код_полученный_при_регистрации_recaptcha";
	$privatekey = "private_код_полученный_при_регистрации_recaptcha";

	# the response from reCAPTCHA
	$resp = null;
	
	# was there a reCAPTCHA response?
	if ($_POST["recaptcha_response_field"]) {
        $resp = recaptcha_check_answer ($privatekey,
                                        $_SERVER["REMOTE_ADDR"],
                                        $_POST["recaptcha_challenge_field"],
                                        $_POST["recaptcha_response_field"]);
	}
	 /*Captcha END*/
?>

Далее, ищем строки:

// check if name is WikiName style
      if (!$this->IsWikiName($name)) $error = $this->GetResourceValue("MustBeWikiName");
      else if (!$email) $error = $this->GetResourceValue("SpecifyEmail");
      else if (!preg_match("/^.+?\@.+$/", $email)) $error = $this->GetResourceValue("NotAEmail");
      else if ($confpassword != $password) $error = $this->GetResourceValue("PasswordsDidntMatch");
      else if (preg_match("/ /", $password)) $error = $this->GetResourceValue("SpacesArentAllowed");
      else if (strlen($password) < 5) $error = $this->GetResourceValue("PasswordTooShort");

Сразу посли них дописываем:

/*Captcha BEGIN*/
	  else if ($resp==null || !($resp->is_valid)) { $error = $resp->error;}
	  /*Captcha END*/

Теперь собственно добавляем саму форму ReCaptcha – ищем строки:

<tr>
      <td align="right"><?php echo $this->GetResourceValue("Email");?>:</td>
      <td><input name="email" size="30" value="<?php echo htmlspecialchars($email); ?>" /></td>
    </tr>

и сразу после них добавляем:

<!--Captcha BEGIN-->
	<tr><td align="right">Captcha</td><td>
	<?php 
		echo recaptcha_get_html($publickey, $error);
	?>
	</td></tr>
	<!--Captcha END-->

После этого все должно заработать.

2. Возможные проблемы и методы решения

2.1. Глобальные переменные в библиотеке ReCaptcha

По каким то причинам, после интеграции ReCaptcha в WackoWiki, ничего не заработало. После изучения кода библиотеки было обнаружено, что в файле “recaptchalib.php” не видны глобальные переменные. Решение проблемы состоит в том, чтобы
1. Заккоментировать эти самые глобальные переменные в коде библиотеки и их использование с помощью оператора globals.
2. В каждую функцию, где используются эти переменные просто скопировать их.

Рассмотрим причины такого поведения библиотеки ReCaptcha, встроенной в WackoWiki.
Итак, запускается файл wacko.php с передаными ему параметрами
в нем создается объект класса Wacko и запускается функция этого объекта Run(). Внутри этой функции происходит вызов многих других функций этого класса, и одна из этих функций делает include для файла registration.php, которая в свою очередь делает inlcude для библиотеки ReCaptcha. Но вспомним, что include в данном случае – это простое текстовое включение. Т.е. весь файл включается внутрь тела функции. Но в этом файле существуют переменные, которые библиотека считает глобальными, но после включения внутрь функции становятся локальными для этой функции, и получается что глобальных переменных с такими именами нет.

2.2. Браузер “Opera” и ReCaptcha

Для браузера Opera иногда бывает важна валидность кода, которую можно проверить на

http://w3c.org. Сразу после установки ReCaptcha в WackaWiki код становиться не валидным, и регистрация не проходит. Решение: сделать код валидным, для этого:
1. Открыть файл “recaptchalib.php”, найти все вставки html-кода, и переписать их под xhtml 1.0, в частности закрыть все одиночные теги (например заменить “<br>" на "<br />".
2. Ошибка самой WackoWiki (а точнее некоторых ее форматтеров), которая зачем-то вставляет «вокруг» формы регистрации тег “<p>". Решение следующее: открываем «handlers\page\show.php” для редактирования, находим строку

$data = $this->Format($this->page["body_r"], "post_wacko", array("bad"=>"good"));

и заменяем ее на

$data = $this->Format($this->page["body"], "wakka");

3. Дополнительно: diff файлы.

Для установки с помощью утилиты patch можно использовать следующие diff-файлы

“recaptchalib.php”
– проблема с глобальными переменными и соответствие html-кода стандарту xhtml 1.0

*** WackoWiki/lib/recaptchalib.php	2007-06-05 11:34:40.000000000 +0700
--- MWackoWiki/lib/recaptchalib.php	2007-07-05 09:47:07.307574744 +0700
***************
*** 37,41 ****
   */
- $recaptcha_api_server = 'http://api.recaptcha.net';
- $recaptcha_api_secure_server = 'https://api-secure.recaptcha.net';
- $recaptcha_verify_server = 'api-verify.recaptcha.net';
  
--- 37,38 ----
***************
*** 108,110 ****
  {
!         global $recaptcha_api_server, $recaptcha_api_secure_server;
  
--- 105,108 ----
  {
! 	$recaptcha_api_server = 'http://api.recaptcha.net';
! 	$recaptcha_api_secure_server = 'https://api-secure.recaptcha.net';
  
***************
*** 126,130 ****
  	<noscript>
!   		<iframe src="'. $server . '/noscript?k=' . $pubkey . $errorpart . '" height="300" width="500" frameborder="0"></iframe><br>
    		<textarea name="recaptcha_challenge_field" rows="3" cols="40"></textarea>
!   		<input type="hidden" name="recaptcha_response_field" value="manual_challenge">
  	</noscript>';
--- 124,128 ----
  	<noscript>
!   		<iframe src="'. $server . '/noscript?k=' . $pubkey . $errorpart . '" height="300" width="500" frameborder="0"></iframe><br />
    		<textarea name="recaptcha_challenge_field" rows="3" cols="40"></textarea>
!   		<input type="hidden" name="recaptcha_response_field" value="manual_challenge" />
  	</noscript>';
***************
*** 172,174 ****
  
!         global $recaptcha_verify_server;
          $response = _recaptcha_http_post ($recaptcha_verify_server, "/verify",
--- 170,172 ----
  
! 		$recaptcha_verify_server = 'api-verify.recaptcha.net';
          $response = _recaptcha_http_post ($recaptcha_verify_server, "/verify",

«handlers/page/show.php»

*** WackoWiki/handlers/page/show.php	2005-02-26 19:16:34.000000000 +0600
--- MWackoWiki/handlers/page/show.php	2007-07-05 09:33:21.021189368 +0700
***************
*** 47,49 ****
      // display page
!     $data = $this->Format($this->page["body_r"], "post_wacko", array("bad"=>"good"));
      $data = $this->NumerateToc( $data ); //  numerate toc if needed
--- 47,51 ----
      // display page
! 	/*Captcha BEGIN*/
!     $data = $this->Format($this->page["body"], "wakka");
! 	/*Captcha END*/
      $data = $this->NumerateToc( $data ); //  numerate toc if needed

«actions/registration.php»
Не забудте заполнить keys.

*** WackoWiki/actions/registration.php	2005-02-26 20:23:20.000000000 +0600
--- MWackoWiki/actions/registration.php	2007-07-05 09:58:44.835534376 +0700
***************
*** 1 ****
--- 1,20 ----
+ <?php 
+ 	/*Captcha BEGIN*/
+ 	require_once('lib/recaptchalib.php');
+       $publickey = "public_key_полученный_при_регистрации_recaptcha"; 
+ 	$privatekey = "private_key_полученный_при_регистрации_recaptcha";
+ 
+ 	# the response from reCAPTCHA
+ 	$resp = null;
+ 	
+ 	# was there a reCAPTCHA response?
+ 	if ($_POST["recaptcha_response_field"]) {
+         $resp = recaptcha_check_answer ($privatekey,
+                                         $_SERVER["REMOTE_ADDR"],
+                                         $_POST["recaptcha_challenge_field"],
+                                         $_POST["recaptcha_response_field"]);
+ 	}
+ 	 /*Captcha END*/
+ ?>
+ 
  <!--notypo-->
***************
*** 40,41 ****
--- 59,63 ----
        else if (strlen($password) < 5) $error = $this->GetResourceValue("PasswordTooShort");
+ 	  /*Captcha BEGIN*/
+ 	  else if ($resp==null || !($resp->is_valid)) { $error = $resp->error;}
+ 	  /*Captcha END*/
        else
***************
*** 126,127 ****
--- 148,156 ----
      </tr>
+ 	<!--Captcha BEGIN-->
+ 	<tr><td align="right">Captcha</td><td>
+ 	<?php 
+ 		echo recaptcha_get_html($publickey, $error);
+ 	?>
+ 	</td></tr>
+ 	<!--Captcha END-->
      <tr>