Bestellbare Gutscheine
Modulbeschreibung
Das kennen Sie doch bestimmt auch: Egal zu welchem Anlass ist die Frage „Was soll ich bloß verschenken?“ ein großes Problem.
Mit dem Modul „Bestellbare Gutscheine“ können Ihre Kunden im Shop Gutscheine, wie normale Artikel kaufen. Der Kunde kann sich sein Geschenkgutschein individuell unter der Angabe von Wunschbeträgen, Aussehen, persönlicher Nachricht und E-Mail des Beschenkten zusammenstellen.
Für den Shopbetreiber bietet das Modul von der Erstellung eines Gutscheins bis hin zu der Verwaltung und dem endgültigen Versand der Gutscheine eine einfache Handhabung.
Es können Vorlagen mit vielen verschiedenen Hintergründen und Entwürfen erstellt werden, die dem Kunden im Frontend zur Auswahl gestellt wird. Die Platzierung von bestimmten Textfeldern sind im Backend frei einstellbar. Ablaufdatum der Gutscheine lässt sich unter Moduloptionen beliebig einstellen.
Der Kunde kann zwischen den Entwürfen auswählen und die Gutscheinvariante je nach Wunschbetrag wählen. Bestellbare Gutscheine können vom Kunden wie gewohnt in den Warenkorb gelegt, bestellt und bezahlt werden. Der Käufer kann unter Angabe der E-Mail-Adresse des Beschenkten, den Gutschein auch direkt als PDF-Datei zukommen lassen.
Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 6.1 - 6.4 getestet: PayPal, AmazonPay, Klarna und Payone.
Das Modul wurde mit folgenden Zahlart-Modulen unter Oxid 7.3 - 7.5 getestet: PayPal Checkout.
Das Modul ist erhältlich auf https://www.digidesk.de/produkte/bestellbare-gutscheine/
Funktionsbeschreibung
Mit diesem Modul können Gutscheine in Ihrem Shop bestellt werden. Sie haben die Möglichkeit, wie in der Einrichtung des Moduls unter Punkt 2 beschrieben, bestimmte Artikel als Gutschein-Artikel festzulegen. In dem Gutschein-Konfigurator können Ihre Kunden diese Gutscheine dann konfigurieren (Wert, Text, Design) und bestellen. Nachdem die Bestellung erfolgreich abgelaufen ist, werden die Gutscheine als PDF an den Kunden herausgeschickt.
Die einzelnen Gutschein-Designs können Sie im Backend definieren.
Der Gutscheincode ist eine zufällige Zeichenkette, die mithilfe der Shop-ID und den PHP-Funktionen "microtime" und "uniqid" generiert wird. Der Code ist immer 10 Zeichen lang.
Systemvoraussetzungen
PHP-Version OXID 6
PHP 7.4 - 8.1 (OXID 6.5.x)
PHP-Version OXID 7
PHP 8.4 (OXID 7.3.x - 7.5.x)
PHP 8.5 (OXID 7.5.x)
Webserver-Konfiguration
IonCube Loader (v14 - v15)
Kompatibel mit den Themes
Flow
Wave
RoxIVE
APEX
Kompatibel mit den OXID Versionen
OXID CE/PE/EE 6.5.x
OXID CE/PE/EE 7.3.x bis 7.5.x
Template-Engine
Smarty bis OXID 6.5.x
Twig ab OXID 7.3.x
Installation
Ab OXID 6/7
Falls noch nicht geschehen, laden Sie bitte zunächst das digidesk Basis-Modul herunter und installieren Sie es gemäß der enthaltenen Installationsanleitung.
Sie erhalten dieses unter: https://www.digidesk.de/produkte/basis-modul/
Für dieses Modul erstellen Sie nun einen weiteren Unterordner
couponsellingim Ordnerpackages/digidesk, in den die heruntergeladene Zip-Datei entpackt wird.Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:
Nun kann das Modul im OXID eShop Admin aktiviert werden
Ggf. Tmp-Verzeichnis leeren und Views generieren
Bitte fahren Sie nun mit der Einrichtung des Moduls fort
Update
Ab Oxid 6/7
Bitte aktualisieren Sie zunächst das Basis-Modul gemäß der darin enthaltenen Installationsanleitung.
Entpacken Sie die neue Modulversion in den Ordner
packages/digidesk/couponselling.Deaktivieren Sie das Modul im OXID eShop Admin.
Führen Sie anschließend folgenden Befehl aus dem Hauptverzeichnis des Shopsystems aus:
Die Frage, ob Dateien des Pakets überschrieben werden sollen, bestätigen Sie bitte mit "Y".
Aktivieren Sie das Modul im OXID eShop Admin.
Ggf. Tmp-Verzeichnis leeren und Views neu generieren.
Einrichtung des Moduls
Zunächst sollten Sie einen (oder auch mehrere) Artikel als Gutschein definieren. Legen Sie hierfür einen neuen Artikel an oder verwenden Sie einen bereits vorhandenen Artikel im Shop-Backend unter "Artikel verwalten" -> "Artikel" aus.
Wechseln Sie anschließend auf den Reiter "Erweitert" und setzen den Haken bei den Checkboxen "Versandkostenfrei" und bei "Gutschein". Falls diese Einstellungen nicht gespeichert werden- hilft es eventuell den Shop-Cache zu leeren.
Anschließend speichern.
Unter "Shopeinstellungen" -> "Versandkostenregeln" neue Regel "Gutschein" erstellen. Den Haken bei der Checkbox "Immer aktiv" anklicken und nochmal Speichern.
Auf den Button "Länder zuordnen" klicken, im neu geöffnetem Pop-up-Fenster die gewünschte Länder per Drag & Drop ins Fenster "Zugeordnete Länder" verschieben. Pop-up-Fenster schliessen.
Unter "Shopeinstellungen" -> "Versandarten" neue Versandart "Email" anlegen und Speichern. Den Haken bei der Checkbox "Immer aktiv" anklicken und nochmal Speichern. Auf den Button "Versandkostenregeln zuordnen" klicken, im neu geöffnetem Pop-up-Fenster den Gutschein per Drag & Drop ins Fenster "Zugeordnete Versandkostenregeln" verschieben. Pop-up-Fenster schliessen. (Popups könnten von Ihrem Browser blockiert werden, in diesem Fall muss man die Popups zulassen.)
Auf den Button "Länder zuordnen" klicken, im neu geöffnetem Pop-up-Fenster die gewünschte Länder per Drag & Drop ins Fenster "Zugeordnete Länder" verschieben. Pop-up-Fenster schliessen. Im Reiter "Zahlungsarten" den Button "Zahlungsarten zuordnen" anklicken und im neu geöffnetem Pop-up-Fenster gewünschte Zahlungsarten per Drag & Drop ins Fenster "Zugeordnete Zahlungsarten" verschieben und Pop-up-Fenster schliessen. Auf die eben erstellte Versandart "Email" rechtsklicken und die Adresse des Links kopieren. Der Link beinhaltet unter anderem die ID dieser Versandart, die wir beim nächsten Schritt benötigen.
Den vorhin in die Zwischenablage kopierten Link in einem Texteditor oder in die Browserleiste einfügen und die lange Zeichenfolge ohne die Anführungszeichen in die Zwischenablage kopieren. Der Link könnte z.B. so aussehen: javascript:top.oxid.admin.editThis('af9866c942b236ff154f7968d9f4b36d'); dabei wird nur af9866c942b236ff154f7968d9f4b36d benötigt. Unter "Erweiterungen" -> "Module" auf "digidesk - Bestellbare Gutscheine" klicken, dann im Reiter "Einstellungen" auf "Allgemein" klicken. In das Feld "E-Mail Versandart ID" die ID aus der Zwischenablage einfügen und auf Button "Speichern" klicken.
Unter "Erweiterungen" -> "Module" auf "digidesk - Bestellbare Gutscheine" klicken und dann im Reiter "Einstellungen" unter "Allgemein" im Feld "Erlaubte Zahlungsmethoden" die IDs der Zahlungsmethoden überprüfen und ggf. anpassen. Geben Sie hier die IDs zeilenweise ein. Hier sollten die IDs der Zahlungsarten eingetragen werden, die dem Kunden beim Kauf eines Gutscheins angeboten werden sollen. Die IDs der Zahlungsarten erhalten Sie wie unter Punkt 3 und 4 für die Versandart beschrieben über den Link der benötigten Zahlungsarten. Die Zahlungsarten finden Sie im Backend unter "Shopeinstellungen" -> "Zahlungsarten".
Der Gutschein-Konfigurator kann wie folgend aufgerufen werden:
Im Backend unter "Bestellbare Gutscheine" -> "Vorlagen" rechts oben auf "Gutscheinkonfigurator" klicken

