guave/cloudflareturnstile-bundle

Cloudflare Turnstile for Contao

1.0.0 2025-05-16 01:49 UTC

Requires

• php: ^7.4 || ^8.0
• ext-curl: *
• contao/core-bundle: ^4.13
• symfony/config: ^5.4
• symfony/dependency-injection: ^5.4
• symfony/http-kernel: ^5.4

Requires (Dev)

• bamarni/composer-bin-plugin: ^1.5
• contao/manager-plugin: ^2.0
• phpunit/phpunit: ^9.5
• roave/security-advisories: dev-latest
• symfony/phpunit-bridge: ^6.1

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

ISC

README

This Contao module overrides the default security questions/captcha form field with Turnstile.

Requirements

• Contao 4.13+
• PHP 7.4 or 8.0+

Install

$ composer require guave/cloudflareturnstile-bundle

Usage

There are two ways to add the configuration needed:

a) Go to Settings in the Contao Backend and add your Turnstile Site Key and Secret Key under "Security: Cloudflare Turnstile"

or

b) Add your Turnstile Site Key and Secret Key on system/config/localconfig.php:

$GLOBALS['TL_CONFIG']['turnstilePublicKey'] = '<YOUR-SITE-KEY>';
$GLOBALS['TL_CONFIG']['turnstilePrivateKey'] = '<YOUR-SECRET-KEY>';
$GLOBALS['TL_CONFIG']['turnstileGlobalThreshold'] = 0.5;