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

AktionBeschreibung
VoucherAddLöst einen Gutscheincode im Warenkorb ein.
VoucherDeleteEntfernt 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
NameBeschreibung
idDer Gutscheincode, der eingelöst werden soll.
Fehlercodes
FehlercodeBeschreibung
missingIdParameter id fehlt.
invalidVoucherDer angegebene Gutscheincode ist ungültig oder bereits eingelöst.
Zugehörige Module, Variablen & Methoden 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
NameBeschreibung
idDie ID des Gutscheins, der entfernt werden soll.
Fehlercodes
FehlercodeBeschreibung
missingIdParameter id fehlt.
invalidVoucherIdDer angegebene Gutschein existiert nicht oder gehört nicht zu diesem Warenkorb.
Zugehörige Module, Variablen & Methoden 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 }}