Oder im Shop-Frontend unter folgender Adresse: http://ihreshopdomain.de/index.php?cl=ddcouponconfigurator
Einrichtung der Gutscheine mit frei bestimmbaren Betrag
Zunächst sollte unter Moduleinstellungen die Option Individueller Coupon-Preis aktiviert werden. Im selben Zug können sie andere optionale Einstellungen zum individuellem Coupon-Preis einstellen die selbsterklärend sind:

Als Nächstes sollte man entweder einen neuen Gutschein-Artikel mit einem Preis von 0 anlegen oder bei einem bestehenden Gutschein-Artikel den Preis auf 0 korrigieren. Detaillierte Anleitung zum Anlegen eines Gutschein-Artikels ist weiter oben im Abschnitt Einrichtung des Moduls beschrieben. Jetzt kann der Kunde im Gutscheinkonfigurator seinen Wunschbetrag eintragen, wenn er einen Gutschein mit Wert individuell auswählt. Die Eingaben des Kunden werden validiert und falls die Eingabe nicht korrekt ist, wird ein Hinweis angezeigt.
Backend-Einstellungen
Nach der Modulinstallation finden Sie im OXID eShop Admin den neuen Punkt links in der Leiste "Bestellbare Gutscheine". An dieser Stelle können die Vorlagen für den Gutschein-Konfigurator verwaltet werden. Sie können den Hintergrund bestimmen und die Ausrichtung und Textgröße der einzelnen Textbereiche (Gutscheinwert, Von, Für, Grußtext) festlegen.
In der Vorschau können Sie sich direkt die Änderungen ansehen.

