WooCouPoS Benutzerhandbuch

Inhaltsverzeichnis

• Installation
• Schnelleinführung
• Gutscheinvorlagen konfigurieren
• Gutscheinprodukte erstellen
• Gutscheine kaufen
• Gutscheine einlösen
• Gutscheinprotokolle abrufen
• CouPoS Mobile-App einrichten

Installation

WooCoupos ist ein WordPress-Plugin. Es hat folgende Systemvoraussetzungen:

• WordPress-Installation (min. v5.6)
• PHP >= 8.0
• WooCommerce (min v5.0)

Die Installation wird über die WordPress Plugin „Add Plugin“ durchgeführt. Die Funktion findet sich im Menü, links unter Plugin > Add New Plugin:

Mittels der Upload Plugin Funktion, die sich rechts neben der Überschrift findet, kann das Zipfile hochgeladen werden.

Dazu auf den Durchsuchen Button des File-Uploads klicken, das woocoupos.zip File auswählen und die Installation per Klick auf Install Now starten.

Wenn das Plugin erfolgreich installiert wurde, kann es mit einem Click auf Activate Plugin aktiviert werden.

Nach dem Klick auf Activate Plugin landen Sie in der allgemeinen Plugin-Ansicht. Im letzten Schritt müssen Sie den Lizenzschlüssel für das Plugin eingeben. Sie finden oben einen Hinweistext, der einen Link bereitstellt um zur Lizenz-Key-Eingabe zu gelangen.

Die Lizenzeingabe enthält nur die Textbox. Stellen Sie sicher, dass sie nicht versehentlich Zeichen, die nicht zum Lizenzschlüssel gehören, eingeben bzw. hinüber kopieren.

Sie gelangen auch über das Menü Plugins > WooCouPoS Gutscheinsystem zur Eingabe des Lizenzkeys

Schnelleinführung

WooCouPoS erlaubt Ihren Kunden sgn. „Wertgutscheine“ über den Online-Shop zu kaufen. Der Unterschied zwischen „Wertgutscheinen“ und den von Haus aus eingebauten WooCommerce-Gutscheinen ist die Restwertmechanik.

Ein WooCouPoS Wertgutschein verfügt über ein Guthaben und dieses Guthaben kann auf einmal oder auf mehrere Käufe verteilt ausgegeben werden – vorausgesetzt beim Kauf bleibt ein Guthaben übrig.

Für die Verwendung der Gutscheine müssen folgende Konzepte verstanden werden:

• Gutscheinvorlagen bestimmen über die visuelle Gestaltung des Gutscheins und wie dieser im Webshop verwendet werden kann.
• Die Gutscheinprodukte sind die Repräsentation im Shop und können von Kunden gekauft werden.
• Jedes Mal, wenn ein Gutscheinprodukt gekauft wird, wird ein neuer Gutschein für den jeweiligen Kunden erstellt.

Nach der Installation des Plugins finden Sie in der linken Menüleiste einen neuen Eintrag namens WooCouPoS. Darunter verbergen sich die Einträge für die Gutscheinvorlagen sowie die existierenden Wertgutscheine

Die Produkte werden regulär über die WooCommerce Produktkonfiguration erledigt. Diese findet sich darüber unter Products bzw. Produkte.

Auf den jeweiligen Seiten finden Sie alle Funktionen des Plugins.

Gutscheinvorlagen konfigurieren

Eine Gutscheinvorlage ist die visuelle Repräsentation des Gutscheins, die auch per PDF als Email an den Kunden versendet wird. Ein Gutschein kann mehrere Felder anzeigen, die während der Bestellung ausgefüllt werden können bzw. müssen.

Um eine neue Gutscheinvorlage zu erstellen, müssen Sie auf die Gutscheinvorlagen-Seite wechseln und rechts neben der Überschrift auf Vorlage erstellen klicken.

Nach dem Klick landen Sie auf einer Seite, die Ihnen eine leere Vorlage anzeigt:

Darunter finden Sie alle Einstellungen. Sie können zu den jeweiligen Feld-Einstellungen gelangen indem sie auf das Feld in der Vorlage klicken oder auf den Tab darunter.

Im Tab Allgemein finden Sie die Einstellungen um das Hintergrundbild sowie die Größe des Gutscheins zu konfigueren. Für das Bild wird die in WordPress eingebaute Bildverwaltung verwendet.

Wenn das Hintergrundbild ausgewählt wurde, müssen Sie die Größe des Gutscheins an das Bild anpassen.

