Skip to content
This repository was archived by the owner on Jul 25, 2024. It is now read-only.

Einrichtung und Erläuterungen

Dennis Heinrich edited this page Nov 25, 2023 · 2 revisions

Einrichtung

Die Einrichtung des Plugins ist relativ simpel, dennoch sind hier alle notwendigen Schritte vom Herunterladen bis zur fertigen Installation aufgeführt.

Einrichtung von Funktionsattributen

Einrichtung der folgenden Artikel-Funktionsattribute, um Bonuspunkte individuell auf einen Artikel zu vergeben. Dafür geht man in der Warenwirtschaft über das Menü unter der Fensterleiste auf Artikel → Attribute und klickt auf Gruppe anlegen (Name frei wählbar, es wird aber empfohlen dh_bonuspunkte zu nutzen). Dann wird die neu erstelle Gruppe angeklickt. Es muss unbedingt darauf geachtet werden, dass es sich um ein Funktionsattribut handelt. Es darf kein normales Attribut verwendet werden.

Für jedes der hier aufgelisteten Attribute muss nun den kleinen Pfeil geklickt werden um dann “Funktionsattribut” anzuklicken. Dann wird jeweils in dem Feld AttributId der Name aus der Tabelle übertragen. Der Datentyp muss für jedes Funktionsattribut über das Auswahlfeld gesetzt werden. Nach Doppelklick auf den Namen kann der Name bearbeitet werden, eine Empfehlung ist ebenfalls der Tabelle zu entnehmen. Um später den Überblick beizubehalten, haben wir ebenfalls eine Beschreibung zu jedem Attribut definiert, welche Sie in dem unteren Feld eintragen können.

Attribut-ID Datentyp Name Beschreibung
bonuspunkte_pro_artikel_einmal Ganzzahl Bonuspunkte pro Artikel (Einmal) Definiert wie viele Bonuspunkte der Kunde für den Kauf dieses Artikels erhält. Der Kunde erhält für diesen Artikel im Warenkorb die angegebene Summe, aber nur einmal pro Artikel.
bonuspunkte_pro_artikel Ganzzahl Bonuspunkte pro Artikel Definiert wie viele Bonuspunkte der Kunde für den Kauf dieses Artikels erhält. Der Kunde erhält für jeden Artikel im Warenkorb die angegebene Summe.
bonuspunkte_pro_euro Ganzzahl Bonuspunkte nach Euro Definiert wie viele Bonuspunkte der Kunde für den Kauf dieses Artikels erhält, dabei erhält der Kunde jeweils die angegebene Anzahl, welche durch die Summe des Warenkorbs bestimmt wird.
bonuspunkte_reward_in_points Ganzzahl Bonuspunkte für eine einlösbare Prämie Definiert wie viele Bonuspunkte ein Kunde für den Erwerb einer Prämie mit diesem Funktionsattribut eintauschen muss um das Produkt zu erhalten.

Herunterladen und Installieren

  • Das Plugin muss über einen offiziellen Installationsweg heruntergeladen werden. Dies ist in der Regel auf GitHub unter der Seite “Releases”.
  • Das heruntergeladene ZIP-Archiv (”.zip”-Datei) wird in dem Backend der JTL-Shops unter der Seite “Plugin-Manager” und unter dem Reiter “Hochladen” über die Auswahl oder über das Reinziehen der Datei in das Feld hochgeladen.
  • Das Plugin erscheint unter dem Reiter “Verfügbar” und kann dort aktiviert werden. Nach dem Aktivieren des Plugins kann unter dem Reiter “Aktiviert” das Plugin über das Zahnrad-Symbol eingestellt werden.
  • Die Einstellungen haben jeweils ein kleines Informations-Symbol. Durch das bewegen des Mauszeigers auf diese Symbole werden die Einstellungsmöglichkeiten kurz erklärt. Einige der Einstellungen werden auch in dieser Dokumentation nochmal näher erläutert.

Erhalten von Punkten

Erzeugen von Umsatz durch Einkäufe

Durch die Erzeugung von Umsätzen oder dem Kauf von bestimmten Artikeln kann ein Kunde Treuepunkte sammeln. Diese Art der Belohnung wurden nochmal in verschiedene Arten unterteilt, welche entweder mehrfach angewendet können oder es wird sich für eine einzelne Art entschieden.

Pro umgesetzten Euro

Es kann berücksichtigt werden, wie ein Kunde pro umgesetzten Euro mit Punkten im Bonusprogramm belohnt wird. In den Einstellungen kann außerdem gesetzt werden, ob die Punkte auf den Brutto-Preis oder auf den Netto-Preis angerechnet werden sollen. Es werden keine Punkte für Bestellungen gutgeschrieben, welche mit Shop-Guthaben bezahlt worden sind, da eine anteilige Berechnung viel zu aufwändig wäre. Daher wird dies dem Kunden auf seiner Ansichtsseite “Bonuspunkte” angezeigt.

