Benutzer Handbuch

Erforderliche Konfiguration

  1. Du musst deine Seite registrieren um ein API-Schlüsselpaar für reCAPTCHA (v2 und/oder v3) zu erhalten: http://www.google.com/recaptcha/admin

  2. Trage diese Schlüssel (v2 und/oder v3) und die Version in TypoScript ein:

 1plugin.tx_jhcaptcha.settings.reCaptcha {
 2    version =
 3    v2 {
 4        siteKey =
 5        secretKey =
 6    }
 7    v3 {
 8        siteKey =
 9        secretKey =
10    }
11}

Optionale Konfiguration

 1plugin.tx_jhcaptcha.settings.reCaptcha {
 2    v2 {
 3        # Beschreibung: Farbe des Captchas
 4        # Optionen: dark | light
 5        # Standard: light
 6        theme = light
 7        # Beschreibung: Die Sprache des Captchas
 8        # Optionen: https://developers.google.com/recaptcha/docs/language
 9        # Standard: en
10        lang = en
11        # Beschreibung: Die Größe des Captchas
12        # Optionen: normal | compact
13        # Standard: normal
14        size = normal
15    }
16    v3 {
17        # Beschreibung: Mindestpunktzahl (0.0 - 1.0)
18        # Standard: 0.5
19        minimumScore = 0.5
20        # Beschreibung: Siehe https://developers.google.com/recaptcha/docs/v3
21        action = homepage
22    }
23}

Verwendung in Form (EXT:form)

Das reCAPTCHA kann leicht in der Core Erweiterung Form verwendet werden. Folgende Schritte sind dafür notwendig:

Erstelle dazu in deinem Formular ein neues Feld reCAPTCHA (JhCaptchaRecaptcha) und speichere das Formular. Jetzt ist das reCAPTCHA einsatzbereit!

Verwendung in Powermail (EXT:powermail)

Das reCAPTCHA kann leicht in der Erweiterung Powermail verwendet werden. Folgende Schritte sind dafür notwendig:

Note

Bitte beachte, dass die Verwendung nur in den Powermail Versionen 8.2 und 10.4 getestet wurde! Wahrscheinlich läuft es auch mit anderen Versionen.

Erstelle dazu in deinem Formular ein neues Feld, vergebe eine Bezeichnung (z.B. "Captcha") und wähle den Typ "reCAPTCHA (jh_captcha)" aus. Jetzt ist das reCAPTCHA einsatzbereit!

Verwendung in Formhandler (EXT:formhandler)

Das reCAPTCHA kann leicht in der Erweiterung Formhandler (Fork: phorax/formhandler für TYPO3 v10) verwendet werden. Folgende Schritte sind dafür notwendig:

1. Mastertemplate

Zuerst muss das Captcha im Mastertemplate aufgenommen werden. Beispiel:

1<!-- ###master_spamprotection-jh_captcha_recaptcha### -->
2<div class="row">
3    <div class="large-12 columns">
4            ###jh_captcha_recaptcha###
5            ###error_jh_captcha_recaptcha###
6    </div>
7</div>
8<!-- ###master_spamprotection-jh_captcha_recaptcha### -->

2. Template

Jetzt kann der Marker im Formular-Template verwendet werden:

1###master_spamprotection-jh_captcha_recaptcha###

3. TypoScript

Danach müssen die Validatoren für das Captcha-Feld zugewiesen werden:

1    [...]
2    validators.1.config.fieldConf {
3        jh_captcha_recaptcha.errorCheck {
4            1 = required
5            2 = \Haffner\JhCaptcha\Validation\ErrorCheck\ReCaptcha
6        }
7    }
8    [...]

4. Sprachdatei

Zum Schluss muss noch das Label sowie die Fehlermeldungen definiert werden. Beispiel:

1<label index="jh_captcha_recaptcha">reCAPTCHA</label>
2<label index="error_jh_captcha_recaptcha_required">reCAPTCHA ist ein Pflichtfeld.</label>
3<label index="error_jh_captcha_recaptcha_recaptcha">Fehler beim Validieren des reCAPTCHA.</label>

Anschließend ist das reCAPTCHA einsatzbereit.