Gutschein

Mit diesem Modul wird das Bakehouse zum automatischen Gutscheinshop. Gutscheine können online gekauft und bezahlt werden. Die Abrechnung erfolgt in der Standardversion über den Zahlungsdienstleister Stripe. Gekaufte Gutscheine werden automatisch als PDF via E-Mail zugestellt.

Design-Vorlagen

Das Gutscheinsystem erstellt automatisch PDF-Dateien im DIN A4 Format. Preis, Datum und Gutscheinnummer werden vom System zum Gutschein-Design hinzugefügt. In der folgenden downloadbaren Vorlage sind die entsprechenden Platzhalter bereits enthalten:

ViewHelper

Für diese Erweiterung relevante Bakehouse-ViewHelper sind mit dem Prefix voucher gekennzeichnet.

Gutschein-ViewHelper

Gutscheintypen

Pauschalgutschein (Fixwert)

Dieser Gutschein hat einen fix hinterlegten Wert, also z. B. 100,00 €. Dadurch ist es möglich entweder die bereits im Betrieb vorhandenen Gutscheine nachzubilden oder einen Pauschalgutschein anzubieten (z. B. Wellnessmassagen, Frühstücksevent, Pauschalurlaube).

Eigenschaft	Rückabewert	Beschreibung
name	String	Name des Gutscheins - wird beim Gutschein Element und im Warenkorb als Bezeichnung verwendet
subtext	String	Kurze Beschreibung des Gutscheins - wird beim Gutschein Element verwendet
voucherPdf	File	Bakehouse File Object - diese PDF-Datei wird für die Generierung des Gutscheins bei einer Bestellung verwendet (siehe Vorlagen). Kann auch beim Gutschein Element für die Preview verwendet werden.
voucherType	String	'fixed' oder 'dynamic' - gibt an, welche Gutscheinart das aktuelle Objekt ist
price	Float	Der Wert des Gutscheins (gilt nur für Gutscheine mit voucherType='fixed')

Wertgutschein (dynamischer Wert)

Hier kann der Wert des Guscheins bestimmt werden. Bei den bill Produkt-Einstellungen der
shop Gutschein-Erweiterung kann man pro Gutschein die Rahmenbedingungen wie Minimal- und Maximalwert bzw. die möglichen Schritte festgelegen.

Eigenschaft	Rückabewert	Beschreibung
name	String	Name des Gutscheins - wird beim Gutschein Element und im Warenkorb als Bezeichnung verwendet
subtext	String	Kurze Beschreibung des Gutscheins - wird beim Gutschein Element verwendet
voucherPdf	File	Bakehouse File Object - diese PDF-Datei wird für die Generierung des Gutscheins bei einer Bestellung verwendet (siehe Vorlagen). Kann auch beim Gutschein Element für die Preview verwendet werden.
voucherType	String	'fixed' oder 'dynamic' - gibt an, welche Gutscheinart das aktuelle Objekt ist
voucherMinValue	Integer	Mindestwert des Gutscheins (gilt nur für Gutscheine mit voucherType='dynamic')
voucherMaxValue	Integer	Maximalwert des Gutscheins (gilt nur für Gutscheine mit voucherType='dynamic')
voucherValueSteps	Integer	Wertschritte des Gutscheins (gilt nur für Gutscheine mit voucherType='dynamic')

Testen

Im Bearbeitungsmodus können Test-Zahlungen getätigt werden. Hierzu müssen die von Stripe bereitgestellten Kartennummern verwendet werden, welche in der Stripe-Dokumentation zu finden sind.

Andere Währung einstellen

Um die Währung des Shops von Euro auf eine andere Währung umzustellen, muss die Datei typo3conf/bakehouse/config.json um die Variablen currency und currency_sign im shop-Object erweitert werden.

siehe Beispiel unten:

JSON

{ "cookies": { "enabled": "true", "color": "#3c5747", "lighthousePassthrough": "", "optOutTracking": "true", "categorySelection": "true", "token": "abc" }, "shop": { "subject": "Gutscheinbestellung", "sender_mail_name": "Example", "sender_mail": "noreply@example.com", "mail": "info@example.com", "mail_test": "test@example.com", "mail_text": "Gutscheinbestellung \u00fcber die Webseite", "mail_banner": 82, "countries": "41", "country_favourites": "41", "currency": "chf", "currency_sign": "CHF" }, "stripe": { "onboarding": false, "bakehouse_token": "my_stripe_token" } }