Hilfe zum Modul GutscheinProdukt

erstellt: 19. November 2012, zuletzt geändert: 17. August 2016 unter Tutorials

Funktionen des Moduls:

• Verkauf von Gutscheinen die später im Shop eingelöst werden können
• Erstellung von individualisierten PDF Gutscheinen
• Versand der Gutscheine per Mailanhang an Kunden

Gutscheine verkaufen

Damit Gutscheine verkauft werden können, muss ein entsprechendes Produkt angelegt werden. Dies geschieht über die Produktverwaltung. Im Produkt müssen aber zusätzlich folgende Felder definiert werden:

Gutschein generieren
Muss aktiviert sein, sonst wird kein Gutschein beim Kauf generiert.

Länge des Gutscheincodes
Die Länge des generierten Gutscheincodes

Gültigkeit (Tage)
Die Tage die der Gutschein nach der Generierung gültig bleiben soll.

Wird ein Produkt verkauft, bei dem die Option „Gutschein generieren“ aktiviert ist, so wird beim Wechsel des Bestellstatus auf „Zahlung akzeptiert“ der Gutschein generiert. Er wird dabei automatisch an den Kunden gesendet wenn im Backend der Bestellung die Option „Kunden informieren“ aktiviert ist.

Ändert sich die Zahlung aufgrund einer Modulaktion (PayPal, Sofortüberweisung) wird die Mail auch automatisch  versendet. Die generierten Dokumente werden als Anhang der Mail mit versendet.

Das Template der Mail finden Sie unter: views/mods/mod_voucherproduct/gutschein_mail.phtml

Die Daten wie Betreff, Absender können sie in den E-Mail Konfiguration unter „Gutscheinmail“ definieren.

Erstellung von individualisierten PDF Dokumenten

Unter den Moduleinstellungen können Sie ein Briefpapier (PDF oder JPEG) angeben, welches als Hintergrund verwendet wird. Auf den Gutschein selbst können sie dann mittels der Textfelder beliebige Felder definieren:

Im Freitext können dann die im Shop gültigen Platzhalter eingesetzt werden.

X/Y
Die Position des Textes in Relation zur linken oberen Ecke des Dokuments.

Zentriert
Ist diese Option aktiviert, so bestimmen sie nicht die linke Position des Textes, sondern die Mitte des Textes.

Hintergrund
Ist diese Option aktivier, so wird der Text vor dem Briefpapier in das Dokument geschrieben.

Farbe
Die Farbe des Textes als hexadezimaler Farbcode.

Opaque
Die Sichtbarkeit des Textes. (1 = völlig sichtbar, 0 = Unsichtbar)

Winkel
Der Winkel in Grad (0 – 360) des Textes

Größe
Die Schriftgröße des Textes.

Aktiv
Diese Option muss aktiv sein, sonst wird die komplette Zeile ignoriert.

Freitext
Der Freitext ist der Text, der an der angegebenen Position ausgegeben wird. Es sind hier die im Shop üblichen Platzhalter möglich. Beispielsweise:

• %kunde_name% – Name des Kunden
• %kunde_vname% – Vorname des Kunden
• %product_name% – Der Name des gekauften Produktes
• …

Weitere spezielle Platzhalter:

• %gs_code% – Der generierte Gutscheincode
• %gs_value% – Der Wert des generierten Gutscheins
• %gs_valid% – Datum bis wann der Gutschein eingelöst werden kann (d.m.Y)
• %gs_start% – Datum ab wann der Gutschein eingelöst werden kann (d.m.Y)

Das FPDF Template finden Sie unter

views/mods/mod_voucherproduct/voucher_pdf.phtml

Versand an den Kunden

Der Versand der Gutscheine erfolgt beim Wechsel auf den Bestellstatus „Zahlung akzeptiert“ oder wenn man in der Bestellansicht den Button „Gutscheine versenden“ betätigt.

Hinweise

• Das im Shop enthaltende Gutscheinmodul muss aktiv sein. (Sonst erscheint auch ein Hinweis)
• Das "Briefpapier" wird neu erstellt, indem es mit der freien PHP-Bibliothek FPDI eingelesen und um die konfigurierten Parameter des Moduls GutscheinProdukt ergänzt/personalisiert wird.
  Folgende Elemente gehen dabei u.U. verloren:
  • Inhaltsverzeichnisse
  • Formularelemente
  • Verlinkungen
  • Kommentare
  • Verschlüsselung
  • Komprimierung
• "Briefpapier" mit einer PDF Version größer als 1.4 wird derzeit nicht unterstützt und sollte ggf. neu gespeichert oder neu geparst werden.
• Wird eine Bestellung storniert so werden die zugeordneten Gutscheine gelöscht. Sollten Gutscheine bereits verbraucht sein bleiben Sie erhalten und es erscheint eine entsprechende Meldung.
• Die Gutscheine werden im Ordner /wp-content/uploads/wpsg/wpsg_mod_gutscheinprodukt/{order_id}/voucher_{code}.pdf abgelegt
• Der Ordner ist durch eine .htaccess Datei vor direktem Zugriff geschützt, überprüfen sie ob ihr Server dies unterstützt.
• Beim löschen von Gutscheinen werden die Dokumente nicht automatisch mit gelöscht.
• Sollte nicht in Verbindung mit Downloadprodukt/Downloadplus oder Varianten verwendet werden (Auch wenn es vermutlich prinzipiell funktioniert)

Beispiel

Zur Weihnachtszeit stellen wir ein Muster für einen Gutschein bereit. Dieses Muster können Sie hier herunterladen.

Zusammen mit folgender Konfiguration ergeben sich Gutscheine, die wie hier aussehen.