Basket

Warenkorb-Aktionen im Überblick: BasketItemAdd, BasketItemUpdate, BasketItemDelete sowie VoucherAdd und VoucherDelete zum Verwalten des Warenkorbs.

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Warenkorb beschrieben. Mit diesen Aktionen können Produkte hinzugefügt, aktualisiert und entfernt sowie Gutscheine verwaltet werden.

---

​

Aktionen im Überblick

Aktion	Beschreibung
BasketItemAdd	Legt ein Produkt in den Warenkorb.
BasketItemUpdate	Aktualisiert die Menge eines Produkts im Warenkorb.
BasketItemDelete	Entfernt ein Produkt aus dem Warenkorb.
VoucherAdd	Löst einen Gutscheincode im Warenkorb ein.
VoucherDelete	Entfernt einen eingelösten Gutschein aus dem Warenkorb.

---

​

Aktionen

​

BasketItemAdd

Mit dieser Aktion wird ein Produkt in den Warenkorb gelegt.

Anwendungsbeispiel
Nutzbar auf Produktdetail-, Kategorie- oder Merklisten-Seiten, auf denen Kunden Produkte direkt in den Warenkorb legen können.

Parameter

Name	Beschreibung
productId	Die ID des Produkts, das in den Warenkorb gelegt werden soll.
quantity	Die gewünschte Menge des Produkts.
multiProducts.<productId>.quantity	Ermöglicht das gleichzeitige Hinzufügen mehrerer Produkte mit jeweiliger Menge. Ersetzt productId und quantity. Eine Variante wird über multiProducts.<productId>.<Variante>.quantity übergeben. Ist eines der Produkte ungültig, legt der Shop keines davon in den Warenkorb.
insert	Das Werbemittelkennzeichen der Position. Gilt auch beim Hinzufügen eines einzelnen Produkts. Beim Hinzufügen mehrerer Produkte lautet der Parameter multiProducts.<productId>.insert.
freeFieldscategoryPath	Optionales Freifeld zur Übergabe des Kategoriepfads, beispielsweise für Tracking-Zwecke.

Über multiProducts werden beispielsweise beim Bestellschein der Direktbestellung alle erfassten Positionen in den Warenkorb übernommen, siehe Positionen in den Warenkorb übernehmen.

Fehlercodes

Fehlercode	Beschreibung
missingProductId	Parameter productId fehlt.
invalidProductId	Das Produkt existiert nicht oder ist nicht verfügbar.

Zugehörige Module, Variablen & Methoden

• $wsBasket
• $wsBasket.items
• $wsBasket.lastBasketAction
• $wsBasket.lastUpdatedItem

Beispiel das zeigt, wie ein Produkt mit Mengenauswahl in den Warenkorb gelegt wird und nach erfolgreicher Ausführung eine Bestätigungsmeldung erscheint.

{{ if $wsActions.current.success and $wsActions.current.name == "BasketItemAdd" }}
    <div class="alert alert-success">Produkt zum Warenkorb hinzugefügt.</div>
{{ /if }}

{{ var $myActionBasketItemAdd = $wsActions.create("BasketItemAdd") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionBasketItemAdd.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionBasketItemAdd.id }}">
    <input type="hidden" name="productId" value="{{= $cProduct.id }}">
    <input type="text" name="quantity" value="1">
    <button type="submit">In den Warenkorb legen.</button>
</form>

---

​

BasketItemUpdate

Mit dieser Aktion wird die Menge eines im Warenkorb enthaltenen Produkts aktualisiert.

Anwendungsbeispiel
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wenn Kunden die Menge eines bereits hinzugefügten Produkts anpassen möchten.

Parameter

Name	Beschreibung
basketItemId	Die ID des Warenkorb-Eintrags, dessen Menge aktualisiert werden soll.
quantity	Die neue Menge des Produkts.

Fehlercodes

Fehlercode	Beschreibung
missingBasketItemId	Parameter basketItemId fehlt.
invalidBasketItemId	Der Warenkorb-Eintrag existiert nicht oder gehört nicht zu diesem Warenkorb.
missingQuantity	Parameter quantity fehlt.

Zugehörige Module, Variablen & Methoden

• $wsBasket
• $wsBasket.items
• $wsBasket.lastBasketAction
• $wsBasket.lastUpdatedItem

Beispiel das zeigt, wie die Menge eines Warenkorb-Eintrags über ein Formular aktualisiert wird.

{{ var $myActionBasketItemUpdate = $wsActions.create("BasketItemUpdate", tag = $myProduct.id) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionBasketItemUpdate.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionBasketItemUpdate.id }}">
    <input type="hidden" name="basketItemId" value="{{= $myProduct.id }}">
    <input type="text" name="quantity" value="{{= $myProduct.quantity | preparedFormat('amount') }}">
    <button type="submit">Menge aktualisieren.</button>
</form>

---

​

BasketItemDelete

Mit dieser Aktion wird ein Produkt aus dem Warenkorb entfernt.

Anwendungsbeispiel
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wenn Kunden ein Produkt vollständig aus dem Warenkorb entfernen möchten.

Parameter

Name	Beschreibung
basketItemId	Die ID des Warenkorb-Eintrags, der entfernt werden soll.
productId	Die ID des Produkts, das entfernt werden soll.
quantity	Die aktuelle Menge des Produkts.

Fehlercodes

Fehlercode	Beschreibung
missingBasketItemId	Parameter basketItemId fehlt.
invalidBasketItemId	Der Warenkorb-Eintrag existiert nicht oder gehört nicht zu diesem Warenkorb.

Zugehörige Module, Variablen & Methoden

• $wsBasket
• $wsBasket.items
• $wsBasket.lastBasketAction
• $wsBasket.lastUpdatedItem

Beispiel das zeigt, wie ein Produkt über einen Button aus dem Warenkorb entfernt wird.

{{ var $myActionBasketItemDelete = $wsActions.create("BasketItemDelete", tag = $myProduct.id) }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionBasketItemDelete.csrf }}">
    <input type="hidden" name="wsact" value="{{= $myActionBasketItemDelete.id }}">
    <input type="hidden" name="basketItemId" value="{{= $myProduct.id }}">
    <input type="hidden" name="productId" value="{{= $myProduct.product.id }}">
    <input type="hidden" name="quantity" value="{{= $myProduct.quantity | preparedFormat('amount') }}">
    <button type="submit">Produkt entfernen.</button>
</form>