Zum Hauptinhalt springen
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

AktionBeschreibung
BasketItemAddLegt ein Produkt in den Warenkorb.
BasketItemUpdateAktualisiert die Menge eines Produkts im Warenkorb.
BasketItemDeleteEntfernt ein Produkt aus dem Warenkorb.
VoucherAddLöst einen Gutscheincode im Warenkorb ein.
VoucherDeleteEntfernt 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
NameBeschreibung
productIdDie ID des Produkts, das in den Warenkorb gelegt werden soll.
quantityDie gewünschte Menge des Produkts.
freeFieldscategoryPathOptionales Freifeld zur Übergabe des Kategoriepfads, z.B. für Tracking-Zwecke.
Fehlercodes
FehlercodeBeschreibung
missingProductIdParameter productId fehlt.
invalidProductIdDas Produkt existiert nicht oder ist nicht verfügbar.
Zugehörige Module, Variablen & Methoden 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
NameBeschreibung
basketItemIdDie ID des Warenkorb-Eintrags, dessen Menge aktualisiert werden soll.
quantityDie neue Menge des Produkts.
Fehlercodes
FehlercodeBeschreibung
missingBasketItemIdParameter basketItemId fehlt.
invalidBasketItemIdDer Warenkorb-Eintrag existiert nicht oder gehört nicht zu diesem Warenkorb.
missingQuantityParameter quantity fehlt.
Zugehörige Module, Variablen & Methoden 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
NameBeschreibung
basketItemIdDie ID des Warenkorb-Eintrags, der entfernt werden soll.
productIdDie ID des Produkts, das entfernt werden soll.
quantityDie aktuelle Menge des Produkts.
Fehlercodes
FehlercodeBeschreibung
missingBasketItemIdParameter basketItemId fehlt.
invalidBasketItemIdDer Warenkorb-Eintrag existiert nicht oder gehört nicht zu diesem Warenkorb.
Zugehörige Module, Variablen & Methoden 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>