Zum Hauptinhalt springen
Ein META-Gutschein ist ein Sammel-Code. Der Kunde gibt eine einzige Nummer ein, und der Shop löst im Hintergrund mehrere hinterlegte Gutscheine auf einmal ein. Das ist nützlich, wenn eine Aktion aus mehreren Bausteinen besteht, beispielsweise zehn Prozent Rabatt zusammen mit freiem Versand, der Kunde aber nur einen Code merken soll. Die Zuordnung steht nicht im Gutschein-Generator, sondern in einer Datei, die Sie selbst pflegen. Diese Funktion muss nicht freigeschaltet werden.

​
Wie das Einlösen abläuft

Es kann immer nur ein META-Gutschein gleichzeitig eingelöst sein. Solange ein Gutschein aus einem META-Code im Warenkorb liegt, wird ein zweiter META-Code nicht erkannt und wie eine unbekannte Nummer behandelt.
Die Sub-Gutscheine belegen dieselben Plätze wie mehrfach eingelöste Gutscheine. Daraus ergibt sich die Obergrenze von neun Sub-Gutscheinen je META-Code. Wegweiser: Mehrere Gutscheine einlösen

​
Die Datei meta_vouchers.json

Legen Sie die Datei von Hand im Konfigurationsverzeichnis des Shops an, also in dem Verzeichnis, das für alle Subshops gilt. Sie enthält je META-Code einen Eintrag.
Der META-Code wird ohne Rücksicht auf Groß- und Kleinschreibung gesucht. Ein Kunde, der sommer2026 eingibt, trifft also den Eintrag SOMMER2026.
Mehr als neun Einträge in vouchers sind wirkungslos. Der Shop verarbeitet die ersten neun und lässt den Rest stillschweigend liegen.showAsBlock muss ein echter JSON-Wahrheitswert sein, also true oder false ohne Anführungszeichen. Die Schreibweise "true" wird ignoriert, und es gilt die Voreinstellung aus der Konfiguration.Fehlt die Datei, wird der eingegebene Code einfach als unbekannt behandelt. Ist sie vorhanden, aber fehlerhaft aufgebaut, protokolliert der Shop einen Fehler, verhält sich nach außen aber genauso. Ein META-Code, der nicht erkannt wird, ist deshalb zuerst ein Anlass, die Datei zu prüfen.

​
Die Einstellungen in der Shopkonfiguration

​
MetaVoucherErrorMode

reject-all ist die Voreinstellung und jeder nicht erkannte Wert führt ebenfalls dorthin. Sie ist die ehrlichere Variante: Der Kunde bekommt entweder das ganze Paket oder gar nichts und wundert sich nicht über einen Teilrabatt. Bei accept-valid unterdrückt der Shop die Fehlermeldung nur, wenn zuvor schon mindestens ein Sub-Gutschein erfolgreich eingelöst wurde. Scheitert gleich der erste, sieht der Kunde dessen Fehlermeldung, auch wenn die folgenden Sub-Gutscheine greifen.

​
MetaVoucherShowAsBlock

Bei no zählt der Shop beim Löschen mit. Ist der letzte Sub-Gutschein entfernt, setzt er auch die META-Daten zurück, und der Kunde kann einen anderen META-Code eingeben. Die Einstellung in der Datei sticht die Einstellung in der Konfiguration. So lässt sich eine einzelne Aktion abweichend behandeln, ohne die Voreinstellung für alle anderen zu ändern. Referenz: Abschnitt Voucher-Txt

​
Die Templates ergänzen (optional)

Vier Tags machen im Template sichtbar, dass ein Gutschein aus einem META-Code stammt.
Der Hinweis zur Blockbehandlung ist kein Beiwerk. Ohne ihn klickt der Kunde auf Löschen, um einen einzelnen Gutschein loszuwerden, und verliert die ganze Aktion. Wenn Sie MetaVoucherShowAsBlock auf yes lassen, schreiben Sie das dazu.
Die Tags stehen auch innerhalb der Schleife über die zusätzlichen Gutscheine zur Verfügung. Bei mehreren eingelösten Gutscheinen brauchen Sie den Block deshalb an beiden Stellen, außerhalb der Schleife für den ersten Gutschein und innerhalb für die weiteren. Referenz: VOUCHER-MetaCode · VOUCHER-MetaSubCount · VOUCHER-IsFromMeta · VOUCHER-MetaShowAsBlock · VOUCHER-MultiVoucher

​
Verwandte Themen