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 Produktedetail-, Kategorie- oder Merklisten-Seiten, auf denen 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.
freeFieldscategoryPath	Optionales Freifeld zur Übergabe des Kategoriepfads, z.B. für Tracking-Zwecke.

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>