**Hinweis:** Falls Sie eine andere PrestaShop Version nutzen, können die Screenshots lt. dieser Dokumentation abweichen.
# Installation Es ist wichtig, vor der Installation eines Moduls eine vollständige Sicherung Ihrer Website oder Ihres Servers durchzuführen, um Datenverluste zu vermeiden, falls etwas schiefgeht. Wenn Sie unsicher sind oder Bedenken haben, ziehen Sie die Hilfe eines erfahrenen Webentwicklers oder Administrators in Betracht. 1. Gehen Sie im PrestaShop Backoffice zur Modulverwaltung (ehemals Modul-Manager) und klicken Sie auf „Modul hochladen“ 2. Ziehen Sie nun die Moduldatei (zip-Datei) per Drag & Drop oder wählen Sie die Datei im System-Verzeichnisbaum aus 3. Wählen Sie die hochzuladende ZIP-Datei aus und klicken Sie auf "OK" 4. Ihr Modul wird installiert und erscheint in der Liste der installierten Module 5. Warten Sie bis die Modulinstallation erfolgreich abgeschlossen ist 6. Um mit der Einrichtung zu beginnen, klicken Sie auf "Konfigurieren". Wenn Sie mehrere Shops haben, müssen Sie jeden Shop separat konfigurieren. Bitte wählen Sie Ihren Shop direkt aus dem Menü aus, mit dem Sie beginnen möchten 7. Testen Sie das Modul: Gehen Sie zur Frontend-Ansicht Ihrer Website und überprüfen Sie, ob das Modul wie erwartet funktioniert #### Viel Erfolg! # Übersetzungen ##### **Übersetzungen in anderen Sprachen** Das Modul kann in alle verfügbaren Sprachen übersetzt werden. Standardmäßig sind Deutsch und Englisch enthalten. Um eine Übersetzung vorzunehmen, gehen Sie im Menü links auf **„International“ (1)** und anschließend auf **„Übersetzungen“ (2).** Wählen Sie im Bereich *„Programmteil“* die Option **„Installierte Module“** **(3),** anschließend das **gewünschte Modul (4)** und die **gewünschte Sprache (5).** Klicken Sie danach auf *„Bearbeiten“*, um die Übersetzung anzupassen.***Screenshot "Modul Übersetzungen bearbeiten"***
[](https://docs.onlineshop-module.de/uploads/images/gallery/2026-02/Fqegrafik.png)**Screenshot "Einzelne Felder übersetzen"**
[](https://docs.onlineshop-module.de/uploads/images/gallery/2026-02/rPwgrafik.png) # Lizenz - Das Modul unterliegt einer kommerziellen Lizenz. Sie dürfen das Modul auf einer Domain installieren. - Zu Test- und Debugzwecken ist keine weitere Lizenz notwendig. - Nach Bestellung können Sie die Domain lizenzieren, unter der das Modul verwendet wird. - In Ihrem Kundenkonto können Sie Ihre Lizenzen unter dem Link "Meine Lizenzen" verwalten. # Downloads **Aktuelle Modul-Downloads** [Captcha PrestaShop 9.x](https://www.onlineshop-module.de/captcha-prestashop-9.html) [Captcha PrestaShop 8.x](https://www.onlineshop-module.de/captcha-prestashop-8.html)**Hinweis** Bitte beachten Sie, dass diese Dokumentation eine Momentaufnahme darstellt und sich von älteren oder zukünftigen Versionen unterscheiden kann. Wir sind darum bemüht, unsere Dokumentation aktuell zu halten. Bei Rückfragen oder Unsicherheiten stehen wir Ihnen jederzeit gerne zur Verfügung.
> Falls Sie Unterstützung bei der Optimierung Ihres PrestaShop-Shops benötigen, zögern Sie nicht, Gurkcity zu kontaktieren. Unser [Support-Team](https://www.gurkcity.de/kontakt.php) steht Ihnen nicht nur bei der Modulinstallation zur Seite, sondern bietet Ihnen auch umfassende Dienstleistungen als [PrestaShop Full-Service-Agentur](https://www.gurkcity.de/) an. # Konfiguration Ist die Modulinstallation erfolgreich abgeschlossen, ist die richtige Konfiguration entscheidend. Im Allgemeinen sind die Module intuitiv zu bedienen. Sollten Sie einmal nicht weiterkommen, kontaktieren Sie gerne unseren kostenlosen Support im Rahmen des Modulkaufs. # Einstellungen Im Tab **"*Konfiguration"*** werden die grundlegenden Funktionen des Moduls verwaltet. Hier kann festgelegt werden, für welche Formulare das Captcha aktiviert werden soll. Zusätzlich stehen erweiterte Optionen zur Verfügung, um das Ladeverhalten zu optimieren und die Integration individuell an Ihr Template anzupassen. [](https://docs.onlineshop-module.de/uploads/images/gallery/2026-04/7Nrgrafik.png) **Formular auswählen** Legt fest, in welchen Shop-Formularen das Captcha angezeigt wird (z. B. Registrierung, Bestellung, Kundenlogin, Newsletter, Kontaktformular oder Passwort-vergessen). **Darstellung OHNE Captcha-Modul im PrestaShop Standard für das Formular Registrierung** [](https://docs.onlineshop-module.de/uploads/images/gallery/2026-04/h0zgrafik.png) **Darstellung MIT Captcha-Modul und Auswahl Mathe-Captcha für das Formular Registrierung** [](https://docs.onlineshop-module.de/uploads/images/gallery/2026-04/QVpgrafik.png) --- **Captcha für angemeldete Kunden deaktivieren** Deaktiviert das Captcha automatisch für bereits eingeloggte Kunden. --- **Captcha-Typen** **Zur Auswahl stehen verschiedene Captcha-Arten** **BILD CAPTCHA** - grafische Eingabeprüfung mit zufälligen Zeichen Erzeugt bei jedem Seitenaufruf ein zufälliges Bild mit einer Zeichenfolge, die vom Nutzer manuell eingegeben werden muss. Die Überprüfung erfolgt serverseitig, um zu bestätigen, dass die Eingabe von einem Menschen stammt. Schützt Formulare zuverlässig vor automatisierten Bots und Spam-Einträgen. Durch die Möglichkeit, bestimmte Zeichen auszuschließen, lässt sich die Lesbarkeit verbessern und Verwechslungsgefahr (z. B. zwischen „O“ und „0“) vermeiden. [](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/ofsgrafik.png) **MATHE CAPTCHA** - einfache Rechenaufgabe zur Verifizierung Erzeugt eine einfache Rechenaufgabe (z. B. „3 + 5 = ?“), die der Nutzer lösen und in das Eingabefeld eintragen muss. Der verwendete mathematische Operator (Addition, Subtraktion, Multiplikation usw.) kann individuell konfiguriert werden. Optional kann die Aufgabe zusätzlich grafisch visualisiert werden, um automatisierte Erkennungen zu erschweren. Bietet eine benutzerfreundliche und barrierearme Captcha-Variante, die auf logisches Denken statt Bilderkennung setzt. Durch anpassbare Operatoren und optionale Visualisierung lässt sich das Sicherheitsniveau flexibel an die Anforderungen des Shops anpassen. [](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/lTGgrafik.png) **CLOUDFLARE TURNSTILE**- interaktionsfreie Captcha-Lösung (Cloudflare-Dienst) Cloudflare Turnstile ist ein datenschutzfreundlicher Captcha-Dienst, der Benutzerinteraktionen analysiert, um automatisierte Anfragen zuverlässig zu erkennen – ohne den Einsatz klassischer Bilderrätsel. Für die Integration im Shop werden zwei Schlüssel benötigt: - - - **Turnstile Site-Key** – öffentlicher Schlüssel für die Einbindung des Captchas auf der Shopseite - **Turnstile Secret Key** – privater Schlüssel für die serverseitige Verifizierung der Captcha-Antworten *Bietet eine moderne, DSGVO-konforme und nutzerfreundliche Alternative zu klassischen Captcha-Systemen.* Die Integration sorgt für eine reibungslose Prüfung im Hintergrund, reduziert Nutzerbarrieren und erhöht gleichzeitig die Sicherheit gegen automatisierte Bot-Angriffe. [](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/OO1grafik.png)**Tipp:** DSGVO sicherer sind Mathe- und Bild-Captcha, da sie keinerlei personenbezogene Daten weitergeben.
Der Punkt "Cloudflare Turnstile" muss Bestandteil Ihrer Datenschutzerklärung sein! Rechtliche Hinweise dazu finden Sie hier: https://www.e-recht24.de/dsg/13110-cloudflare-turnstile.html
**Hinweis**: Diese Information stellt keine juristische Beratung dar. Wir bieten technische Lösungen und Hintergrundwissen; für verbindliche rechtliche Einschätzungen sollte ein Rechtsanwalt konsultiert werden.
****Erweiterte Einstellungen**** Ermöglichen die individuelle Platzierung des Captchas innerhalb der Formulare über CSS-Selektoren. --- **JavaScript als "deferred" laden** Lädt die JavaScript-Dateien des Captchas mit dem `defer`-Attribut, sodass sie erst nach dem Laden des HTML-Dokuments ausgeführt werden. # Logs Im Tab **"*Logs"*** werden die vom Modul erstellten Protokolldateien verwaltet. Diese dienen zur Fehlerdiagnose, zur Nachverfolgung technischer Abläufe und zur Unterstützung bei Wartungsarbeiten. [](https://docs.onlineshop-module.de/uploads/images/gallery/2025-10/Fyhgrafik.png) **Vorhandene Logs** Alle vom Modul erzeugten Logdateien werden mit Name, Erstellungsdatum und Größe angezeigt und können direkt gelöscht werden, um Speicherplatz freizugeben und die Übersicht zu behalten. --- **Log-Einstellungen** Das Log-Level kann flexibel von Warnungen bis Debug definiert werden, sodass der Detaillierungsgrad der Protokollierung optimal an Support- und Analysezwecke angepasst werden kann. # Wartung Der Tab **"*Wartung"*** bietet Shopbetreibern eine Übersicht über die technische Integrität des Moduls. Er hilft dabei, mögliche Fehlerquellen zu identifizieren und fehlerhafte Installationen von Hooks, Menüeinträgen, Datenbankstrukturen oder Templates schnell zu beheben. [](https://docs.onlineshop-module.de/uploads/images/gallery/2025-11/6Sggrafik.png) - **Hooks:** Listet alle vom Modul verwendeten Hooks; nicht eingetragene Hooks können nachinstalliert werden. - **Menüeinträge:** Zeigt alle Backend-Menüeinträge mit den zugehörigen Berechtigungen. - **Datenbank:** Prüft das SQL-Schema und signalisiert Abweichungen von der aktuellen Datenbankstruktur. - **Einstellungen:** Zeigt die Konfigurationswerte des Moduls an, einschließlich der Möglichkeit, fehlerhafte Werte zurückzusetzen oder fehlende Konfigurationen zu installieren. - **Controller:** Listet erforderliche Backend- und Frontend-Controller; fehlende Controller können nachinstalliert werden. - **Bestellstatus:** Prüft spezielle vom Modul angelegte Bestellstatus und ermöglicht deren Installation. - **Templates:** Überprüft die Front-Office-Templates auf korrekte Installation oder Überschreibungen im Theme. - **Plugins:** Zeigt verfügbare Zusatzplugins für das Modul an. - **Erweiterte Optionen:** Zeigt die installierten Versionen und ermöglicht Änderungen, z. B. des Lizenzschlüssels.Diese Übersicht dient der **zentralen Verwaltung, Kontrolle und Aktualisierung aller für das Modul relevanten Komponenten** im Shop.