Zum Hauptinhalt springen
Kaufgutscheine zum Ausdrucken sind Gutscheine, die der Kunde als Produkt bestellt und anschließend als PDF erhält. Das Aussehen dieses PDF bestimmen Sie über ein eigenes Template, und die INSTANTVOUCHER-Tags füllen es mit den Daten des gekauften Gutscheins. Alle sieben Tags gelten ausschließlich in diesem Template. Welches es ist, legen Sie in der Shopkonfiguration shop.config im Abschnitt <Templates> beim Parameter InstantVoucherPDF fest. Außerhalb dieses Templates bleiben die Tags leer, weil die Gutscheindaten dort nicht vorliegen. Die Tags beschreiben immer genau einen Gutschein, nämlich den gerade erzeugten. Bestellt ein Kunde mehrere, entsteht für jeden ein eigenes PDF aus demselben Template. Wegweiser: Kaufgutscheine zum Ausdrucken · Referenz: Abschnitt Templates

​
Die Werte des Gutscheins

INSTANTVOUCHER-Amount ist bereits im Preisformat des Shops formatiert, also mit dem eingestellten Dezimal- und Tausendertrennzeichen. Sie müssen nichts nachformatieren und können das Tag auch nicht mit einer anderen Stellenzahl aufrufen. Währungscode und Währungssymbol sind zwei verschiedene Tags, weil beide ihre Berechtigung haben. Das Symbol liest sich neben dem Betrag natürlicher, der Code ist eindeutig und eignet sich für den Fußbereich oder für Gutscheine, die ins Ausland gehen.

​
Die Gültigkeit ausgeben

Die drei Datumsbestandteile sind einzelne Tags, damit Sie das Datum in der Schreibweise des jeweiligen Landes zusammensetzen können.
Nicht jeder Gutschein ist befristet. Ist kein Gültigkeitsdatum hinterlegt, geben alle drei Tags nichts aus, und aus der Zeile oben wird ein nacktes “Gültig bis ..” auf dem gedruckten Gutschein. Klammern Sie die Zeile deshalb.
Prüfen Sie dabei das Jahr. Das Shopsystem gibt den Tag nur aus, wenn er zwischen 1 und 31 liegt, den Monat nur zwischen 1 und 12 und das Jahr nur ab 2015. Fehlt das Datum, sind alle drei leer. Das Jahr ist von den dreien das aussagekräftigste, weil ein gültiges Datum immer eines hat.

​
Auf einen bestimmten Wert prüfen

Jedes der sieben Tags lässt sich als Klammerung mit einem Vergleichswert im Argument verwenden. Der Bereich greift dann, wenn der Wert genau übereinstimmt.
Die Schreibweise des Vergleichswerts spielt keine Rolle.
Beim Betrag vergleichen Sie gegen den formatierten Wert, also gegen die Zeichenkette, die das Tag auch ausgeben würde. {INSTANTVOUCHER-Amount(50)} greift deshalb nicht bei einem Fünfzig-Euro-Gutschein, weil das Tag “50,00” liefert. Für Fallunterscheidungen nach Betragshöhe ist dieses Verfahren ungeeignet.

​
Die Tags im Überblick

Alle sieben Tags verhalten sich gleich. Sie gelten nur in dem Template, das unter InstantVoucherPDF eingetragen ist. Die Schreibweise des Tagnamens spielt keine Rolle.

​
Verwandte Themen