/
$wsCheckout - Bestellablauf

$wsCheckout - Bestellablauf

In diesem Abschnitt finden Sie alle Möglichkeiten, um auf die Daten von Bestellablauf zuzugreifen. Es werden die verfügbaren Variablen und Tags beschrieben, mit denen Sie die Daten dynamisch im Frontend anzeigen können.

Inhaltsübersicht

Templates

Der Checkoutvorgang ist vollkommen flexibel, Sie können ihn frei gestalten. Er kann eine oder mehrere Shopseiten umfassen. Bei der Auswahl der Elemente ist die Reihenfolge beliebig.

Datenübersicht

Um die verfügbaren Checkoutdaten einzusehen, können Sie sich diese in einem JSON-ähnlichen Format ausgeben lassen. Dies ist hilfreich, um die Struktur und Inhalte der Checkoutdaten zu verstehen oder auch Fehler zu debuggen.

Dies erfolgt folgendermaßen (auskommentiert, damit die Ausgabe nicht direkt im Frontend angezeigt wird):

<!-- {{= $wsCheckout | json }} -->

 

Die Ausgabe in der Developer-Konsole des Browsers könnte dann wie folgt aussehen:

{ "accountType": "registered", "freeFields": [ { "checked": false, "default": false, "id": "agb", "name": "AGB", "required": true, "type": "checkbox" }, { "default": "", "id": "comment", "name": "Bemerkung", "required": false, "type": "text" } ], "guestMail": "", "isExpressCheckoutLocked": false, "isFinished": "(Function)", "isPending": "(Function)", "isValid": true, "isValidBillAddress": "(Function)", "isValidPayment": "(Function)", "isValidShippingAddress": "(Function)", "isValidShippingMethod": "(Function)", "itemVoucherDiscount": "(Function)", "problems": { "billAddress": [], "clearing": [], "general": [], "payment": [], "shippingAddress": [], "shippingMethod": [] }, "restUntilFreeDelivery": 6.05, "selectedBillAddress": "1", "selectedPayment": "bill", "selectedPseudoCC": "", "selectedShippingAddress": "1", "selectedShippingMethod": "hermes", "sum": { "shippingCost": 6.95, "total": 30.9, "totalGross": 30.9, "totalNet": 28.22, "totalTax": 2.68, "totalVoucher": 0.0 }, "useAlternativeShippingAddress": false, "voucherAppliesPerItem": true }

 

Beispiele für die Anzeige von Checkoutdaten

Kontotyp Prüfen

Dadurch wird geprüft, ob der Kunde Gastbesteller oder eingeloggter Kunde ist.

Kontotyp: {{= $wsCheckout.accountType }}

 

Prüfung auf neues Konto

In diesem Beispiel wird geprüft, ob der Kunde beim Bestellablauf ein neues Konto erstellt hat.

{{ if $wsCheckout.accountType == "new" and not $wsAccount.isLoggedIn }} Ein neues Konto wird bei dieser Bestellung erstellt {{ /if }}

 

Gastbesteller E-Mail Adresse

In diesem Beispiel wird die E-Mail Adresse eines Gastbestellers ausgelesen.

Ihre E-Mail Adresse: {{= $wsCheckout.guestMail }}

Rechnungsadresse

Gültigkeit der Adresse prüfen

In diesem Beispiel wird geprüft, ob die Rechnungsadresse gültig ist.

{{ if $wsCheckout.isValidBillAddress($wsCheckout.selectedBillAddress) }} Rechnungsadresse ist gültig {{ /if }}

 

Index der Rechnungsadresse

Liefert die Listposition der gewählten Rechnungsadresse zurück. Wenn nur eine Rechnungsadresse hinterlegt wurde und diese gewählt ist, dann wird der Indexwert '1' zurückgegeben.

Indexnummer der Rechnungsadresse: {{= $wsCheckout.selectedBillAddress}}

 

Fehler anzeigen

