Modul GutscheinProdukt

Mit dem Modul „GutscheinProdukt“ verkaufen Sie Gutscheine als Produkte. Nach der Zahlung erzeugt der Shop einen Gutscheincode, legt ihn in der Gutscheinverwaltung an und schickt dem Kunden den Gutschein als PDF per E-Mail.

Voraussetzungen

• Das Modul Gutscheine muss aktiv sein. Sonst zeigt GutscheinProdukt den Hinweis „Bitte aktivieren Sie das Gutscheinmodul, damit dieses Modul korrekt funktioniert!“.

Einrichten

Öffnen Sie wpShopGermany → Konfiguration → Module und aktivieren Sie in der Gruppe „Produkte“ das Modul GutscheinProdukt.

Reiter „Einstellungen“

Einstellung	Beschreibung
Briefpapier (PDF/JPG)	Hintergrund des Gutschein-PDFs. Ist ein Briefpapier hochgeladen, erscheint der Link Derzeitiges Briefpapier; Löschen entfernt es.
Breite des PDFs in mm / Höhe des PDFs in mm	Format des Gutschein-PDFs.
Gutscheinmail an Kunden	Verweist auf die E-Mail „Gutscheinmail“ in der E-Mail-Konfiguration, wo Sie Betreff und Absender festlegen.

Reiter „Textfelder“

Mit den Textfeldern platzieren Sie Texte auf dem Gutschein. Je Zeile stellen Sie ein:

Angabe	Beschreibung
Freitext	Der Text. Klartext und Platzhalter sind möglich (siehe unten).
X / Y	Position von der linken oberen Ecke in mm.
Zentriert	X bestimmt die Mitte des Textes statt seines linken Randes.
Hintergrund	Der Text wird hinter das Briefpapier gelegt.
Farbe	Textfarbe im Hexadezimalformat, z. B. #000000.
Deckkraft	1 = voll sichtbar, 0 = unsichtbar.
Winkel	Drehung des Textes in Grad (0–360).
Größe	Schriftgröße.
Aktiv	Nur aktive Zeilen werden gedruckt.

Speichern und Vorschau anzeigen speichert die Einstellungen und zeigt einen Beispielgutschein.

Neben den üblichen Platzhaltern, etwa %kunde_name%, %kunde_vname% oder %product_name%, gibt es:

• %gs_code% – der erzeugte Gutscheincode
• %gs_value% – der Wert des Gutscheins
• %gs_valid% – Datum, bis zu dem der Gutschein gilt (TT.MM.JJJJ)
• %gs_start% – Datum, ab dem der Gutschein gilt (TT.MM.JJJJ)

Gutscheinprodukt anlegen

Legen Sie in der Produktverwaltung ein Produkt an. Im Kasten Gutscheinprodukt stellen Sie ein:

Angabe	Beschreibung
Gutschein generieren	Muss aktiv sein, sonst wird beim Kauf kein Gutschein erzeugt.
Länge des Gutscheincodes	Anzahl der Zeichen des erzeugten Codes.
Gültigkeit (Tage)	Wie viele Tage der Gutschein nach der Erzeugung gilt.
Gutschein als Wertgutschein generieren	Der erzeugte Gutschein wird als Wertgutschein angelegt (siehe Gutscheine).
Flexibler Preis	Der Kunde bestimmt den Gutscheinwert selbst, innerhalb von Minimaler Preis und Maximaler Preis. Auf der Produktseite erscheint dazu das Feld „Gutscheinwert“.

Soll der Gutschein nur per E-Mail zugestellt werden, legen Sie im Modul Versandarten eine Versandart wie „Versand per Mail“ an und weisen Sie sie dem Produkt als einzige Versandart zu.

Ablauf nach der Bestellung

Sobald die Bestellung den Status Zahlung akzeptiert erhält, erzeugt der Shop Gutscheincode und PDF. Wird dabei der Kunde informiert (Option „Kunden informieren“ beim Statuswechsel oder automatische Zahlungsbestätigung z. B. durch PayPal), erhält er die „Gutscheinmail“ mit dem PDF im Anhang. Die Vorlage der E-Mail liegt unter views/mods/mod_voucherproduct/gutschein_mail.phtml.

In der Bestellansicht zeigt der Kasten Gutscheine die erzeugten Gutscheine mit Download-Link. Dort können Sie:

• mit Gutscheine versenden die Gutscheine erneut per E-Mail senden,
• mit Neuen Gutschein generieren bzw. Gutschein anlegen einen weiteren Gutschein von Hand erzeugen (mit Wert, Berechnung, Gültig ab, Gültig bis und Kommentar; optional Kein Dokument generieren). Produktbezogene Platzhalter werden dabei nicht ersetzt.

Mit dem Modul Exportprofile können Sie Code, „Gültig ab“ und „Gültig bis“ der erzeugten Gutscheine exportieren.

PDF-Vorlage

Das PDF erzeugt die Vorlage views/mods/mod_voucherproduct/voucher_pdf.phtml. Für eigene Änderungen kopieren Sie sie in die User-Views, siehe HTML-Templates individualisieren.

Beispiel

Ein weihnachtliches Muster für einen Gutschein können Sie hier herunterladen.

Mit folgender Konfiguration ergibt sich daraus der fertige Gutschein. Das Ergebnis können Sie hier herunterladen.

Hinweise

• Das Briefpapier wird mit der freien PHP-Bibliothek FPDI eingelesen und neu erzeugt. Dabei können Inhaltsverzeichnisse, Formularelemente, Verlinkungen, Kommentare, Verschlüsselung und Komprimierung verloren gehen.
• Briefpapier mit einer PDF-Version über 1.4 wird unter Umständen nicht eingelesen. Speichern Sie es in diesem Fall als PDF 1.4.
• Wird eine Bestellung storniert, werden die zugehörigen Gutscheine gelöscht. Bereits eingelöste Gutscheine bleiben erhalten; der Shop zeigt dazu eine Meldung.
• Die PDFs liegen je Bestellung im Ordner wp-content/uploads/wpsg/wpsg_mod_gutscheinprodukt/<Bestellnummer>/. Der Ordner ist per .htaccess vor direktem Zugriff geschützt; das wirkt nur unter Apache. Unter nginx sperren Sie den Ordner in der Serverkonfiguration.
• Beim Löschen von Gutscheinen werden die PDFs nicht mitgelöscht.
• Auf Rechnungen werden Gutscheine mit dem Steuersatz „anteilig“ ausgewiesen.
• Nicht zusammen mit DownloadProdukte, DownloadPlus oder Produktvarianten verwenden.