reCAPTCHA- & hCaptcha-Schutz: Einrichtung und Hilfe

Das Modul kann Google reCAPTCHA v2-, reCAPTCHA v3- oder hCaptcha-Widgets darstellen. Testen Sie jedes ausgewählte Formular mit einem gültigen, einem fehlenden und einem ungültigen Token: Ein sichtbares Widget allein bedeutet nicht, dass die Formularverarbeitung Übermittlungen ohne gültiges Token ablehnt.

Bei ausgewählten nativen Anmelde-, Registrierungs- und Newsletter-Formularen verhindern fehlende oder ungültige CAPTCHA-Antworten das Absenden. Bei ausgeschaltetem CAPTCHA-Schutz bleibt die native Registrierung verfügbar.

1. Laden Sie das mprrecaptcha-ZIP über Modul > "Module Manager" hoch und installieren Sie es.
2. Klicken Sie auf "Configure", um CAPTCHA-Einstellungen zu öffnen.
3. Wählen Sie "CAPTCHA Provider".
4. Beschaffen Sie die passenden Anbieterschlüssel für Ihre Shop-Domain. Fügen Sie Website-Schlüssel und Geheimer Schlüssel ein.
5. Wählen Sie die Formulare unter "Protect Forms".
6. Aktivieren Sie "Enable CAPTCHA Protection" und klicken Sie auf Speichern.
7. Testen Sie gültige, fehlende und ungültige Tokens bei jedem ausgewählten Formular. Prüfen Sie, ob fehlgeschlagene Prüfungen den zugrunde liegenden Vorgang verhindern.

Der CAPTCHA-Schalter ist anfangs ausgeschaltet. Darstellung und Prüfung bleiben inaktiv, solange nicht beide Hauptschlüssel vorhanden sind. Felder für geheime Schlüssel werden im Einstellungsformular maskiert. Sie benötigen PHP cURL und eine HTTPS-Verbindung von Ihrem Server zum Prüfendpunkt des Anbieters.

Wählen Sie beispielsweise v3, wählen Sie "Contact form", "Customer registration" und "Newsletter subscription" und setzen Sie den Schwellenwert auf 0.6. Diese Einstellungen wenden den v3-Schutz auf die ausgewählten Formulare an.

Wählen Sie für einen v3-Fallback-Test v3, verwenden Sie einen strengeren Schwellenwert wie 0.7, tragen Sie beide v2-Fallback-Schlüssel ein und aktivieren Sie den Fallback-Schalter. Nach einer niedrigen Bewertung speichert das Modul eine ausstehende Abfrage für das Formular. Der nächste Versuch verwendet das v2-Kontrollkästchen. Ein erfolgreicher Fallback löscht diesen ausstehenden Zustand.

Das Modul wird über diese Formular-Hooks dargestellt, soweit Ihr Theme sie aufruft:

{hook h='displayContactContent'}
{hook h='displayCustomerLoginFormAfter'}
{hook h='displayCustomerAccountForm'}
{hook h='displayNewsletterRegistration'}

Es verwendet außerdem displayGDPRConsent für die entsprechende Kontaktplatzierung und einen Footer-Injector für erkennbare Standardformulare. Beispiele sind #login-form, #customer-form, .block_newsletter form und Steuerelemente namens submitMessage, submitLogin oder submitAccount.

Belassen Sie das Widget innerhalb des Formulars. Ein zusätzlicher Anzeige-Hook fügt nur ein Widget hinzu. Sie benötigen weiterhin eine funktionierende Anbindung an die Servervalidierung.

Sie können .mprrecaptcha-widget, .mprrecaptcha-contact, .mprrecaptcha-registration, .mprrecaptcha-newsletter und .mprrecaptcha-login im Theme-CSS ansprechen.

Anbieterskripte verwenden:

https://www.google.com/recaptcha/api.js
https://www.google.com/recaptcha/api.js?render=YOUR_SITE_KEY
https://js.hcaptcha.com/1/api.js

Google-Antworten verwenden g-recaptcha-response. hCaptcha verwendet h-captcha-response. Der v3-Fallback fügt mprcaptcha_v2_fallback=1 hinzu.

Das native Kontaktformular wird vor dem Absenden geprüft. Eine fehlgeschlagene CAPTCHA-Antwort verhindert den Nachrichtenversand.

Die Kontaktanbindung prüft außerdem submitMessage auf dem nativen Kontakt-Controller während actionFrontControllerSetMedia. Schlägt die Validierung fehl, setzt sie das Honeypot-Feld des Kontaktformulars. Testen Sie diesen Pfad mit Ihrem installierten Kontaktmodul.

Für jedes ausgewählte Formular:

1. Senden Sie gültige Daten mit einer gültigen Abfrage und prüfen Sie den Erfolg.
2. Senden Sie ohne Token und prüfen Sie, dass keine Nachricht, Anmeldung, kein Konto und kein Abonnement erstellt wird.
3. Wiederholen Sie dies mit einem ungültigen Token.
4. Testen Sie die Platzierung auf Mobilgeräten und Desktop.
5. Wenn Sie den v3-Fallback verwenden, testen Sie den fehlgeschlagenen ersten Versuch und die erfolgreiche Wiederholung mit Kontrollkästchen.

Sind ungültige Übermittlungen erfolgreich, muss die Formularverarbeitung angebunden werden. Ein Anbieterwechsel oder ein zusätzliches Widget behebt dies nicht.

Es gibt keine fertigen Einstellungen für Kasse, Passwortzurücksetzung, Bewertungen oder beliebige Drittanbieterformulare. Entwickler können renderForForm($formId) und verifyForForm($formId, $token, $ip) für eine eigene Anbindung verwenden. Verwenden Sie eine stabile Formular-ID, die nur Buchstaben, Ziffern, Unterstriche oder Bindestriche enthält. Die Formularverarbeitung muss den Vorgang ablehnen, wenn die Prüfung false zurückgibt. Die Prüfung gibt true zurück, solange der Modulschutz inaktiv ist.

Fehlt ein Widget, prüfen Sie Schlüssel, Aktivierungszustand, ausgewählte Formulare, Anzeige-Hooks, Selektoren und Anbieteranfragen. Scheitern echte Benutzer an v3, prüfen Sie Schwellenwert und Anbieterantwort. Scheitert die Prüfung bei allen, prüfen Sie Domain/Schlüsseltyp und den HTTPS-/cURL-Zugriff des Servers. Verwenden Sie die Modulseite "Integrity" für Installationsprüfungen.

Deaktivieren Sie "Enable CAPTCHA Protection" und speichern Sie, um CAPTCHA-Darstellung und -Validierung des Moduls zu stoppen. Deinstallieren Sie es im "Module Manager", um Menü und gespeicherte Einstellungen zu entfernen.

Erfordert PrestaShop 1.6 oder höher und PHP 7.1 oder höher.