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

Version: 1.0.0
Kompatibilität: vBulletin 4.2.x · PHP 7.1
Autor: kerimcandan.com

————
Kurzbeschreibung
Dieses Add-on ersetzt das eingebaute Human-Verification-System (reCAPTCHA) von vBulletin durch Cloudflare Turnstile. Es ist die Fortsetzung meines 3.8-Guides – nun für vBulletin 4.2.x optimiert (getestet mit 4.2.5).

Kompatibilität

• vBulletin 4.2.x (getestet: 4.2.5)
• PHP 7.1 / 7.4 (Hinweis: vB 4.2.5 ist offiziell nicht für PHP 8.x freigegeben)

Voraussetzungen

• Cloudflare Turnstile Site Key und Secret Key
• Serverseitige Validierung aktiviert (Turnstile-Token wird beim Absenden serverseitig geprüft)
• Falls eine Content-Security-Policy (CSP) aktiv ist: challenges.cloudflare.com für Script und Frame zulassen
• Testweise Werbe-/Tracking-Blocker im Browser deaktivieren

Installation (kurz & klar)

1. Datei hochladen: Den PHP-Treiber nach /includes/class_humanverify_turnstile.php kopieren.
2. Produkt importieren: AdminCP → Plugins & Products → Add/Import Product → das Product-XML aus deinem ZIP importieren.
3. Konfigurieren: AdminCP → Settings → Human Verification Manager
   • Verification Type = Turnstile auswählen
   • Site Key / Secret Key eintragen
   • (Optional) Theme/Size nach Geschmack setzen
4. Caches erneuern: Ggf. Rebuild Styles und Browser-Hard-Refresh (Strg+F5).

Hinweise aus der Praxis

• Leeres Widget / „Image Verification“ ohne Inhalt:
  Meist blockiert die CSP oder ein Browser-Addon den Script/Frame-Load von challenges.cloudflare.com. Domain in der CSP freigeben und erneut testen.
• Verifizierung schlägt fehl:
  Das Turnstile-Widget wurde nicht geladen → es wird kein Token („cf-turnstile-response“) mitgesendet → serverseitige Prüfung kann nur fehlschlagen.
• PHP-Pool prüfen:
  Webserver/FastCGI wirklich auf PHP 7.1/7.4 für diese Domain stellen (kein 8.x-Pool).
• Themen/Styles:
  In seltenen Themes lädt das Widget zuverlässiger, wenn das Script explizit initialisiert wird. Das Add-on unterstützt beide Varianten.
  
  

Siehe auch

Cloudflare Turnstile – vBulletin 3.8.x Integration:
Cloudflare Turnstile Addon für vBulletin 3.8 (Human Verification)

Download

SHA-256: 8bed108a35559781a65c3a6f5f9397b36782c43f8f9c364efe31d89eafd9108b

Paketinhalt (ZIP):

• includes/class_humanverify_turnstile.php (hochladen FTP)
• product-turnstile_vb4_v2.xml (Import Admin Panel Product)