Handbuch: CAPTCHAme für Shopware 6 | Einrichtung Schritt für Schritt

Schlüssel holen

Sie brauchen zwei Zeichenketten, beide kostenlos nach der Registrierung:

Sitekey: Öffentlich. Er steht im Quelltext jeder Seite mit Formular und darf dort stehen.
Secret: Geheim. Er verlässt Ihren Server nur bei der Prüfung und gehört nie in eine Seite, in ein Repository oder in eine E-Mail.

Wo es greift

Die Erweiterung meldet sich als reguläres Shopware-Captcha an. Einmal aktiviert, greift sie überall, wo der Shop ein Captcha vorsieht:

Registrierung
Kontaktformular
Newsletter-Anmeldung
Produktbewertungen

Einrichtung

ZIP unter Erweiterungen → Meine Erweiterungen → Erweiterung hochladen einspielen und aktivieren.
In der Konfiguration der Erweiterung Sitekey und Secret eintragen. Beides lässt sich je Verkaufskanal setzen; ohne eigene Angabe gilt der Wert aus der Grundkonfiguration.
Unter Einstellungen → Grundeinstellungen → Captcha den Eintrag CAPTCHAme aktivieren.

Schritt 3 nicht vergessen.

Ohne die Aktivierung in den Grundeinstellungen ist das Captcha zwar installiert, wird aber nirgends angezeigt.

Abstand um das Widget

Jedes Formular bringt eigene Abstände mit. Klebt das Widget am Absenden-Knopf oder steht es zu weit vom letzten Feld entfernt, lässt sich das in den Einstellungen ausgleichen: Abstand oben und Abstand unten, in Pixeln.

20 Pixel passen zu den meisten Formularen. 0 in beiden Feldern setzt gar keine Regel und überlässt den Abstand vollständig Ihrem Theme.

Erlaubte Domains

Im Dashboard lässt sich je Projekt festlegen, auf welchen Domains der Sitekey gilt. Das ist ein Schutz gegen fremde Nutzung Ihrer Schlüssel – und die häufigste Ursache, wenn das Widget schweigt.

Achten Sie auf www.

Ist nur beispiel.de eingetragen, Ihre Seite aber auch unter www.beispiel.de erreichbar, bekommt das Widget dort keine Aufgabe und erscheint nicht. Tragen Sie beide ein:

beispiel.de, *.beispiel.de

Ein leeres Feld erlaubt jede Domain.

Woran Sie erkennen, dass es läuft

Im Dashboard zeigt jedes Projekt zwei Haken:

Widget eingebaut – das Widget hat Aufgaben ausgeliefert.
Prüfung im Backend – Token werden serverseitig geprüft. Erst jetzt ist der Schutz vollständig; vorher könnte ein Bot am Formular vorbei absenden.

Der zweite Haken erscheint erst, wenn nach dem Einbau tatsächlich einmal abgesendet wurde. Senden Sie Ihr Formular also einmal testweise ab.

Sie sehen das Widget selbst nicht?

In der Vorgabe bekommen angemeldete Benutzer kein Captcha – sie sind bereits identifiziert. Schauen Sie im privaten Fenster nach, oder schalten Sie die Ausnahme in den Einstellungen ab.

Ob Sitekey und Domain zusammenpassen, beantwortet auch diese Adresse direkt:

https://captchame.de/api/v1/sitecheck?sitekey=IHR_SITEKEY&hostname=ihre-domain.de

Wenn der Dienst ausfällt

In der Vorgabe wird ein Formular abgelehnt, wenn CAPTCHAme nicht erreichbar ist. Lieber ein Besucher, der es noch einmal versucht, als eine Nacht offener Spam.

Wer das anders gewichtet, stellt in den Einstellungen auf Bei Störung durchlassen um. Dann gehen Formulare bei einer Störung ungeprüft durch.