ospo / module-myra-captcha
Myra EU-Captcha als weiterer Captcha-Typ neben Google reCAPTCHA für Mage-OS und Magento Open Source, mit Hyvä-Unterstützung
Package info
codeberg.org/OSPO/magento2-module-myra-captcha
Type:magento2-module
pkg:composer/ospo/module-myra-captcha
Requires
- php: ~8.3.0||~8.4.0
- magento/framework: *
- magento/module-re-captcha-admin-ui: *
- magento/module-re-captcha-frontend-ui: *
- magento/module-re-captcha-ui: *
- magento/module-re-captcha-validation: *
- magento/module-re-captcha-validation-api: *
- magento/module-store: *
Requires (Dev)
None
Suggests
- hyva-themes/magento2-default-theme: Das Widget wird über das ReCaptcha-ViewModel von Hyvä eingebunden
Provides
None
Conflicts
None
Replaces
None
README
Bindet das Myra EU-Captcha als weiteren Captcha-Typ in das Captcha-Framework von Mage-OS und Magento Open Source ein. Das Captcha wird in der EU betrieben und kommt ohne Google aus. Es lässt sich wie Google reCAPTCHA je Formular auswählen.
Was das Modul tut
- Neuer Typ „Myra EU-Captcha" in der Auswahlliste je Formular (
Shops->Konfiguration->Sicherheit->Google reCAPTCHA Storefront->Storefront). - Das Widget erscheint in den Hyvä-Formularen an derselben Stelle wie reCAPTCHA. Das Skript
https://cdn.eu-captcha.eu/verify.jswird nur auf Seiten geladen, die ein Formular mit Captcha enthalten. - Beim Absenden prüft der Shop das Token serverseitig bei
https://api.eu-captcha.eu/v1/verify. Ist die API nicht erreichbar, wird das Formular abgewiesen, außer „Anfragen annehmen, wenn der Dienst nicht erreichbar ist" steht auf „Ja". - Die nötigen CSP-Freigaben sind enthalten.
Technisch hängt sich das Modul mit zwei Plugins in das Framework: Es liest das Token aus dem Feld eu-captcha-response statt g-recaptcha-response und leitet die Prüfung an die Myra-API um, wenn das Formular auf Myra eingestellt ist. Google-Typen bleiben unverändert nutzbar.
Einrichtung
- Unter https://app.eu-captcha.eu/ einen Sitekey je Hostname anlegen. Ein Sitekey gilt nur für den Hostnamen, für den er angelegt wurde. Bei mehreren Websites mit eigenen Domains braucht jede Website ihren eigenen Schlüssel.
- Im Backend unter
Shops->Konfiguration->Sicherheit->Google reCAPTCHA Storefront->Myra EU-Captchaim Website-Bereich Sitekey und Secret eintragen. - In derselben Seite unter
Storefrontbei den gewünschten Formularen „Myra EU-Captcha" wählen. - Cache leeren.
| Pfad | Standard | Bedeutung |
|---|---|---|
recaptcha_frontend/type_myra_eu_captcha/public_key | leer | Sitekey, je Website |
recaptcha_frontend/type_myra_eu_captcha/private_key | leer | Secret, verschlüsselt gespeichert, je Website |
recaptcha_frontend/type_myra_eu_captcha/failsafe | 0 | Formulare durchlassen, wenn die Myra-API nicht antwortet |
Die Meldungen, die Kunden bei einer fehlgeschlagenen Prüfung sehen, sind für alle Captcha-Typen gemeinsam und stehen unter Storefront -> Fehlermeldungen (recaptcha_frontend/failure_messages/validation_failure_message und technical_failure_message). Sie sind ab Werk englisch und nennen reCAPTCHA, deshalb sollten sie je Store-Ansicht angepasst werden. Ein nicht gelöstes Captcha gilt als Prüffehler, eine nicht erreichbare Myra-API als technischer Fehler.
Solange kein Sitekey eingetragen ist, gilt das Captcha als nicht konfiguriert und Magento zeigt es nicht an.
Geeignete Formulare
Getestet mit Anmeldung, Registrierung, Passwort vergessen, Kontaktformular und Newsletter in Hyvä. Für Formulare im Luma-Checkout (Bestellung absenden, Gutschein) ist das Modul nicht gedacht, dort bleibt das Captcha aus. Formulare von Drittmodulen, die das Captcha-Framework nicht nutzen, werden nicht abgedeckt.
Installation
composer require ospo/module-myra-captcha
bin/magento module:enable Ospo_MyraCaptcha
bin/magento setup:upgrade
Im Production-Modus danach bin/magento setup:di:compile und bin/magento setup:static-content:deploy.
Lizenz: OSL-3.0, wie Magento Open Source und Mage-OS.