EU CAPTCHA for TYPO3

Frequently Asked Questions

• How do I add EU CAPTCHA to a TYPO3 website?

  Add verify.js and the EU CAPTCHA widget div with your sitekey to your TYPO3 Fluid form templates. In your TYPO3 extension's controller or form finisher, read the eu-captcha-response from the request arguments and make a server-side verification call to the EU CAPTCHA API with your secret key before processing or storing the form submission.

• Is there an official EU CAPTCHA extension for TYPO3?

  EU CAPTCHA can be integrated into TYPO3 via a custom captcha finisher for the TYPO3 Form Framework or by using the TYPO3 Spam Shield extension framework. A dedicated EU CAPTCHA finisher class calls the verification API as part of the form processing pipeline. Consult the EU CAPTCHA documentation for the recommended extension approach for your TYPO3 version.

• Does EU CAPTCHA work with TYPO3's Form Framework and Powermail?

  Yes. For the TYPO3 Form Framework (EXT:form), create a custom form finisher that performs EU CAPTCHA verification before other finishers run. For Powermail, add a custom validator or use Powermail's PreSaveEvent to verify the token. Both integration patterns use the same EU CAPTCHA REST API call with your secret key.

• How do I integrate EU CAPTCHA with TYPO3 Fluid templates?

  In your Fluid form template, add a script ViewHelper to load verify.js and place the EU CAPTCHA widget div with your data-sitekey attribute inside the form. Ensure the widget div is inside the form tag so the eu-captcha-response hidden input is submitted with the form data when the user submits.

• How do I verify a CAPTCHA token in a TYPO3 form finisher?

  Create a finisher class that implements FinisherInterface. In the execute method, read the eu-captcha-response from the form state values, make an HTTP POST request to the EU CAPTCHA API using TYPO3's RequestFactory or a plain cURL/Guzzle call, and throw a FinisherException if verification fails to stop the form processing pipeline.

• Is EU CAPTCHA compatible with TYPO3 v12 and v13?

  Yes. EU CAPTCHA uses standard web technologies for the frontend widget and a REST API for server-side verification. This approach is compatible with TYPO3 v12 and v13, as the integration does not rely on any deprecated TYPO3 APIs. The Fluid template and finisher approach works consistently across major TYPO3 versions.

• Is EU CAPTCHA GDPR compliant for TYPO3 websites?

  Yes. EU CAPTCHA is operated by an EU-based company, is hosted entirely in Germany, and does not rely on US cloud providers or infrastructure subject to US surveillance laws. The service processes only the data necessary to provide and verify the CAPTCHA (such as IP address and technical browser or device information) in line with the requirements of the GDPR. Your organization remains responsible for providing transparent privacy information, selecting an appropriate legal basis, and obtaining any required consent for your specific TYPO3 implementation. This information does not constitute legal advice; please consult your legal counsel for an assessment of your individual case.