evoweb/recaptcha

Easy on Humans, Hard on Bots

14.1.2 2025-12-12 18:51 UTC

Requires

• psr/http-message: ^1.1 || ^2.0
• typo3/cms-core: ^13.0 || ^14.0 || 14.*.*@dev || dev-main
• typo3/cms-extbase: ^13.0 || ^14.0 || 14.*.*@dev || dev-main
• typo3/cms-fluid: ^13.0 || ^14.0 || 14.*.*@dev || dev-main
• typo3/cms-frontend: ^13.0 || ^14.0 || 14.*.*@dev || dev-main

Requires (Dev)

• evoweb/sf-register: dev-develop
• friendsofphp/php-cs-fixer: ^3.64.0
• friendsoftypo3/phpstan-typo3: ^0.9.0
• phpstan/phpdoc-parser: ^1.30.0
• phpstan/phpstan: ^1.12.5
• phpunit/phpunit: ^11.0.3
• typo3/testing-framework: dev-main

Suggests

• typo3/cms-form: *

GPL-2.0-or-later

• recaptcha
• Invisible captcha
• nocaptcha 2

README

TYPO3 Extension to make use of Googles nocaptcha.
Now supports googles invisible reCAPTCHA.

Installation

via Composer

The recommended way to install TYPO3 Console is by using Composer:

composer require evoweb/recaptcha

via TYPO3 Extension Repository

Download and install the extension with the extension manager module or directly from the TER.

Integrate invisible reCAPTCHA in tx_form TypoScript forms

To be able to use the captcha, add the static include of this extension to your template.

After that, add in the TypoScript of the form.

lib.contactForm = FORM
lib.contactForm {
	70 < lib.invisibleRecaptchaIntegration.10

	rules {
		7 < lib.invisibleRecaptchaIntegration.rules.1
	}
}

Integrate invisible reCAPTCHA in own forms

To be able to use the captcha, add the static include of this extension to your template.

After modify your form output by replacing the submit-button with something like this:

<button
	data-sitekey="6LfmFxQUAAAAAGiMRvzLHGYQ8KiQiqgBuY5NswDz"
	data-callback="onContactformCaptchaSubmit"
	class="g-recaptcha"
	type="button" name="tx_form_form[tx_form][id-11]"
	value="absenden">
		absenden
</button>

After that you're ready on the frontend but still need to call the validation in your php code.

$validCaptcha = false;

$captchaService = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\Evoweb\Recaptcha\Services\CaptchaService::class);
$captchaServiceValidation = $captchaService->validateReCaptcha();
if (isset($captchaServiceValidation['verified'])) {
	if ($captchaServiceValidation['verified'] === true) {
		$validCaptcha = true;
	}
}