One-Page-Checkout – Überblick und Installation

Der SALEPIX One-Page-Checkout fasst den dreistufigen JTL-Standard-Bestellvorgang zu einer einzigen Seite zusammen. Kunden sehen Konto, Rechnungs- und Lieferadresse, Versandarten, Zahlungsarten und die Bestellübersicht mit Kupon-Feld, Kommentarfeld und Pflicht-Checkboxen gemeinsam auf einer Seite und bestellen ohne Seitenwechsel. Der Server rendert die Seite vollständig vor; danach tauscht das Plugin nur die betroffenen Bereiche per AJAX aus, etwa wenn sich Land, Postleitzahl oder Lieferadresse ändern und Versandarten neu geladen werden, oder wenn sich mit einer neuen Versandart die passenden Zahlungsarten ändern. Bei jedem Wechsel rechnet die Bestellübersicht Aufpreis, Mehrwertsteuer und Gesamtsumme sofort neu.

Zusätzlich zum Checkout bringt das Plugin vier Werkzeuge im JTL-Backend mit: eine Checkout-Statistik, ein Fehlerprotokoll mit Sofortmeldungen an den Hersteller, eine Warenkorb-Erinnerung für abgebrochene Bestellungen und einen KI-Zugang, über den eine KI wie ChatGPT oder Claude die zusammengefassten Auswertungen des Shops abfragen kann.

Was das Plugin macht

• Rechnungs- und Lieferadresse, Versandarten, Zahlungsarten, Bestellübersicht mit Kupon-Feld, Kommentarfeld, Pflicht-Checkboxen und Bestell-Button auf einer Seite.
• Anmeldung als bestehender Kunde direkt im Checkout (inklusive Zwei-Faktor-Login). Geschäftskunden sehen nach der Anmeldung automatisch ihre Konditionen. Angemeldete Kunden bearbeiten ihre Rechnungsadresse im Checkout und wählen Lieferadressen aus dem Adressbuch; ab sechs gespeicherten Adressen erscheint ein Suchfeld.
• Eingabe einer Umsatzsteuer-Identifikationsnummer: Eine Formatprüfung (EU, Schweiz, Großbritannien) läuft sofort, dazu bei entsprechender Shop-Einstellung die Online-Prüfung beim Bundeszentralamt für Steuern. Bei gültiger USt-ID rechnet die Übersicht auf Netto um und zeigt den Hinweis zur innergemeinschaftlichen Lieferung.
• Getippte Formularinhalte bleiben im Browser des Kunden zwölf Stunden erhalten, auch nach einem Neuladen oder einer Weiterleitung zu einem Zahlungsanbieter.
• Ein schlanker Checkout-Footer mit den Standard-Rechtsseiten (AGB, Widerruf, Datenschutz, Impressum, Versand & Zahlung) sowie Sprach- und Währungswahl ersetzt auf der Checkout-Seite den vollständigen Theme-Footer.
• Alle Frontend-Texte liegen in 27 Sprachen vor und lassen sich als Sprachvariablen des Plugins anpassen.
• Bei deaktiviertem Plugin verhält sich der Shop genau wie mit dem JTL-Standard-Bestellvorgang. Ein- und Ausschalten erfordert keine Datenmigration.

Was das Plugin nicht macht

• Es ersetzt nicht die Validierungen, Steuerberechnung, Kupon-Logik und Lagerprüfung von JTL-Shop; diese laufen unverändert über die Standard-Shop-Logik.
• Es bringt keine eigene Zahlungsabwicklung mit. Zahlungsplugins arbeiten mit ihrer eigenen Bestätigungslogik weiter.
• Es schaltet die Kundengruppe nicht automatisch um, solange sich der Kunde nicht anmeldet. Ohne Anmeldung löst nur eine gültige USt-ID die Neuberechnung für die innergemeinschaftliche Lieferung aus.
• Es verändert weder das Theme noch JTL-Core-Dateien. Alle Anpassungen laufen über Hooks und CSS.
• Es bringt keinen eigenen Dark-Mode mit; das Aussehen wird ausschließlich über die Einstellungen im Tab „Darstellung" gesteuert.

Voraussetzungen

• JTL-Shop ab Version 5.2.0.
• Theme NOVA, TECHNIK oder ein Child-Theme davon, das die Formular-IDs, Feldnamen und Formularklassen von NOVA sowie die Checkout- und Registrierungsvorlagen unverändert lässt.
• Im Shop angelegte, aktive Versandarten und Zahlungsarten, die der jeweiligen Kundengruppe zugeordnet sind.
• Für PayPal-Funktionen: das aktive JTL-Plugin „PayPal Commerce" (jtl_paypal_commerce).
• Für Klarna, Mollie, VR Payment, Amazon Pay und DHL Wunschpaket: die jeweiligen Plugins der Anbieter, wenn diese Zahlungsarten oder Lieferziele genutzt werden sollen.
• Für die Google-Adress-Vervollständigung: ein eigener Google-API-Schlüssel und der aktive JTL-Consent-Manager.
• Für das Kontaktformular und die Einwilligungs-Checkbox der Warenkorb-Erinnerung bei Gästen: Cloudflare-Turnstile-Schlüssel.
• Für Warenkorb-Erinnerung, Fehlerprotokoll und Checkout-Statistik: laufende JTL-Cronjobs (Backend → System → Cron).
• Für den KI-Zugang: eine per HTTPS erreichbare Shop-Installation und die PHP-Erweiterung intl.

Installation