Gutschein-Konfigurator im Frontend
Ihre Kunden können den Gutschein-Konfigurator über folgende URL erreichen: http://ihreshopdomain.de/index.php?cl=ddcouponconfigurator
Hier besteht die Möglichkeit, eines der von Ihnen festgelegten Motive auszuwählen und den Gutschein zu personalisieren. Unter dem Dropdown bei "Wert" werden die von Ihnen als Gutschein-Artikel gekennzeichneten Artikel mit deren Wert (Kaufpreis des Artikels) angezeigt.

Troubleshooting
Derzeit ist keine Versandart für dieses Land definiert.
In der Versandkostenregel "Gutschein" muss eine Menge oder Preis eingestellt werden
Die Versandkostenregel "Gutschein" muss dem Land zugeordnet sein
Die Versandart "Email" muss der Versandkostenregel "Gutschein" zugeordnet sein
Die Versandart "Email" muss den Zahlungsarten zugeordnet sein
Der Zahlungsart müssen Benutzergruppen zugeordnet sein
Es wird im Gutscheinkonfigurator bei "Wert" nichts angezeigt.
Dann wurde kein Gutschein-Artikel festgelegt, siehe Einrichtung des Moduls. Überprüfen Sie ggfs. im Artikel-Reiter "Erweitert" ob der Gutscheinartikel als "Gutschein" markiert ist.
Im Backend wird bei der Vorschau der Gutschein-Designs eine Fehlermeldung angezeigt.
Wenn ein Shop mit einer
.htaccessgeschützt ist, kann das Bild in der Backend-Vorschau nicht geladen werden. Hierzu bitte die Zugangsdaten für die einfache HTTP-Authentifizierung in der Moduleinstellung unter Einstellungen für die Entwicklungsumgebung eintragen.
Hilfe & Support
Haben Sie Fragen oder benötigen Sie Hilfe bei der Installation? Gerne bieten wir Ihnen auch einen Installationsservice an. Kontaktieren Sie uns einfach!
E-Mail: support@digidesk.de
Telefon: +49 (0) 5246 / 9099110
Kontaktformular: http://www.digidesk.de/kontakt
Last updated