Creare Form con validazione e CAPTCHA in Joomla 3 - terza parte

Immagine da Joomla

reCAPTCHA is a free service that protects your website from spam and abuse. reCAPTCHA uses an advanced risk analysis engine and adaptive CAPTCHAs to keep automated software from engaging in abusive activities on your site. It does this while letting your valid users pass through with ease.

• Collegarsi alla pagina reCAPTCHA di google per registrare il dominio sul quale attivare la validazione; dovete disporre di un account Google, in caso contrario se ne deve creare uno.
• Assegnare un nome per il sito nel campo Etichetta e selezionare il tipo di reCAPATCHA; nel nostro caso, reCAPTCHA V2. Quindi indicare il dominio e spuntare la casella dei termini di servizio, come da figura:
  
  

  Clic per ingrandire
• Fare clic su Registrazione per completare la procedura. Nella pagina successiva sono elencate le chiavi necessarie per utilizzare reCAPTCHA, quella pubblica (Chiave del sito) e quella privata (Chiave segreta)

<script src='https://www.google.com/recaptcha/api.js?hl=it'></script>

<div class="g-recaptcha" data-sitekey="copiaquilatuachiavepubblica"></div>

<?php  
	require_once('autoload.php'); 
	$secret = "copiaquilatuachiaveprivata";
	$lang='it';
	$result=false;	
	$recaptcha = new \ReCaptcha\ReCaptcha($secret);
	
	$response = $recaptcha->verify($_POST['g-recaptcha-response'], $_SERVER['REMOTE_ADDR']);

	if ($response->isSuccess()) {
		$result=true;
	} 
	else {
		foreach ($response->getErrorCodes() as $code) {
			echo '<tt>Errore: ' , $code , '</tt> ';
		}
		
		$result=false;
	}

	echo json_encode($result);
?>

• Riga iniziale:

  require_once('autoload.php');

  Roba di google. Lo scaricate sempre dal repository ufficiale, quindi lo caricherete sul sito nella stessa cartella dove andremo a caricare il codice PHP.
• Successive:

  $secret = "copiaquilatuachiaveprivata";
  $lang='it';		
  $result=false;	
  $recaptcha = new \ReCaptcha\ReCaptcha($secret);

  Sono variabili: $secret deve contenere la vostra chiave privata, le altre sono inizializzazioni. Pigliatele così, senza chiedere ...
• Tutto il resto:

  $response = $recaptcha->verify($_POST['g-recaptcha-response'], $_SERVER['REMOTE_ADDR']);
  if ($response->isSuccess()) {
  	$result=true;
  } 
  else {
  	foreach ($response->getErrorCodes() as $code) {
  		echo '<tt>Errore: ' , $code , '</tt> ';
  	}
  	
  	$result=false;
  }
  
  echo json_encode($result);

  Qui controlliamo se la verifica è andata a buon fine (..isSuccess()...); se sì $result è true, altrimenti false, con stampa dei codici di errore. Rimane poi questa "strana" riga json_encode e compagnia bella. Brevemente, ritorna la rappresentazione json di quello che le viene passato (v. la documentazione relativa su php.net).

• Scarichiamo localmente dalla pagina del repository sia la cartella ReCaptcha che il file autoload.php;
• Carichiamo cartella e file sul sito, magari copiandoli in una cartella dedicata, che potremmo chiamare "captcha";
• Salviamo il sorgente precedente con un nome (p.e. "submit-captcha.php") e carichiamolo sul sito nella medesima cartella "captcha";

<form action="captcha/submit-captcha.php" method="post">	
	<div class="g-recaptcha" data-sitekey="6LcbzCEUAAAAAEl2nyx_h0kYgy6gOv4JYxnNarYI"></div>
	<button class="uk-button uk-button-primary uk-button-small uk-margin-top" type="submit" value="Invia">Invia</button>
</form>	

1. Un procedimento del genere prevede l'uso di codice PHP, cosa che richiede l'installazione di un plugin; come ho detto nella prima parte della serie di articoli, voglio creare questo form senza ricorrere a software di terzi;
2. Secondo, l'integrazione con jQuery Validation Plugin è molto più efficiente, evitando di inviare il form se l'utente ha lasciato vuota la casella Non sono un robot, dando un risultato più elegante e rimanendo coerente con la gestione degli altri campi che vengono validati.