Neben dieser allgemeinen Einstellung können Sie auch alle angezeigten Felder konfigurieren.

Feld	Beschreibung
Absender	Der Gutschein kann verschenkt werden. In dem Fall würde der Kunde seinen Namen eintragen.   Optionales Feld
Empfänger	Enthält den Namen des Gutscheinempfängers. Wird während der Bestellung eingetragen.   Optionales Feld
Nachricht	Enthält eine zusätzliche Nachricht des Käufers an den Beschenkten. Wird während der Bestellung eintragen.   Optionales Feld
Kaufdatum	Enthält das Datum der Bestellung.   Wird automatisch bei Bestellung erstellt. Pflichtfeld
Gutscheinwert	Enthält den gekauften Gutscheinwert.   Pflichtfeld
Gutscheincode	Enthält den Code der im Online-Shop verwendet werden kann.   Pflichtfeld
Strichcode	Enthält einen Barcode der von der CouPoS-App gescanned werden kann.   Pflichtfeld
Produkt (Titel)	Enthält den Titel des Produkts welches gekauft wurde um den Wertgutschein zu erstellen.   Optionales Feld

Die (optionale) Empfängeremailadresse wird immer angezeigt. Falls Sie dies nicht möchten, können Sie diese per CSS verbergen. Im folgenden Beispiel wurde der Gutschein so konfiguriert, dass der Empfängername als Pflichtfeld eingetragen wurde.

Um die E-Mail-Adresse des Empfängers verstecken zu können, fügen Sie folgendes CSS als „Custom CSS“ ein. Um CSS zu Ihrem Theme hinzu zufügen wählen Sie den Editor Ihres Themes aus Appearance > Editor. Dort wählen Sie Styles aus, und klicken auf das Bleistiftsymbol, um in die Editor-Ansicht zu wechseln.

Dort finden Sie auf der rechten Seite eine Leiste mit einem Punkt Additional CSS. Darauf klicken Sie, um die Eingabemöglichkeit zu erhalten.

Hier fügen Sie nun den CSS-Schnipsel ein:

.voucher-configuration .input-group-sendto {
  display: none !important;
}

Danach klicken Sie auf den blauen Save-Button darüber.

Gutscheinprodukte erstellen

Wenn Sie eine Gutscheinvorlage erstellt haben, müssen Sie sie noch im Onlineshop verfügbar machen. Dazu legen Sie ein neues Produkt an und wählen als Produkttyp Wertgutschein aus.

Stellen Sie sicher, dass Sie die für Ihren Fall passende Steueroption auswählen:

In den regulären Produkteinstellungen können Sie nun auswählen, wie der Gutscheinwert ausgewählt werden soll. Es gibt mehrere Optionen:

• Dropdown-Liste mit Gutscheinwerten
• Fixer Gutscheinwert
• Freie Eingabe zwischen einem Mindest- und Maximalwert

Wenn Sie sich entschieden haben, wie das aussehen soll, wählen Sie die Checkboxen aus. Das Formular passt sich automatisch an die präferierte Variante an.

Falls Sie eine Dropdown-Liste mit Gutscheinbeträgen verwenden wollen, wählen Sie die erste Checkbox aus und fügen die Beträge in der Checkbox ein. Mit der Enter-Taste fügen Sie den Betrag zur Liste hinzu. Jedes Mal, wenn Sie getippt haben, prüft der Editor, ob der Wert gültig ist, und danach können Sie mit Enter den Betrag hinzufügen. Die Prüfung wird mit einem Lade-Indikator in der Textbox visualisiert.

In der Vorlagenauswahl können Sie bestimmen welche visuellen Varianten des Gutscheins verfügbar sein sollen. Eine Mehrfachauswahl ist möglich.

Gutscheine kaufen

Der Prozess einen Gutschein zu kaufen, unterscheidet sich nicht zum Einkauf anderer WooCommerce-Produkte. Der notwendige Ablauf sieht so aus:

1. Kunde bestellt Gutschein
2. Shopowner setzt Bestellstatus auf „Completed“
3. WordPress-Shop erstellt die Gutscheine

Falls Sie bei der Bestellung automatisch den Bestellstatus auf Completed stellen (zB. wenn Sie eine Online-Zahlung verwenden) können Sie dafür ein zusätzliches WordPress-Plugin verwenden.

Autocomplete Woocommerce Orders

Autocomplete WooCommerce Orders

Gutscheine einlösen