1. Plugin-ZIP im JTL-Shop-Backend unter „Plugins → Plugin-Manager" hochladen (Reiter „Hochladen") und anschließend unter „Verfügbar" installieren. Dabei werden die Tabellen und Cronjobs des Plugins angelegt.
2. Unter „Plugins → SALEPIX One-Page-Checkout" die Einstellungen öffnen und „Plugin aktiv" auf „An" stellen.
3. Optional: CSS-Selektoren zum Ausblenden des Theme-Footers anpassen, falls das verwendete Theme einen anderen Footer-Aufbau hat.
4. Optional: Google-Maps-API-Schlüssel eintragen und Adress-Suche bzw. Adress-Prüfung einschalten.
5. Optional: Cloudflare-Turnstile-Schlüssel eintragen, wenn das Kontaktformular oder die Einwilligungs-Checkbox der Warenkorb-Erinnerung für Gäste genutzt werden sollen.

Testbetrieb: nur für eingeloggte Admins

Wer den One-Page-Checkout im Live-Shop ausprobieren möchte, ohne dass Kunden ihn bereits sehen, stellt die Einstellung „Plugin aktiv" auf „Nur für eingeloggte Admins (Testbetrieb)". Kunden bestellen dann weiterhin über den JTL-Standard-Bestellvorgang.

So sehen Sie den One-Page-Checkout selbst:

1. Im JTL-Backend anmelden.
2. Oben rechts auf das Profilbild klicken und „Zum Onlineshop" öffnen.
3. Im Shop wie ein Kunde einkaufen und zur Kasse gehen.

Die Freischaltung gilt für die Shop-Sitzung dieses Browsers und endet in der Regel mit der Abmeldung im Backend, immer aber mit der Abmeldung im Kundenkonto des Shops. Test-Bestellvorgänge landen wie echte Bestellungen in der Checkout-Statistik, in der Warenkorb-Erinnerung und in den Auswertungen des KI-Zugangs. Nach dem Test „Plugin aktiv" wieder auf „An" stellen, damit alle Kunden den One-Page-Checkout erhalten.

Hinweis: Ist im Shop zusätzlich das Plugin „LilFOOT SpamProtector Lite" aktiv und dort die Bot-Falle mit verstecktem Textfeld eingeschaltet, übernimmt der One-Page-Checkout Bestellungen nicht – auch nicht im Testbetrieb. Ein deutlich sichtbarer Hinweis im Backend weist in diesem Fall darauf hin. Stellen Sie in diesem Fall im SpamProtector-Plugin die Bot-Falle mit verstecktem Textfeld auf „Nein".

Lizenz und Updates

Das Plugin ist lizenzpflichtig. Nach der Installation wird automatisch eine Lizenz für die Shop-Domain angefordert; Voraussetzung dafür ist eine verknüpfte JTL-Konto-Lizenz im Shop unter „Lizenzen → Übersicht". Fehlt sie, schlägt die Aktivierung mit einer Meldung im Backend fehl.

Ohne gültige Lizenz wird der One-Page-Checkout nicht ausgeliefert: Der Shop fällt auf den JTL-Standard-Bestellvorgang zurück, Bestellungen sind weiterhin möglich, nur ohne die One-Page-Oberfläche. Die Warenkorb-Erinnerung erfasst in diesem Zustand keine neuen Abbrecher mehr, und der KI-Zugang antwortet nicht.

Der Lizenzstand wird beim Öffnen der Plugin-Seite im Backend (sofern die gespeicherte Lizenz ungültig ist) sowie einmal nachts über einen Cronjob geprüft. Eine verlängerte Lizenz gilt damit spätestens am nächsten Morgen, ohne dass das Plugin dafür deaktiviert und wieder aktiviert werden muss. Shop-Besuche von Kunden lösen keine Anfrage an den Lizenzserver aus.

Der Admin-Tab „Update" zeigt installierte Version, verfügbare Version und Lizenzstatus und installiert ein bereitstehendes Update per Klick. Bei verfügbarem Update erscheint zusätzlich ein Hinweis im Benachrichtigungsmenü des Backends. Vor jedem Update legt das Plugin eine Dateisicherung an; schlägt ein Update fehl, wird die Vorversion wiederhergestellt und Ihre Daten (Warenkorb-Erinnerungen, Checkout-Statistik, Fehlerprotokoll, Berichte, Cronjobs) bleiben vollständig erhalten. Über die Einstellung „Automatische Plugin-Updates" (Tab „Einstellungen", Gruppe „Plugin-Einstellungen") lässt sich zusätzlich ein täglicher automatischer Update-Cronjob einschalten; er installiert ein bereitstehendes Update nur bei gültiger Lizenz.

Cronjobs

Das Plugin legt bei Installation und Aktivierung folgende Aufträge in der JTL-Cron-Verwaltung an. Voraussetzung ist, dass der JTL-Cron im Shop läuft (Backend → System → Cron):

Das Dashboard der Warenkorb-Erinnerung warnt, wenn der stündliche Versand-Cron nie oder seit über zwei Stunden nicht gelaufen ist.

Häufige Hinweise zum Betrieb

• Nach einem Theme-Wechsel oder einem JTL-Update den Checkout einmal durchspielen.
• Express-Zahlungs-Buttons im Warenkorb (etwa ein PayPal-Button unterhalb der Artikelliste) sind vom One-Page-Checkout unabhängig und öffnen ihren eigenen Bezahlvorgang.
• Ist für ein Lieferland keine Versandart verfügbar, zeigt der Checkout einen Hinweis und blockiert die Bestellung; es wird keine Ersatz-Versandart angeboten.
• AGB, Widerrufsrecht, Datenschutz, Impressum sowie Versand & Zahlung werden aus den entsprechenden JTL-Spezialseiten geladen. Sind diese im Backend nicht angelegt, erscheinen sie auch nicht im Checkout-Footer.