Cloudflare Turnstile einrichten
Auf dieser Seite
Cloudflare Turnstile ist ein datenschutzfreundliches CAPTCHA-Element ohne Cookies und ohne Nutzer-Tracking, das auch für nicht eingeloggte Besucher funktioniert. Das Plugin stellt es als eigenes Formularelement zur Verfügung, das Sie über den Drag-and-Drop-Builder in jedes Formular einfügen können; alternativ steht das JTL-eigene Captcha-Element als Spamschutz zur Verfügung.
Schritt 1: Cloudflare-Konto anlegen
- Auf https://dash.cloudflare.com/sign-up ein kostenloses Konto registrieren.
- E-Mail-Adresse über den Bestätigungslink verifizieren und einloggen.
Schritt 2: Turnstile-Widget anlegen
- Im Cloudflare-Dashboard unter Protect & Connect → Turnstile auf Add Widget klicken.
- Widget-Name frei wählen, die Domain(s) Ihres Shops als Hostname hinterlegen und als Widget-Modus Managed wählen.
- Nach dem Erstellen zeigt Cloudflare einen Site Key (öffentlich) und einen Secret Key (geheim) an. Beide Schlüssel sofort notieren – der Secret Key lässt sich später nur neu erzeugen, nicht erneut anzeigen.
Schritt 3: Schlüssel im Plugin eintragen
Im Backend unter Plugins → SALEPIX Formulare → Einstellungen im Bereich „Cloudflare Turnstile“ folgende Felder ausfüllen:
| Einstellung | Standard | Beschreibung |
|---|---|---|
| Site Key | leer | Öffentlicher Schlüssel aus dem Cloudflare-Dashboard |
| Secret Key | leer | Geheimer Schlüssel aus dem Cloudflare-Dashboard |
| Widget-Theme | Auto | Auswahl zwischen Auto (an Browser anpassen), Light und Dark |
Anschließend speichern.
Schritt 4: Turnstile in ein Formular einfügen
- Im Reiter Forms ein Formular öffnen.
- Im Builder (Unterreiter „Inhalt“) das Feld Cloudflare Turnstile aus der Palette in den Canvas ziehen.
- Formular speichern. Beim nächsten Aufruf der Seite erscheint das Turnstile-Widget im Formular.
Voraussetzungen am Server
Der Server muss ausgehende HTTPS-Verbindungen zu https://challenges.cloudflare.com zulassen.
Verhalten ohne Schlüssel
Sind Site Key oder Secret Key nicht hinterlegt, wird kein Turnstile-Widget angezeigt, auch wenn das Element im Formular liegt. Für die Angebotsanfrage gilt zusätzlich: Ist dort „Turnstile-Pflicht für Gäste“ aktiviert (Standard), aber kein Site Key oder Secret Key hinterlegt, werden Anfragen von Gästen abgelehnt. Tragen Sie deshalb zuerst die Schlüssel ein, bevor Sie das Element in ein Formular einfügen oder die Turnstile-Pflicht für Gäste bei der Angebotsanfrage nutzen.
Support
Bei Fragen erreichen Sie uns über das Kontaktformular auf salepix.de. Bitte nennen Sie die Plugin-Version und Ihre JTL-Shop-Version.
Frage nicht beantwortet?
Unser Support hilft Ihnen gerne weiter – bitte nennen Sie Plugin- bzw. Template-Version und Ihre JTL-Shop-Version.