In diesem Beispiel wird die gewählte Rechnungsadresse auf Fehler überprüft. Falls Fehler auftreten, werden der entsprechende Fehlercode und die Fehlermeldung ausgegeben.

{{ if $wsCheckout.problems.billAddress }} {{ foreach $prob in $wsCheckout.problems.billAddress }} {{=$prob.code}} {{=$prob.check}}<br> {{ /foreach }} {{ /if }}

 

Lieferadresse

Abweichende Lieferadresse

In diesem Beispiel wird geprüft, ob eine Abweichende Lieferadresse verwendet wird.

{{ if $wsCheckout.useAlternativeShippingAddress }} Eine Abweichende Lieferadresse wird verwendet {{ /if }}

 

Index der Lieferadresse

Liefert die Listposition der gewählten Lieferadresse zurück. Wenn nur eine Lieferadresse hinterlegt wurde und diese gewählt ist, dann wird der Indexwert '1' zurückgegeben.

Indexnummer der Lieferadresse: {{= $wsCheckout.selectedShippingAddress}}

 

Lieferadresse Gültigkeit

In diesem Beispiel wird geprüft, ob die Lieferadresse gültig ist.

{{ if $wsCheckout.isValidShippingAddress($wsCheckout.selectedShippingAddress) }} Lieferadresse ist gültig {{ /if }}

 

Fehler anzeigen

In diesem Beispiel wird die gewählte Lieferadresse auf Fehler überprüft. Falls Fehler auftreten, werden der entsprechende Fehlercode und die Fehlermeldung ausgegeben.

{{ if $wsCheckout.problems.shippingAddress }} {{ foreach $prob in $wsCheckout.problems.shippingAddress }} {{=$prob.code}} {{=$prob.check}}<br> {{ /foreach }} {{ /if }}

Zahlung

Gewählte Zahlungsart

In diesem Beispiel wird die gewählte Zahlungsart angezeigt.

