Voucher

In diesem Abschnitt werden die verfügbaren Aktionen im Bereich Gutscheine beschrieben. Mit diesen Aktionen können Gutscheincodes im Warenkorb eingelöst und wieder entfernt werden.

---

Aktionen im Überblick

Aktion	Beschreibung
VoucherAdd	Löst einen Gutscheincode im Warenkorb ein.
VoucherDelete	Entfernt einen eingelösten Gutschein aus dem Warenkorb.

---

Aktionen

VoucherAdd

Mit dieser Aktion wird ein Gutscheincode im Warenkorb eingelöst.

Anwendungsbeispiel
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wo Kunden einen Gutscheincode eingeben und direkt auf ihre Bestellung anwenden können.

Parameter

Name	Beschreibung
id	Der Gutscheincode, der eingelöst werden soll.

Fehlercodes

Fehlercode	Beschreibung
missingId	Parameter id fehlt.
invalidVoucher	Der angegebene Gutscheincode ist ungültig oder bereits eingelöst.

Zugehörige Module, Variablen & Methoden

• $wsVoucher
• $wsVoucher.vouchers
• $wsVoucher.totalValue

Beispiel das zeigt, wie ein Gutscheincode über ein Eingabefeld eingelöst wird.

{{ var $myActionVoucherAdd = $wsActions.create("VoucherAdd") }}
<form method="post" action="{{= $wsViews.current.url() }}">
    <input type="hidden" name="wsact" value="{{= $myActionVoucherAdd.id }}">
    <input type="hidden" name="wscsrf" value="{{= $myActionVoucherAdd.csrf }}">
    <input type="text" name="id" placeholder="%%VoucherCode%%">
    <button type="submit">Gutschein einlösen.</button>
</form>

---

VoucherDelete

Mit dieser Aktion wird ein bereits eingelöster Gutschein aus dem Warenkorb entfernt.

Anwendungsbeispiel
Nutzbar auf der Warenkorbseite oder im Warenkorb-Offcanvas, wenn Kunden einen eingelösten Gutschein wieder entfernen möchten.

Parameter

Name	Beschreibung
id	Die ID des Gutscheins, der entfernt werden soll.

Fehlercodes

Fehlercode	Beschreibung
missingId	Parameter id fehlt.
invalidVoucherId	Der angegebene Gutschein existiert nicht oder gehört nicht zu diesem Warenkorb.

Zugehörige Module, Variablen & Methoden

• $wsVoucher
• $wsVoucher.vouchers
• $wsVoucher.totalValue

Beispiel das zeigt, wie alle eingelösten Gutscheine aufgelistet werden und jeder einzelne über einen Button entfernt werden kann.

{{ foreach $myVoucher in $wsVoucher.vouchers }}
    {{ var $myActionVoucherDelete = $wsActions.create("VoucherDelete") }}
    <form method="post" action="{{= $wsViews.current.url() }}">
        <input type="hidden" name="wsact" value="{{= $myActionVoucherDelete.id }}">
        <input type="hidden" name="wscsrf" value="{{= $myActionVoucherDelete.csrf }}">
        <input type="hidden" name="id" value="{{= $cVoucher.id }}">
        <button type="submit">Gutschein entfernen.</button>
    </form>
{{ /foreach }}