BotBlocker – Einrichtung

Diese Anleitung richtet sich Schritt für Schritt: von der Anlage des Turnstile-Widgets bei Cloudflare bis zum ersten erfolgreichen Test im Shop.

1. Turnstile-Widget bei Cloudflare anlegen

1. Bei dash.cloudflare.com anmelden.
2. In der linken Navigation Turnstile öffnen.
3. Widget hinzufügen wählen.
4. Einen Namen vergeben (frei wählbar).
5. Bei Hostname die Domain Ihres Shops eintragen. Betreiben Sie den Shop auch unter der www-Subdomain, tragen Sie beide Varianten ein.
6. Als Widget-Modus „Verwaltet“ (Managed) wählen und speichern.

Cloudflare zeigt danach einen öffentlichen Site Key (beginnt mit 0x4AAAAAA…) und einen geheimen Secret Key.

2. Schlüssel im Plugin hinterlegen

Unter Plugins → SALEPIX BotBlocker → Einstellungen:

1. „Cloudflare Turnstile: Site Key“ einfügen.
2. „Cloudflare Turnstile: Secret Key“ einfügen.
3. „Cloudflare Turnstile statt Blockierung“ auf „Ja – Turnstile anzeigen (empfohlen)“ stellen.
4. Speichern.

Hinterlegen Sie beide Schlüssel, bevor Sie das Plugin scharf schalten. Ohne Schlüssel blockiert das Plugin jeden Treffer direkt mit HTTP 429 – auch gegenüber Suchmaschinen. Mehr dazu im Artikel „BotBlocker – Suchmaschinen und Störungen“.

3. Geschützte Seitentypen prüfen

Ab Werk sind Startseite, Kategorie/Artikelliste und Artikel/Detailseite geschützt. Öffnen Sie zusätzlich den Abschnitt „Geschützte Seitentypen“ in den Einstellungen und ergänzen Sie bei Bedarf die Fehlerseite (404) – Filterkombinationen, die auf keine Kategorie mehr auflösen, landen dort und werden ohne diese Auswahl nicht geprüft. Details dazu im Artikel „BotBlocker – Einstellungen“.

4. Prüfen, ob es funktioniert

Öffnen Sie in einem privaten Browserfenster eine Kategorieseite und setzen Sie einen Merkmal-Filter (z. B. Farbe oder Größe). Die URL enthält danach „__“. Sie sollten jetzt die Turnstile-Zwischenseite mit Ihrem Shop-Logo sehen; nach der Bestätigung landen Sie auf der gefilterten Seite.

Erscheint stattdessen „429“ oder „403“, sind die Schlüssel nicht oder nicht korrekt hinterlegt, oder „Cloudflare Turnstile statt Blockierung“ steht auf „Nein“.

Erscheint die Zwischenseite gar nicht, obwohl Sie gefiltert haben, prüfen Sie:

• ob Sie tatsächlich einen Merkmal-Filter gesetzt haben (nur dieser erzeugt „__“ in der Adresse),
• ob die Artikelliste unter „Geschützte Seitentypen“ ausgewählt ist,
• ob das Feld „URL-Pattern“ gefüllt ist.