Gewählte Zahlungsart: {{= $wsCheckout.selectedPayment }

 

Zahlungsart Gültigkeit

In diesem Beispiel wird geprüft, ob die gewählte Zahlungsart gültig ist.

{{ if $wsCheckout.isValidPayment($wsCheckout.selectedPayment) }} Die gewählte Zahlungsart ist gültig {{ /if }}

 

Fehler anzeigen

In diesem Beispiel wird die gewählte Zahlungsart auf Fehler überprüft. Falls Fehler auftreten, werden der entsprechende Fehlercode und die Fehlermeldung ausgegeben.

{{ if $wsCheckout.problems.payment }} {{ foreach $prob in $wsCheckout.problems.payment }} {{=$prob.code}} {{=$prob.check}} {{ /foreach }} {{ /if }}

 

Versand

Gewählte Versandart

In diesem Beispiel wird die gewählte Versandart angezeigt.

Gewählte Versandart: {{= $wsCheckout.selectedShippingMethod }}

 

Restbetrag bis zum kostenlosen Versand

In diesem Beispiel wird der verbleibende Betrag bis zum Erreichen der kostenlosen Versandgrenze angezeigt.

Nur noch {{= $wsCheckout.restUntilFreeDelivery | currency }} {{= $wsConfig.currency.symbol }} bis zum kostenlosen Versand!

 

Versandart Gültigkeit

In diesem Beispiel wird geprüft, ob die gewählte Versandart gültig ist.

{{ if $wsCheckout.isValidShippingMethod($wsCheckout.selectedShippingMethod) }} Versandart ist gültig {{ /if }}

 

Fehler anzeigen

In diesem Beispiel wird die gewählte Versandart auf Fehler überprüft. Falls Fehler auftreten, werden der entsprechende Fehlercode und die Fehlermeldung ausgegeben.

{{ if $wsCheckout.problems.selectedShippingMethod }} {{ foreach $prob in $wsCheckout.problems.selectedShippingMethod }} {{=$prob.code}} {{=$prob.check}}<br> {{ /foreach }} {{ /if }}

Checkoutstatus

 

Checkout Gültigkeit

In diesem Beispiel wird geprüft, ob die Rechnungs-/Lieferadressen, Versand-/Zahlungsart, Reservierungen und Produkte im Warenkorb gültig sind.

{{ if $wsCheckout.isValid }} Checkoutstatus ist OK {{ /if }}

Prüfen, ob einen Bestellvorgang abgeschlossen wurde

In diesem Beispiel wird geprüft, ob in der aktuellen Session ein Bestellvorgang noch nicht abgeschlossen wurde. Dies kann passieren, wenn beispielsweise eine Bezahlung noch aussteht oder nicht bestätigt wurde.

{{ if $wsCheckout.isPending() }}   Aktuell ist für diese Session ein Zahlungsvorgang aktiv (pending). {{ /if }} {{ if $wsCheckout.isFinished() }}   Mit der Session wurde eine Bestellung abgeschlossen. {{ /if }}

 

Express Checkout Locked

Nachdem der Nutzer über PayPal bezahlt hat, wird er zurück zum Shop geleitet, um die Bestellung abzuschließen. Währenddessen sind bestimmte Shop-Funktionen nicht verfügbar, wie zum Beispiel das Bearbeiten des Warenkorbs oder das Einlösen und Entfernen von Gutscheinen.

In diesem Beispiel wird die Eigenschaft isExpressCheckoutLocked überprüft, um dem Nutzer eine entsprechende Nachricht anzuzeigen.

{{ if $wsCheckout.isExpressCheckoutLocked }} Die Bearbeitung Ihres Warenkorbs ist derzeit nicht möglich {{ /if }}

Free Fields (Freifelder)

Der Zugriff auf Freifelder erfolgt über eine foreach Schleife, wobei ihre jeweiligen Eigenschaften überprüft werden können.

Beispiel: Prüfen, ob die AGBs akzeptiert wurden

In diesem Beispiel wird überprüft, ob das Feld agb innerhalb einer foreach Schleife geladen wird. Falls das Feld vorhanden ist, wird dessen boolesche Eigenschaft checked geprüft.

{{ foreach $checkoutField in $wsCheckout.freeFields }} {{ if $checkoutField.id == "agb" }} {{ if not $checkoutField.checked }} Bitte akzeptieren Sie die AGBs {{ /if }} {{ /if }} {{ /foreach }}

 

Sum (Summe, Rabatte & Zusatzkosten)

Versandkosten

In diesem Beispiel werden die gesamte Versandkosten angezeigt.

Versandkosten: {{= $wsCheckout.sum.shippingCost | currency }} {{= $wsConfig.currency.symbol }}

Total

In diesem Beispiel wird die Summe inklusive Versandkosten, Nachlässe/Rabatte und Steuern angezeigt.

Gesamtsumme: {{= $wsCheckout.sum.total | currency }} {{= $wsConfig.currency.symbol }}

Total Gross

In diesem Beispiel wird die Summe inklusive Versandkosten und Steuern angezeigt.

Summe (gross): {{= $wsCheckout.sum.totalGross | currency }} {{= $wsConfig.currency.symbol }}

Total Net

In diesem Beispiel wird die Summe inklusive Versandkosten, jedoch ohne Steuern angezeigt.

Summe (net): {{= $wsCheckout.sum.totalNet | currency }} {{= $wsConfig.currency.symbol }}

Total Tax

In diesem Beispiel wird die Gesamtsumme der Steuern angezeigt.

Steuern: {{= $wsCheckout.sum.totalTax | currency }} {{= $wsConfig.currency.symbol }}

Total Voucher

In diesem Beispiel wird die Summe der Nachlässe/Rabatte angezeigt.

Rabatte: {{= ($wsCheckout.sum.totalVoucher) | currency }} {{= $wsConfig.currency.symbol }}

 

 

Referenz

In der Modul-Referenz für $wsCheckout finden Sie eine Übersicht aller verfügbaren Eigenschaften und Parameter.

 

© 2025 WEBSALE AG | Impressum | Datenschutz