Einleitung
Das Bonuspunkte Plugin für JTL-Shop 5 bietet Ihrem Online-Shop eine flexible und leistungsstarke Möglichkeit, Kunden für ihre Treue zu belohnen. Es ermöglicht Ihnen, ein Bonussystem zu implementieren, bei dem Kunden für Einkäufe Bonuspunkte sammeln können, die nach Versand eingelöst werden können.
Features
Punktesystem: Kunden sammeln automatisch Punkte bei jedem Einkauf, sofern ihre Kundengruppe für das Sammeln von Punkten berechtigt ist.
Flexible Berechnung: Sie können zwischen verschiedenen Berechnungsmethoden für die Punkte wählen (proportional, maximal).
Individualisierbare Regeln: Legen Sie fest, wann und wie Punkte gutgeschrieben werden, z.B. erst nach Versandt.
Anbindung an JTL-Wawi: Automatische Synchronisation der Bonuspunkte zwischen JTL-Shop und JTL-Wawi, um die Verfügbarkeit der Punkte nach Versand zu steuern.
Punktesperrung: Punkte können bis zur Freigabe gesperrt werden.
Import/Export Funktionalität: Verwaltung der Bonuspunktetransaktionen mittels CSV-Import und -Export für eine leichtere Buchhaltung.
Installation / Update
Systemvoraussetzungen
JTL-Shop 5 Version 5.1.5+ und dessen Voraussetzungen.
Plugin-Installation
Die Installation des Plugins erfolgt nach JTL-Standard, wie es hier beschrieben ist oder sie können Ihre vorhandene ZIP-Datei des Plugins auch über den Reiter “Upload“ in der Pluginverwaltung bereitstellen und anschließend im Reiter “Vorhanden“ die Installation starten.
Plugin-Update
Bei einem Update auf eine neuere Version können Sie der allgemeinen Installation folgen mit dem Unterschied, dass Sie direkt in der Pluginverwaltung den Update-Button zur Aktualisierung betätigen müssen.
Konfiguration
Shop
Die Konfiguration des Bonuspunkte Plugins ermöglicht es Ihnen, verschiedene Einstellungen vorzunehmen, um das Verhalten des Plugins an Ihre Bedürfnisse anzupassen.
Einstellungen Allgemein
Die folgende Tabelle gibt einen Überblick über die konfigurierbaren Optionen
Einstellung | Beschreibung | Mögliche Werte |
|---|---|---|
Plugin aktivieren | Aktiviert oder deaktiviert das Plugin | ein / aus |
Bonuspunkte bei stornierten Bestellungen automatisch abziehen | Automatischer Abzug von Punkten bei Stornierung einer Bestellung | ein / aus |
Punkte nach Versand der Bestellung freigeben | Punkte nach Versand der Bestellung in der Wawi freigeben. | ein / aus |
Kundengruppen | Kundengruppen die Punkte sammeln dürfen. | Endkunden, Händler (Wawi einstellbar) |
Artikeldetail | ||
Selektor | CSS-Selektor zur Positionierung der Punkteanzeige auf der Artikeldetailseite |
|
Einfügemethode | Methode, wie die Punkteanzeige eingefügt wird | Anhängen (append) |
Kategorie | ||
Selektor | CSS-Selektor zur Platzierung der Punkteanzeige auf der Kategorie Seite |
|
Einfügemethode | Methode, wie die Punkteanzeige eingefügt wird | Anhängen (append) |
Warenkorb | ||
Selektor - Hinweise für erwartete Bonuspunkte | CSS-Selektor für die Anzeige der erwarteten Bonuspunkte im Warenkorb |
|
Einfügemethode - Hinweise für erwartete Bonuspunkte | Methode, wie die Warenkorbhinweise eingefügt werden | Voranstellen (before) |
Selektor - Bonuspunkte einlösen | Der CSS-Selektor an dem die 'Bonuspunkt einlösen'-Funktion im Warenkorb angezeigt wird. |
|
Einfügemethode - Bonuspunkte einlösen | Methode, wie die die 'Bonuspunkt einlösen'-Funktion im Warenkorb eingefügt werden. | Anhängen (append) |
Kundenkonto | ||
Selektor | CSS-Selektor für die Anzeige der Punkte im Kundenkonto | Nova Template: easyTemplate360: |
Einfügemethode | Methode, wie die Anzeige der Punkte im Kundenkonto eingefügt werden. | Anhängen (append) |
Checkout | ||
Selektor | CSS-Selektor für die Anzeige der Punkte im Checkout. |
|
Einfügemethode | Methode, wie die Punkteanzeige eingefügt wird | Anhängen (append) |
Einstellungen Berechnung
In diesem Abschnitt können Sie die Parameter für die Berechnung der Bonuspunkte festlegen. Folgende Einstellungen sind verfügbar:
Einstellung | Beschreibung | Mögliche Werte |
Wert pro Bonuspunkt | Legt den Wert eines einzelnen Bonuspunktes fest | Numerischer Wert (z.B. 1) |
Punktberechnungsmethode | Methode, die zur Berechnung der Punkte verwendet wird | Maximale Punkte auf gesamten Warenkorbwert / Proportionale Punkte |
Preis-Basis für Bonuspunktberechnung | Grundlage zur Berechnung der Bonuspunkte (Brutto- oder Nettopreise) | Bruttopreise / Nettopreise |
Sperrfrist (in Tagen) für neu gutgeschriebene Bonuspunkte | Anzahl der Tage, nach denen neu gutgeschriebene Punkte verfügbar sind | Numerischer Wert (z.B. 0, 7) |
Berücksichtigung von Gutschriften bei Bonuspunktberechnung | Bestimmt, ob Gutschriften bei der Berechnung der Bonuspunkte berücksichtigt werden | Bonuspunkte für kompletten Warenkorbwert vor Abzug von Gutschriften berechnen / Nach Abzug berechnen |
Bonuspunkte / Warenkorbwert Skalierungen
Die Skalierungen ermöglichen es, Bonuspunkte basierend auf bestimmten Warenkorbwerten zu vergeben.
Skalierungen sind Regeln, die festlegen, wie viele Bonuspunkte basierend auf bestimmten Schwellenwerten des Warenkorbwerts vergeben werden. Dies ermöglicht eine flexible Anpassung des Punktesystems, sodass Kunden für höhere Warenkorbwerte mehr Punkte sammeln können. Um eine neue Skalierung hinzuzufügen, geben Sie den gewünschten Warenkorbwert und die Anzahl der Punkte pro Einheit ein und klicken Sie auf "Erstellen".
Durch die Skalierungen kann der Händler Promotions aufsetzen, die Kunden dazu motivieren, höhere Warenkorbwerte zu erreichen, um mehr Punkte zu erhalten. Dies unterstützt eine flexible Belohnungsstrategie, die direkt im Admin-Bereich angepasst werden kann.
Beispiel :
Anhand der Einstellungen aus der Tabelle:
Ab €0 warenkorbwert gibt es 1 Punkt pro Einheit. Ab €100 gibt es 2 Punkte pro Einheit.
Beispiel 1: Maximale Punkte auf gesamten Warenkorbwert
Eingabe: Warenkorbwert = €150
Funktionsweise: Es wird nur die höchste zutreffende Skala angewendet. In diesem Fall die Skala ab €100 (2 Punkte pro Einheit).
Berechnung: €150 × 2 Punkte = 300 Punkte
Beispiel 2: Proportionale Punkte
Eingabe: Warenkorbwert = €150
Funktionsweise: Der Wert wird proportional auf die verschiedenen Skalen aufgeteilt :
Für die ersten €100 gilt 1 Punkt pro Einheit.
Für die restlichen €50 gilt 2 Punkte pro Einheit.Berechnung: (€100 × 1 Punkt) + (€50 × 2 Punkte) = 100 + 100 = 200 Punkte
ERP-System
Synchronisation: Stellen Sie sicher, dass die Synchronisation (Worker) mit JTL-Wawi eingerichtet ist, um die Punkteverwaltung nahtlos zu halten. Die Konfiguration "Punkte direkt nach Versand freigeben" erlaubt es, dass Punkte automatisch verfügbar sind, wenn eine Bestellung in der JTL-Wawi versandt wird.
Betrieb
Punkte sammeln: Kunden sammeln automatisch Bonuspunkte durch Käufe.
Punkteanzeige im Shop: Die Bonuspunkte werden im Shop an verschiedenen Stellen angezeigt:
Kategorieseite: Unter jedem Artikel auf der Kategorieseite wird angezeigt, wie viele Bonuspunkte der Kunde beim Kauf erhält.
Artikeldetailseite: Auf der Artikeldetailseite wird ebenfalls dargestellt, wie viele Punkte beim Kauf dieses Artikels gesammelt werden.
Warenkorb: Im Warenkorb wird angezeigt, wie viele Bonuspunkte für den gesamten Einkauf vergeben werden.
Kundenkonto: Im Kundenkonto sieht der Kunde eine Übersicht über seine gesammelten Punkte und die Verfügbarkeit dieser Punkte.
Begriffsklärung / Glossar
Bonuspunkt: Eine Belohnungseinheit, die der Kunde für bestimmte Aktionen erhält.
Punktesperrung: Vorübergehende Blockierung von Punkten, bis bestimmte Bedingungen erfüllt sind (z.B. Zahlungsabschluss).
Sperrfrist: Die Sperrfrist (blockDays) Funktionalität definiert eine Zeitspanne, in der neu gutgeschriebene Punkte blockiert sind, bis bestimmte Bedingungen erfüllt sind. Dies kann beispielsweise der Versand oder die Bezahlung der Bestellung sein. Die Sperrfrist beginnt, sobald die entsprechenden Bedingungen erfüllt wurden, und stellt sicher, dass Kunden die Bonuspunkte erst nutzen können, wenn keine Rückerstattung oder Stornierung mehr zu erwarten ist. Die Anzahl der Tage für die Sperrfrist kann in den Berechnungseinstellungen angepasst werden.
Shop
Die Verwaltung der Bonuspunkte erfolgt über mehrere Tabs im Admin Bereich:
Einstellungen Allgemein
Allgemeine Einstellungen des Plugins: Aktivierung, automatische Abzüge, und Festlegung der Kundengruppen, die Punkte sammeln dürfen.
Einstellungen Berechnung
Punkteberechnung: Hier legen Sie die Parameter zur Berechnung der Punkte fest, einschließlich der Preis-Basis und eventueller Sperrfristen.
Bonusskalierungen: Verwaltung der Warenkorbwert-Skalierungen, um unterschiedliche Punkte je nach Warenkorbwert zu vergeben. Diese Einstellungen sind zentral für die Promotionstrategie des Shops.
Gutschriften Verwaltung
Transaktionsübersicht: Der Tab zeigt alle Transaktionen, die Bonuspunkte betreffen, in einer Tabelle. Administratoren können hier Punktestornierungen durchführen.
Import/Export Funktionalität: Ermöglicht den Import und Export von Transaktionsdaten. Diese Funktion ist nützlich für Berichte und für die Verwaltung großer Datenmengen.
Punkteabwicklung bei Stornierungen der ganzen Bestellung: Bei der Stornierung von Bestellungen werden automatisch die entsprechenden Punkte vom Kundenkonto abgezogen. Jede Stornierung wird dabei als "Storno-Transaktion" erfasst, sodass die Historie der Punktebewegungen stets nachvollziehbar ist.
Storno bei Retouren einzelner Artikel in einer Bestellung: Wenn einzelne Artikel einer Bestellung zurückgegeben werden, müssen die Punkte für die retournierten Artikel eigenständig mittels einer negativen manuellen Gutschrift zurück gebucht werden.
Manuelle Gutschrift
Manuelle Punktevergabe: Ermöglicht manuelle Bonuspunkte Gutschriften für Kunden. Geben Sie einfach die Kunden-E-Mail-Adresse und die Anzahl der Punkte ein und klicken Sie auf "Bonuspunkte gutschreiben".
ERP-System
Automatische Abbuchung: Punkte werden automatisch vom Kundenkonto abgezogen, sobald sie eingelöst werden.
Punktfreigabe nach Versand: Die Punkte können automatisch freigegeben werden, nachdem eine Versand in der JTL-Wawi bestätigt wurde. Diese Option wird durch die Einstellung "Punkte direkt nach Versand freigeben" gesteuert.
Individualisierung
Sprachvariabelen
Variable Name | Description | German Translation | English Translation |
|---|---|---|---|
s360Bonuspoints_basket_ImmediatePointsAvailable | Points available | Anzahl Punkte sofort verfügbar. | Number of points immediately available. |
s360Bonuspoints_pointname | Bonuspoints name | Bonuspunkte | Bonuspoints |
s360Bonuspoints_basket_useBonus | Redeem | einlösen | redeem |
s360Bonuspoints_basket_PointsAvailableOnHold | Bonuspoints available on hold | Anzahl Punkte demnächst verfügbar | Number of points available soon |
s360Bonuspoints_bonuspointValueLabel | Bonuspoints | Wert pro Bonuspunkt | Value per bonus point |
s360Bonuspoints_basket_amount | Basket amount | Anzahl | amount |
s360Bonuspoints_receiveWithPurchase | receiveWithPurchase | Sie erhalten beim Kauf | receive with purchase |
s360Bonuspoints_atLeast | At least | mindestens | at least |
s360Bonuspoints_placingOrder | Placing order | Bei Aufgabe dieser Bestellung werden Ihnen | Upon placing this order, you will be |
s360Bonuspoints_placingOrderCredited | Placing order | gutgeschrieben | credited |
s360Bonuspoints_unknownerror | Unknown error | Es ist ein unbekannter Fehler aufgetreten. Bitte wenden Sie sich an den Support!. | An unknown error has occurred. Please contact support! |
s360Bonuspoints_amount | Amount | Menge | Amount |
s360Bonuspoints_redeemsucces | Redeem success message | Es wurden %s %s eingelöst. | %s %s have been redeemed. |
s360Bonuspoints_redeemfailed | Redeem failed/max message | Es können nur maximal %s %s eingelöst werden. | Only a maximum of %s %s can be redeemed. |
Templates
Templates können individuell angepasst werden. Die _custom.tpl Dateien werden verwendet, wenn sie vorhanden sind, um die Standardvorlagen zu überschreiben. Dies ermöglicht eine flexible Anpassung des Designs und der Darstellung der Bonuspunkte auf den verschiedenen Seiten des Shops.
Troubleshooting
Logs prüfen
Um herauszufinden, wo ein Problem liegt, helfen Ihnen und uns die Logs. Je nach Fehlerbild ist eines der folgenden 3 Logs dafür mehr oder weniger relevant.
Browser-Log
Das Browser-Log ist meist relevant, wenn irgendwas im Frontend des Shops sich merkwürdig verhält oder nicht reagiert. (Beispiel: Sie klicken einen Button und augenscheinlich passiert gar nichts.)
Das Browser-Log sehen Sie, wenn Sie im Browser F12 drücken und dort dann auf Konsole (oder Console) wechseln.
Shop-Log
Das Shop-Log ist immer dann interessant, wenn im Frontend unerwartete Fehlermeldungen ausgegeben werden oder das Plugin zwar auf Eingaben im Frontend reagiert, aber nicht das Ergebnis liefert, was erwartet wurde. Manchmal ergibt sich auch durch das Browser-Log, dass die Informationen eher im Shop-Log zu suchen sind.
Das Shop-Log finden Sie im JTL-Adminbereich unter System → Wartung → Log.
Das JTL-Log arbeitet mit Log-Levels, um nicht die Datenbank unbegrenzt mit Logdaten zu befüllen. Im Umkehrschluss heißt das, dass Sie Logmeldungen aber auch erst dann sehen, wenn diese nach der Änderung des Loglevels erzeugt worden sind.
Das Plugin loggt außer kritischer Fehler fast ausschließlich im Debug-Log-Level. Wenn also etwas nicht klappt, sollten Sie zunächst das Debug-Loglevel aktivieren, dann eine Testbestellung durchführen, dann das Debug-Loglevel wieder deaktivieren und die zwischenzeitlich geloggten Meldungen zurate ziehen.
Webserver-Log
Das Webserver-Log wird dann relevant, wenn Sie irgendwo auf einen Error 500 (= weiße Seite) stoßen.
Das Webserver-Log kann Ihnen Ihr Hoster zur Verfügung stellen.
In der Standardkonfiguration loggt der JTL-Shop überhaupt nichts in das Webserverlog, nicht mal kritische Fehler wie einen Error 500.
Damit der Shop diese Fehler loggt, müssen in der /includes/config.JTL-Shop.ini.php die einzelnen *_LOG_LEVEL Werte von 0 auf E_ERROR geändert werden.
Achtung: Editieren Sie die Config-Datei des Shops nur, wenn Sie wissen, was Sie tun! Fehlerhafte Anpassungen hier können Ihren Shop unerreichbar oder (verschlüsselte) Daten unbrauchbar machen. Im Zweifelsfall sollten Sie Ihren Hoster oder Servicepartner um Hilfe fragen.
FAQ
Was passiert, wenn ich xy mache?
Punkte nach Stornierung: Punkte werden automatisch zurückgebucht, wenn eine Bestellung storniert wird.
Wann werden Punkte gutgeschrieben?: Punkte werden erst gutgeschrieben, wenn die Bestellung bezahlt und/oder versandt wurde, je nach Konfiguration.
Changelog
v1.0.0 (Dezember 2024)
Initiales Release
Support und Kontakt
siehe Support und Kontakt