Cloudflare Turnstile Addon für vBulletin 3.8 (Human Verification)

Last updated on 1. Oktober 2025

Version: 1.0.0
Kompatibilität: vBulletin 3.8.x · PHP 5.6
Autor: kerimcandan.com

Kurzbeschreibung

Dieses Addon ersetzt Google reCAPTCHA im vBulletin-eigenen Human-Verification-System durch Cloudflare Turnstile. Dadurch erscheinen die Challenges automatisch überall dort, wo vBulletin HV nutzt, z. B. Neues Thema, Antworten/Quick Reply, Kontaktformular, Private Nachrichten und ggf. Registrierung (abhängig von Board-Einstellungen).
Eine Admin-Testseite ist enthalten.

---

Download

• Addon-ZIP (PHP-Treiber + README):
  

SHA-256: a3c10123ea7c23a4fcad3fa1ff035693fcb856930ab8b1d3b407920f0bdb4a0a

Produkt-XML (entpacken separat importieren):

SHA-256: 8CDB6768D2AB62F9F167A2A853A7796EA273C3EB1B838ACA2A644129158595F7

Paketinhalt (ZIP):

• includes/class_humanverify_turnstile.php (Treiber)
• README_DE.md (deutsche Anleitung)

Hinweis: Die Produkt-XML wird aus WordPress-Gründen als eigenes ZIP bereitgestellt. Bitte das ZIP entpacken und product-turnstile_vb3.xml im AdminCP importieren.

Voraussetzungen

• vBulletin min. 3.8.x
• PHP 5.6
• Cloudflare Turnstile Site Key & Secret Key
• Erreichbarkeit von https://challenges.cloudflare.com (Ad-Blocker/Privacy-Tools können blockieren)
• Externe Skripte nur über HTTPS einbinden (Mixed-Content vermeiden; ggf. alte jQuery-URLs anpassen)

---

Installation (Schritt für Schritt)

• Datei hochladen
  Lade class_humanverify_turnstile.php nach:

/includes/

• Produkt importieren (AdminCP)
  AdminCP → Plugins & Products → Manage Products → Add/Import Product → Datei product-turnstile_vb3.xml auswählen → Import.

• Einstellungen setzen (AdminCP)
  AdminCP → Settings → Human Verification Manager

• Verification Type (hv_type): Turnstile
• Turnstile Site Key: DEIN_SITEKEY
• Turnstile Secret Key: DEIN_SECRET
• Optional: Theme (light/dark) & Size (normal/compact)

Funktionstest (AdminCP)
Rufe im AdminCP die Testseite auf:

verify.php?do=turnstile_vb3_test_display

1. → Widget erscheint, mit Verify prüfen.
2. Styles/Cache aktualisieren
   AdminCP → Rebuild/Refresh Styles und Browser-Cache (Strg+F5) leeren.

Hinweis zu Alt-Anpassungen: Hast du zuvor manuell Turnstile in Templates oder newthread.php eingebaut, entferne diese Snippets, damit nicht doppelt geprüft wird.

---

Cloudflare Turnstile: Site Key & Secret Key beschaffen

1. Im Cloudflare-Dashboard Turnstile öffnen und eine Anwendung anlegen.
2. Domain Restrictions: Deine Domain(s) (Ihre-url.de, ggf. www.ihre-url.de) erlauben.
3. Site Key und Secret Key notieren und im AdminCP (Human Verification Manager) eintragen.
4. Optional: Theme/Size nach Wunsch konfigurieren.

---

Screenshots (Platzhalter)

Admin-Testseite:

Beispiel im Forum (Neues Thema):

Kontakt/PM/Antwort:

---

Cloudflare Turnstile – vBulletin 4.2.x Integration:
Cloudflare Turnstile für vBulletin 4.2.x (PHP 7.1/7.4)

Troubleshooting

• Widget wird nicht angezeigt:
  • Prüfe, ob https://challenges.cloudflare.com/turnstile/v0/api.js geladen wird (Ad-Blocker/Privacy-Addons temporär deaktivieren).
  • Mixed-Content vermeiden (alle externen Skripte via HTTPS).
  • Domain in Turnstile freigegeben (Domain Restrictions).
• Verifizierung schlägt fehl:
  • Secret Key korrekt? Serverseitig Zugriff auf Cloudflare-API (cURL/Streams) möglich?
  • Admin-Testseite nutzen: verify.php?do=turnstile_vb3_test_display.
• Doppelte Captchas / zwei Prüfungen:
  • Alte manuelle Captcha-Snippets (Templates/Custom-Hooks/newthread.php) entfernen.
• Nur Admin-Testseite funktioniert nicht, Frontend schon:
  • Plugin erneut speichern; Cache/Styles aktualisieren. (Die mitgelieferte Testseite rendert ihr eigenes HTML und ist unabhängig von Frontend-Templates.)

---

Deinstallation / Rückbau

• AdminCP → Manage Products → Produkt Cloudflare Turnstile → Uninstall.
• Falls du noch manuelle Snippets hast, diese ebenfalls entfernen.

---

Changelog

1.0.0 (16.09.2025)

• Erste Veröffentlichung (Treiber + Admin-Testseite + Einstellungen + Template/Phasen)

---

Lizenz & Haftung

Bereitgestellt „as is“, Nutzung auf eigene Verantwortung. © 2025 kerimcandan.com