Configuration

Reference

Following parameter are available as constants. And with the same name also as setup parameter.

plugin.tx_recaptcha:

api_server

api_server
Type
string
Default
https://www.google.com/recaptcha/api.js

This url is used to include the basic frontend functionality. In general it's not necessary to modify this url. In case that the api changes and the extension is not updated quick enough changing this parameter keeps the frontend working.

verify_server

verify_server
Type
string
Default
https://www.google.com/recaptcha/api/siteverify

Every verification uses this url to check if the captcha was solved. In general it's not necessary to modify this url. In case that the api changes and the extension is not updated quick enough changing this parameter keeps the validation working.

public_key

public_key
Type
string
Default
6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI

The public key is needed for the frontend rendering.

Google provides a key for automatic testing purpose and this is used as default. To remove the warning that is caused by using the default key please go to the recaptcha admin and register an own key for use in your site.

private_key

private_key
Type
string
Default
6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

The private key is needed for the validation of submits.

Google provides a key for automatic testing purpose and this is used as default. To remove the warning that is caused by using the default key please go to the recaptcha admin and register an own key for use in your site.

lang

lang
Type
string

Recaptcha is very good in automatic detecting which language to use based on the users browser settings and with which IP the page gets visited. Only in case if it is really necessary set this parameter to take influence on the rendered language.

enforceCaptcha

enforceCaptcha
Type
string
Default
0

This configuration parameter will enforce the captcha to test the functionality on development systems. EXT:recaptcha uses the application context to detect if an installation is running in Development mode. If so the captcha is not rendered or validated. This is a to reduce external calls and b to not bother the integrator every time he has to test forms. Because after a limited amount of tests the captcha testing games must always be solved instead only clicking a checkbox.

invisibleCallback

invisibleCallback
Type
string
Default
onRecaptchaSubmit

[Only TypoScript] For invisible reCAPTCHA its necessary to have a callback function in JavaScript. It is possible to have own code that derives from the included. If in this case the name of the callback is changed please adjust this parameter to match the new name.

theme

theme
Type
string
Default
light
Possible values
light, dark

[Only TypoScript] For change the theme for recaptcha (light or dark).

robotMode

robotMode
Type
string
Default
0

[Only TypoScript] Add the possibility to set the recaptcha into robot mode in production environment. The recaptcha will not be displayed like in development mode.