Für Bestellungen, welche eine eingelöste Prämie in Form eines Artikels enthält, bekommt der Kunde seine Punkte gutgeschrieben, da die Prämien den Preis von 0,00€ besitzen und somit auch nicht in die Berechnung fallen. Dies ist daher auch vollkommen beabsichtigt. Punkte dieser Art werden erst nach der Erfüllung einer Reihe von Bedingungen vollständig gutgeschrieben und somit nutzbar für die Einlösung gegen Prämien wie Guthaben oder Artikelbeigaben.

So müssen Bestellungen einen Zahlungseingang erhalten haben, einen Bestellstatus wie Bearbeitet, Teilversandt oder Versandt gesetzt haben und die eingestellte Wartezeit überdauern. Die Wartezeit kann in den Plugin-Einstellungen gesetzt werden und hat den Hintergrund, die Dauer der gesetzlichen Widerrufsfrist abzuwarten.

Was ist der Hintergrund der Wartezeit?

Zwar werden Punkte bei der Stornierung einer Bestellung wieder abgezogen, aber ohne die Wartezeit könnten die Punkte in der Zwischenzeit für Prämien eingelöst werden und somit könnte das Treue- und Bonussystem missbraucht werden.

Der standardmäßige Punktebetrag kann in den Plugin-Einstellungen getroffen werden. Dieser Punktebetrag findet immer Anwendung, sofern der Punktebetrag für einen Artikel nicht über ein Funktionsattribut überschrieben wird. So kann z.B. entweder für alle Produkte ein pauschaler Punktebetrag gutgeschrieben werden und für bestimmte Produkte der Punktesatz erhöht werden. Gegenteilig kann auch für bestimmte Produkte durch das Setzen des Wertes “0” im Funktionsattribut eines Artikels die Punktegutschrift ausgeschlossen werden.

Pro Artikel (einmal pro Position) in der Bestellung

Es kann pro einmaligen Artikel in einer Bestellung (identifiziert durch den sog. “Internen Schlüssel”, auch als “kArtikel” bezeichnet) einmal ein Punktebeitrag pro Bestellposition gutgeschrieben werden. In diesem Fall werden Punkte auch für kostenlose Artikel berechnet, z.B. auch jene, welche durch das Einlösen von Prämien Zustandekommen. Ist dieses Verhalten ungewünscht, so muss in dem jeweiligen Prämien-Artikel der Funktionsattribut-Wert für gutzuschreibende Bonuspunkte auf 0 gesetzt werden.

Pro Artikel (beliebiger Anzahl) in der Bestellung

Es kann pro gekauften Artikel ein pauschaler Punktebetrag gutgeschrieben werden. Dabei wird die Anzahl der gekauften Produkte einer Bestellposition in voller Anzahl bewertet und gutgeschrieben.

Wiederkehrende Besucher

Ein Kunde kann durch den regelmäßigen Besuch der Webseite belohnt werden. Dies setzt Voraus, dass der Kunde in seinem Shop-Konto eingeloggt ist und die Seite in regelmäßigen Abständen besucht. Als Besuch wird der Aufruf einer beliebigen Seite, egal ob Artikel-Detailseite, Kategorie oder Startseite gewertet. Punkte dieser Art werden sofort gutgeschrieben und freigegeben. Diese Punkte sind nicht an die Bedingung der Wartezeit bis zur Freigabe der Punkte geknüpft, welche in den Einstellungen zu finden ist.

Die vorausgesetzten, zeitlichen Abstände sind in den Plugin-Einstellungen einstellbar. Die letzte Zeit an dem Bonuspunkte für diese Aktion gutgeschrieben wurden, werden in einer separaten Datenbank-Tabelle abgelegt und bei der nächsten Abfrage abgefragt, ob der definierte Zeitabschnitt seit der letzten Gutschrift dem Intervall überschritten wurde. So können Intervalle eingestellt werden, so wie diese hier: Jährlich | Monatlich | Wöchentlich | Täglich

Regelmäßiges Anmelden im Konto

Ein Kunde kann durch das regelmäßige Anmelden in seinem Benutzerkonto mit Bonuspunkten belohnt werden. Eine Anmeldung setzt einen tatsächlichen, erfolgreichen Anmeldevorgang mit Eingabe von Benutzername und Passwort voraus. Dies ist z.B. immer dann der Fall, wenn Sie Kunden dazu animieren wollen, regelmäßig Ihre Kontoseite zu überprüfen.

Einmalig nach Registration

Hier kann eingestellt werden, wie viele Punkte ein Benutzer für seine Registration im Shop erhält. Dieser Betrag wird nicht auf bereits erstellte Konten gutgeschrieben. Damit können Sie z.B. Ihre Kunden animieren, sich ein Kundenkonto zu erstellen.

Erhalten von Prämien

Umwandeln von Punkten in Shop-Guthaben

Ein Kunde kann seine Treuepunkte gegen Guthaben im Shop auf der Seite für Bonuspunkte eintauschen. Der Shop-Betreiber kann einstellen, wie viele Punkte für einen Euro benötigt werden und ob der Umtausch in Shop-Guthaben für Kunden erlaubt sein soll.