DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Installation

Download or import the reCAPTCHA extension

First you should download the extension either as a T3X file, that you can import with the Extension Manager, or directly from the TER by using the repository import features of the Extension Manager.

Include static template(s)

To get reCAPTCHA working in frontend, you should include the static template that is provided with the extenion. To do so, follow the steps below:

  • Edit your main TypoScript template record of your website
  • In the select box Include static (from extensions), add the template reCAPTCHA.

Get a reCAPTCHA API Key

To use reCAPTCHA on your website, you need a reCAPTCHA API key. To get this key, visit https://www.google.com/recaptcha/ and register a website. You need the Site Key and Secret Key that are generated by Google.

Configure extension

To setup the extension, we need the Site Key and Secret Key that are generated in the previous step. Follow the steps below:

  • Edit your main TypoScript template record of your website
  • Add the following constants (replace [siteKey] and [secretKey] with the values created on the reCAPTCHA website):
plugin.tx_powermail.settings.reCAPTCHA {
  siteKey = [siteKey]
  secretKey = [secretKey]
}

After these settings are done, you can add the reCAPTCHA field to your form. See Usage to implement reCAPTCHA in your forms.

Translation

If you want to add your own translations, you can do this by adding them via TypoScript. You can use the following TypoScript to override the default translations:

plugin.tx_rhrecaptcha._LOCAL_LANG.de {
  validation {
    possible_robot = My new text
  }
}