Gutscheine können über die Mobile-App Coupos oder über den Online-Shop selbst eingelöst werden. Zum Einlösen im Onlineshop, wird die reguläre Gutscheinmaske des jeweiligen Onlineshop-Themes verwendet:

In der Bestellübersicht wird der jeweilige Gutschein inkl. des verbleibenden Restwerts angezeigt:

Gutscheinprotokolle abrufen

Um die Auswertungen bzw. Protokolle der Aktivitäten herunter zu laden, wechseln Sie auf die Wertgutschein-Seite und klicken auf die Buttons Auswertung herunterladen bzw. Aktivitäten herunterladen.

Sie erhalten beim Klick einen Excel-Download.

In der Tabelle darunter können Sie die Daten auch prüfen. Bei Gutscheinen, die bereits vollständig oder teilweise verwendet wurden, erscheint ein Button Aktivitäten anzeigen. Wenn Sie daraufklicken, erhalten Sie die Benutzer (falls vorhanden) die den Gutschein verwendet haben und wann Sie welchen Betrag eingelöst haben.

Coupos Mobile-App Einrichten

Bei der Installation Ihres WooCommerce-Onlineshops wird auch die Möglichkeit mit installiert WooCommerce-Funktionen über eine sgn. REST-API anderen Anwendungen verfügbar zu machen. Dafür müssen sgn. Schlüssel eingerichtet werden, die aus einem Schlüssel-Code und einem Secret-Code bestehen.

Die Einrichtung funktioniert folgendermaßen:

1. Loggen Sie sich in Ihr WordPress ein.
2. In der Navigationsleiste auf der linken Seite finden Sie die Kategorie WooCommerce. Darin wählen Sie die Option Einstellungen aus.
3. Sie finden eine Leiste mit Tabs. Darin enthalten ist der Tab Erweitert. Klicken Sie darauf.
4. Danach lädt eine Seite mit Optionen und einigen Links darüber. Einer davon lautet REST-API. Klicken Sie darauf.
   
5. Neben der Überschrift “REST-API” finden sie den Button mit der Aufschrift Schlüssel hinzufügen. Klicken Sie darauf, um einen neuen Schlüssel anzulegen.
6. Nun können Sie den Schlüssel anlegen. Wählen Sie einen Benutzer aus, der die notwendigen Berechtigungen hat, um WooCommerce-Gutscheine zu verwalten. Als Beschreibung können Sie einen beliebigen Text eintragen und bei Berechtigung wählen Sie Lesen/Schreiben aus.
7. Auf der folgenden Seite finden Sie den Secret-Code und den Verbraucher-Code. Notieren Sie sich diese.
   

Nachdem Sie die Daten notiert haben ist die Einrichtung abgeschlossen. Der nächste Schritt ist die Einrichtung der Verbindung zu Ihrem Onlineshop in der CouPoS-App.

Sie finden die CouPoS-App sowohl im Google Play-Store wie auch im Apple App Store

Um CouPoS zu konfigurieren tippen Sie auf die drei Striche in der linken Ecke (sgn. Burger-Icon). Danach öffnet sich das Menü mit den verfügbaren Auswahlmöglichkeiten. Hier wählen sie die Option Einstellungen aus.

Nun müssen Sie drei Dinge eintragen:

1. Die URL zu ihrem WooCommerce-Onlineshop. Falls Sie sich unsicher sind, was damit gemeint ist, öffnen Sie Ihren Browser und loggen Sich in Ihr WordPress ein. In der Navigationsleiste des Browsers kopieren Sie nun den Text vor dem wp-admin.
   
2. Den Verbraucher-Code bzw. Consumer-Key
3. Den Secret-Code bzw. das Consumer-Secret.

Um die Codes bzw. URL einzutragen können Sie entweder alles per Tastatur auf Ihrem Smartphone eintragen, oder ein zu CouPoS dazugehörendes Hilfswerkzeug verwenden:

https://keiblinger-services.at/coupos/woocommerce

Auf der Hilfsseite können Sie die URL Ihres WooCommerce-Onlineshops, das Secret sowie den Verbraucher-Key eintragen. Die Seite erstellt automatisch einen QR-Code den Sie mit der CouPoS-App einscannen können.

Dazu tippen Sie einfach auf den Button mit dem Kamerasymbol in der Einstellungsseite.

Nach dem Scan des QR-Codes werden die Einstellungen in der App automatisch übernommen. Stellen Sie sicher, dass bei Verwendetes Gutschein-System WooCommerce Gutscheinsystem von C.H. Werbedesign ausgewählt ist. Danach ist die App bereit, um Gutscheine zu scannen.