Einfacher & Eleganter Checkout (dfsimplecheckout) — Vollständige Anleitung
One-Page-Checkout installieren, konfigurieren und betreiben: Farben, Logo, ablenkungsfreier Modus, Google- und Facebook-Login, Google Places, länderbewusstes Adressformular, AJAX-Rabattcode und Fehlerbehebung für PrestaShop 8 und 9.
Überblick
DataFirefly Simple Checkout ersetzt den nativen 5-Schritte-Checkout von PrestaShop durch einen modernen One-Page-Kaufprozess, inspiriert von den Checkouts von Shopify und Stripe. Das Modul mountet seinen Controller zur Laufzeit über den Hook actionDispatcher — es wird keine Override-Datei auf die Festplatte geschrieben, und bestehende Drittanbieter-Overrides auf OrderController werden sauber geerbt.
Hauptfunktionen: zweispaltiges Layout mit permanenter Bestellübersicht, Social Login mit Google und Facebook, Adress-Autovervollständigung mit Google Places, länderbewusstes Adressformular, AJAX-Rabattcode, fünf konfigurierbare Farben, ablenkungsfreier Modus.



Installation
- Gehen Sie in Ihrem PrestaShop-Back-Office zu Module → Modul-Manager → Modul hochladen.
- Wählen Sie die von Ihrem DataFirefly-Konto heruntergeladene Datei
dfsimplecheckout-1.3.3.zip. - Klicken Sie auf Installieren und dann auf Konfigurieren.
- Leeren Sie den PrestaShop-Cache (Erweiterte Einstellungen → Leistung → Cache leeren).
- Besuchen Sie die Seite
/orderIhres Shops mit einem Produkt im Warenkorb: Der neue Checkout wird sofort angezeigt.
Das Modul ist kompatibel mit PrestaShop 8.0 → 9.x. Keine Theme-Änderung erforderlich. Die Deinstallation stellt automatisch den nativen Checkout wieder her.
Neu in Version 1.3.3 (16.11.2026): neue Option „Kunde muss die Versandart bestätigen“. Ist sie aktiviert, bleibt der Versandschritt geöffnet, bis der Kunde seinen Versanddienstleister selbst bestätigt, statt dass der vorausgewählte automatisch bestätigt wird. Sie ist standardmäßig deaktiviert: Der Checkout ändert sich erst, wenn Sie sie aktivieren. Aktualisierung: Installieren Sie das neue ZIP über Version 1.3.2, Ihre Einstellungen bleiben erhalten.
Neu in Version 1.3.2 (05.11.2026): Das integrierte Kartenformular von Mollie (Mollie Components) bezahlt direkt im Checkout, ohne Weiterleitung zur Zahlungsseite von Mollie; „Karte speichern“ und „Gespeicherte Karte verwenden“ werden übermittelt. Update: Installieren Sie das neue Zip über Version 1.3.1, Ihre Einstellungen bleiben erhalten.
Neu in Version 1.3.1 (30.10.2026): Mit einem Abholpunkt-Versanddienst (Colissimo Abholpunkte…) bleibt der Versandschritt offen und die Zahlung gesperrt, solange kein Abholpunkt gewählt ist; der Express-Checkout-Block von Mollie (Apple Pay, Google Pay, PayPal) erscheint oben im Zahlungsschritt; zwei neue Farben (Checkout-Hintergrund, Block-Hintergrund); Aufpreis der Geschenkverpackung neben dem Kästchen; Abstände bei individuellen Themes korrigiert (Kontrollkästchen, Schritt-Titel, Button zur Abholpunktwahl). Update: Neues ZIP über die 1.3.0 installieren, Ihre Einstellungen bleiben erhalten.
Neu in Version 1.3.0 (29.10.2026): Kompatibilität mit PrestaShop 9.1 (der Checkout wurde nicht mehr angezeigt), Gutscheincodes werden unter PrestaShop 9 wieder eingelöst, Feld Bundesstaat/Provinz für die USA, Spanien, Italien, Kanada…, eingegebene Daten bleiben beim Länderwechsel erhalten, Schutz vor Doppelklicks auf „Zahlungspflichtig bestellen“, Zahlbetrag wird nach einem Gutscheincode aktualisiert, klare Meldungen bei Verbindungsabbruch oder abgelaufener Sitzung, Geschenkverpackung bleibt erhalten, Oberfläche in 8 Sprachen (FR, EN, ES, DE, IT, PT, PL, NL). Geprüft mit PrestaShop 8.2.1 (Theme Classic) und 9.1.5 (Theme Hummingbird). Update: Neues ZIP über das alte installieren, Ihre Einstellungen bleiben erhalten.
Allgemeine Konfiguration
Farben
Fünf Farben sind in den Moduleinstellungen konfigurierbar:
- Primärfarbe — Buttons, Links, aktive Zustände, ausgewählte Radios (Standard
#1a73e8). - Button-Hover-Farbe — Hover-Zustand der Primär-Buttons „Weiter“, „Bestellen“ (Standard
#1559b8). - Akzent-/Erfolgsfarbe — Indikatoren abgeschlossener Schritte, Pill des angewendeten Rabattcodes, „Gratis“-Label des Versanddienstleisters, Erfolgsmeldungen (Standard
#008060). - Hintergrundfarbe des Bestellvorgangs — Seitenhintergrund hinter den Schritten und der Übersicht (Standard
#fafbfb, sehr helles Grau). Sie deckt die gesamte Seitenbreite ab, einschließlich des Theme-Containers. - Hintergrundfarbe der Blöcke — Hintergrund der Schrittblöcke, der Bestellübersicht und der Kopfleiste (Standard
#ffffff, weiß).
Alle fünf Werte werden als CSS-Variablen injiziert (--dfsc-primary, --dfsc-primary-hover, --dfsc-success, --dfsc-page-bg, --dfsc-bg) und per striktem Hexadezimal-Regex validiert: Ein ungültiger Wert wird durch die Standardfarbe ersetzt.
Logo
Geben Sie die URL eines benutzerdefinierten Logos für den Checkout-Header an; andernfalls wird das Shop-Logo verwendet. Gerenderte Größe: maximal 190×42 px.
Ablenkungsfreier Modus
Die Option Header und Footer des Themes ausblenden (standardmäßig aktiviert) entfernt den kompletten Header des Themes (Menü, Suche, Warenkorb) und dessen Footer nur auf der Seite /order. Die Implementierung überschreibt die Smarty-Blöcke header und footer in unserem Template: Bei einem Theme, das diese Standardblöcke nicht verwendet, hat die Option schlicht keine Wirkung — niemals eine leere Seite.
Bestätigung der Versandart
Standardmäßig bestätigt der Checkout den von PrestaShop vorausgewählten Versanddienstleister automatisch: Der Versandschritt erscheint als erledigt und zugeklappt, und der Kunde landet direkt bei der Zahlung. Wenn die Wahl des Versanddienstleisters für Ihre Kunden wichtig ist (Abholung im Geschäft, Expressversand, Abholstation…), aktivieren Sie die Option Kunde muss die Versandart bestätigen (ab Version 1.3.3):
- Der Versandschritt bleibt mit der Liste der Versanddienstleister geöffnet, der vorausgewählte bleibt markiert.
- Der Zahlungsschritt bleibt gesperrt, bis der Kunde auf „Weiter zur Zahlung“ klickt.
- Die Wahl bleibt danach für diesen Warenkorb erhalten, auch beim Neuladen der Seite; ein neuer Warenkorb fragt erneut.
- Warenkörbe mit ausschließlich virtuellen Produkten haben keinen Versandschritt und sind nicht betroffen.
Die Option ist standardmäßig deaktiviert, bei der Installation wie bei der Aktualisierung.
Weitere Optionen
- Feld für Kundennotiz an den Verkäufer (ein/aus)
- Rabattcode-Feld (ein/aus)
- Geschenkverpackung: Ist die Option in PrestaShop aktiviert, erscheint der Aufpreis neben dem Kästchen (inkl. oder zzgl. MwSt. je nach Shop) und die Zeile „Geschenkverpackung“ in der Übersicht
- Vertrauensabzeichen — freies HTML unter der Übersicht
- Rechtliche Links im Checkout-Footer (AGB, Datenschutz, Widerruf — erkannt über die nativen CMS-Rollen)

Social Login Google
Anmeldedaten erstellen
- Gehen Sie zur Google Cloud Console und erstellen (oder wählen) Sie ein Projekt.
- Erstellen Sie unter APIs & Services → Credentials eine OAuth client ID vom Typ Web application.
- Fügen Sie unter Authorized JavaScript origins die URL Ihres Shops hinzu (z. B.
https://www.meinshop.de) — ohne Pfad, mit https-Protokoll. - Kopieren Sie die generierte Client ID (endet auf
.apps.googleusercontent.com).
Modul konfigurieren
- Aktivieren Sie in den Moduleinstellungen Google Sign-In und fügen Sie die Client ID ein.
- Speichern, dann Cache leeren.
- Auf
/ordererscheint der Google-Button oberhalb der Tabs „Ich bin Neukunde / Ich habe bereits ein Konto“.
Der Ablauf: Der Kunde klickt, wählt sein Google-Konto, und das Modul erhält ein JWT, das serverseitig über den offiziellen Endpoint tokeninfo validiert wird (Prüfung von Audience, Aussteller, Ablauf und verifizierter E-Mail). Existiert bereits ein Kundenkonto mit dieser E-Mail, wird der Kunde angemeldet; andernfalls wird automatisch ein Konto mit Vor- und Nachnamen des Google-Profils erstellt.
Social Login Facebook
App erstellen
- Erstellen Sie auf Meta for Developers eine App vom Typ Consumer.
- Fügen Sie das Produkt Facebook Login hinzu und deklarieren Sie Ihre Domain in den Einstellungen.
- Holen Sie sich App ID und App Secret unter Settings → Basic.
Modul konfigurieren
Aktivieren Sie Facebook Login in den Einstellungen, fügen Sie App ID und App Secret ein, speichern. Die serverseitige Validierung erfolgt in zwei Schritten: debug_token (verifiziert, dass das Token zu Ihrer App gehört) gefolgt vom Profilabruf mit appsecret_proof-Signatur (HMAC-SHA256). Das App Secret verlässt Ihren Server nie.
Adress-Autovervollständigung Google Places
- Aktivieren Sie in der Google Cloud Console die APIs Places API und Maps JavaScript API.
- Erstellen Sie einen API-Schlüssel und beschränken Sie ihn auf Ihre Domain (empfohlen).
- Aktivieren Sie im Modul Adress-Autovervollständigung und fügen Sie den Schlüssel ein.
Das Adressfeld des Formulars bietet dann während der Eingabe Vorschläge an. Die Auswahl eines Vorschlags füllt Straße, Zusatz, Stadt, PLZ, Land und ggf. Region aus. Die Vorschläge sind auf die aktiven Länder Ihres Shops beschränkt (bis zu 5 Länder — Limit der Google-API).
Google berechnet die Places API oberhalb des monatlichen Gratiskontingents. Für einen Shop mit moderatem Volumen reicht das Gratiskontingent in der Regel aus.
Länderbewusstes Adressformular
Das Adressformular passt sich automatisch an das gewählte Land an:
- Das Standardland des Dropdowns ist das in International → Lokalisierung Ihres Back-Office konfigurierte (nicht das alphabetisch erste Land).
- Das Feld Bundesland/Region erscheint nur für Länder, die welche haben (USA, Spanien, Italien…), und sein Dropdown listet nur die aktiven Regionen des gewählten Landes.
- Das Feld DNI erscheint für Länder, die es verlangen (Spanien).
- Die PLZ-Validierung verwendet das Format des Landes.
- Bei Landwechsel lädt die Seite neu, mit dem für das neue Land umstrukturierten Formular.
Adressbearbeitung
Jede gespeicherte Adresse zeigt ein Bleistift-Symbol. Ein Klick öffnet das Inline-Formular, vorausgefüllt mit allen Werten der Adresse (serverseitig geladen mit Eigentümerprüfung — ein Kunde kann niemals die Adresse eines anderen einsehen). Das Speichern aktualisiert die bestehende Adresse, ohne ein Duplikat anzulegen.


Rabattcode
Das (aktivierbare) Rabattcode-Feld funktioniert per AJAX: Anwenden und Entfernen ohne Neuladen, mit sofortiger Aktualisierung der Übersicht. Der Code wird mit genau denselben Regeln geprüft wie im nativen PrestaShop-Warenkorb (CartRule::checkValidity): Gültigkeitszeitraum, Mindestbetrag, Einschränkungen nach Versanddienst, Land oder Kundengruppe, Kombinierbarkeit. Native Fehlermeldungen („Dieser Gutschein ist abgelaufen“, „Mindestbetrag nicht erreicht“…) werden unverändert angezeigt.

Versandkompatibilität und Colissimo
Der Zusatzinhalt der Versanddienstleister (Colissimo-Abholpunkt-Karte, Mondial-Relay-Widget…) wird über {$carrier.extraContent} gerendert, exakt wie im nativen Template. Der Versandschritt wird nur abgeschlossen, wenn das Versandmodul ihn akzeptiert, genau wie im nativen Checkout (Hook actionValidateStepComplete).
- Kein Abholpunkt gewählt (Colissimo Abholpunkte, Mondial Relay…): Der Versandschritt bleibt mit dem Button zur Abholpunktwahl offen, und der Zahlungsschritt bleibt gesperrt. Die Meldung des Versanddienstes erscheint nur, wenn der Kunde ohne Abholpunkt auf „Weiter zur Zahlung“ klickt.
- Abholpunkt gewählt: Die Zahlung öffnet sich und bleibt auch nach einem Neuladen der Seite offen. Bei Colissimo wird der gespeicherte Punkt automatisch übernommen (Kennung und Mobilnummer): Der Kunde muss ihn nicht erneut wählen.
- Wechsel des Versanddienstes: Wechselt der Kunde von einem klassischen Versanddienst zu einem Abholpunkt, öffnet sich der Versandschritt wieder, bis ein Punkt gewählt ist.



Express-Zahlung mit Mollie (Apple Pay, Google Pay, PayPal)
Seit Version 1.3.1 rendert das Modul die nativen Hooks des Zahlungsschritts. Der Express-Checkout-Block des Mollie-Moduls (Express Component: Apple Pay, Google Pay, PayPal) erscheint damit oben im Zahlungsschritt, über den Zahlungsarten. Seine Buttons bleiben gesperrt, bis die AGB bestätigt sind; danach prüft Mollie den Warenkorb vor der Zahlung.
- Aktivieren Sie den Block im Mollie-Modul (Einstellungen Express Checkout). Mollie zeigt ihn nur im Live-Modus an, und Apple Pay erscheint nur in Safari (iPhone, iPad, Mac) mit einer bei Mollie verifizierten Domain.
- Die Apple-Pay-Direct-Buttons von Mollie auf der Produktseite und im Warenkorb laufen nicht über den Checkout: Sie funktionieren unverändert.
Integriertes Kartenformular von Mollie
Mit der Mollie-Option für das integrierte Kreditkartenformular im Checkout (Mollie Components) erscheinen die Kartenfelder im Zahlungsschritt und die Karte wird direkt im Checkout bezahlt: Beim Klick auf „Zahlungspflichtig bestellen“ erstellt Mollie ein sicheres Token der Karte und sendet es mit der Bestellung, ohne Weiterleitung zur gehosteten Zahlungsseite von Mollie.
- Auch die Ein-Klick-Zahlung von Mollie funktioniert: „Karte speichern“ und „Gespeicherte Karte verwenden“ werden an Mollie übermittelt.
- Erfordert Version 1.3.2 des Moduls: Vor dieser Korrektur wurde der Kunde zur Zahlungsseite von Mollie weitergeleitet und musste seine Karte erneut eingeben.
Entwickler-Hooks
displayDfsimplecheckoutExpress— Slot oben im Checkout für Express-Zahlungen (Apple Pay, Google Pay, PayPal Express).displayDfsimplecheckoutSidebarTop/displayDfsimplecheckoutSidebarBottom— Injektionszonen in der Übersichtsspalte.actionDfscSocialLogin— wird nach einem erfolgreichen Social Login ausgelöst, mit den Parameterncustomerunddfsc_social_provider(googleoderfacebook). Nützlich für CRM-Tagging.- Native Checkout-Hooks, an derselben Stelle gerendert wie in den nativen Templates (1.3.1):
displayPaymentTop(oben im Zahlungsschritt),displayCheckoutBeforeConfirmation(zwischen AGB und „Zahlungspflichtig bestellen“),displayBeforeCarrierunddisplayAfterCarrier(vor und nach der Liste der Versanddienste).
Fehlerbehebung
Der Google-Button wird nicht angezeigt
- Prüfen Sie, ob die Client ID eingetragen und die Option aktiviert ist.
- Prüfen Sie in der Browser-Konsole, ob ein „origin not allowed“-Fehler vorliegt — falls ja, fügen Sie die exakte URL Ihres Shops (mit https, ohne abschließenden Schrägstrich) in die Authorized JavaScript origins der Google Cloud Console ein.
Der Social Login bleibt nicht bestehen
Leeren Sie den PrestaShop-Cache und den Browser-Cache. Bleibt das Problem bestehen, prüfen Sie, ob ein Drittanbieter-Sicherheitsmodul die Session-Cookies nach dem Login invalidiert.
Das Feld Bundesland zeigt falsche Regionen
Stellen Sie sicher, dass Sie Modulversion 1.3.0 oder höher verwenden, welche die Formularstruktur serverseitig für jedes Land auflöst.
Die Zahlung öffnet sich, obwohl kein Abholpunkt gewählt ist
Aktualisieren Sie auf Version 1.3.1 oder höher: Der Versandschritt bleibt dann offen, bis das Versandmodul den Abholpunkt bestätigt.
Die Kartenzahlung mit Mollie leitet zur Zahlungsseite von Mollie weiter
Aktualisieren Sie auf Version 1.3.2 oder höher: Das integrierte Kartenformular übergibt die Karte dann direkt aus dem Checkout an Mollie. Besteht das Problem weiter, leeren Sie den PrestaShop-Cache und prüfen Sie in der Browserkonsole, ob ein JavaScript-Fehler das Laden des Mollie-Skripts verhindert.
Der Versandschritt wird von selbst abgeschlossen
Das ist das Standardverhalten: Der vorausgewählte Versanddienstleister wird automatisch bestätigt. Damit der Kunde selbst wählt, aktualisieren Sie auf Version 1.3.3 oder höher und aktivieren Sie in den Moduleinstellungen die Option „Kunde muss die Versandart bestätigen“.
Leere Seite auf /order
Aktivieren Sie den PrestaShop-Debug-Modus (_PS_MODE_DEV_), um den Fehler anzuzeigen, oder prüfen Sie var/logs. Stellen Sie sicher, dass kein anderes One-Page-Checkout-Modul gleichzeitig aktiv ist.
Deinstallation
Deinstallieren Sie das Modul über den Modul-Manager. Die Runtime-Umgebung wird sofort freigegeben und der native 5-Schritte-Checkout wiederhergestellt. Keine Restdateien, keine verwaisten Daten.