TYPO3 CAPTCHA Extension

The following tutorial will guide you on how to integrate the TrustCaptcha CAPTCHA solution into your TYPO3 website to protect it from bots and spam.

You should have already completed the following steps before you start to integrate TrustCaptcha into your TYPO3 website.

1. Read Get-Started: Get a quick overview of the concepts behind TrustCaptcha and the integration process in get started.

2. Existing CAPTCHA: If you don’t have a CAPTCHA yet, sign in or create a new user account. Then create a new CAPTCHA.

3. Existing TYPO3 website: You need a TYPO3 website in which you want to integrate TrustCaptcha.

Our TYPO3 CAPTCHA extension for TrustCaptcha currently supports the following TYPO3 extensions:

• Form
• Powermail

Follow the steps below to integrate the TrustCaptcha CAPTCHA plugin into your TYPO3 website.

Perform the following steps to install the CAPTCHA extension via Composer (Packagist). Use the tab that matches your TYPO3 version:

TYPO3 v12+

composer require trustcomponent/trustcaptcha-typo3:^2.0 --with-all-dependencies
php vendor/bin/typo3 extension:setup --no-interaction
php vendor/bin/typo3 cache:flush
php vendor/bin/typo3 cache:warmup

TYPO3 v11

composer require trustcomponent/trustcaptcha-typo3:^2.0 --with-all-dependencies
php vendor/bin/typo3cms cache:flush

You can find our TrustCaptcha TYPO3 package on Packagist.

Follow these steps to configure TrustCaptcha in your TYPO3 instance:

1. Login as an admin to your TYPO3 instance.
2. Navigate to Admin Tools → Settings → Extension Configuration → trustcaptcha.
3. Enter the site-key and secret-key of your CAPTCHA. You can find these keys in your CAPTCHA settings.
4. Optional: Adjust additional settings such as language, theme, or threshold as needed.

Integrate TrustCaptcha into your existing form in just a few steps:

1. Navigate to Web → Forms and edit the form into which you want to integrate TrustCaptcha.
2. Click on Create new element. Select the TrustCaptcha element from the list of available form elements and insert it into your form.
3. Save your changes.

Your form is now protected with TrustCaptcha. When your form is submitted by a user, the CAPTCHA result is verified. If verification is successful, the finishers are executed. If the CAPTCHA fails, the user will see the form again with an error message.

The video clearly shows the most important steps. It uses a sample form and TYPO3 13.4.

Integrate TrustCaptcha into your existing Powermail form in just a few steps:

1. Navigate to your Powermail form and edit it.
2. Click on Create new Field.
3. Assign a label such as Captcha and select TrustCaptcha as the type.
4. Save your changes.

Your form is now protected with TrustCaptcha. When your form is submitted by a user, the CAPTCHA result is verified and, if successful, the sending process of your Powermail form continues. If the CAPTCHA fails, the user will see the form again with an error message.

The video clearly shows the most important steps. It uses a sample form and TYPO3 13.4.

Once you have successfully installed and configured TrustCaptcha on your website, you can use TrustCaptcha to its full extent. However, we still recommend the following additional technical and organizational measures:

• Security rules: You can find many security settings for your CAPTCHA in the CAPTCHA settings. These include, for example, authorized websites, CAPTCHA bypass for specific IP addresses, bypass keys, IP based blocking, geoblocking, individual difficulty and duration of the CAPTCHA, and much more. Learn more about the security rules.

• Data protection: Include a passage in your privacy policy that refers to the use of TrustCaptcha. We also recommend that you enter into a data processing agreement with us to stay GDPR-compliant. Learn more about data protection.

• Accessibility: Customize TrustCaptcha to your website so that your website is as accessible as possible and offers the best possible user experience. More about accessibility.

• Testing: If you use automated testing, make sure that the CAPTCHA does not block it. Learn more about testing.