Bonuspunkte (JTL-Shop 5)

Owned by Maik Waffen
Last updated: Dec 17, 2024 by Sebastian Meyer
8 min read

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

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

.price_wrapper (Standard)

Einfügemethode

Methode, wie die Punkteanzeige eingefügt wird

Anhängen (append)

Kategorie

Selektor

CSS-Selektor zur Platzierung der Punkteanzeige auf der Kategorie Seite

#buy_form_#kArtikel#.price_wrapper

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

#cart-checkout-btn

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.

#cart-form

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: #account .account-head-data + .row

easyTemplate360: #account .account-head-data + .row + .row

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.

.checkout-items-total-wrapper .checkout-items-total

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:

punktberechnungs_beispiel.png

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

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 mit Bonuspunkten, wenn die gesamte Bestellung storniert wird?

Punkte werden im Standard automatisch zurück gebucht, wenn eine Bestellung storniert wird.

Wann werden die Bonuspunkte gutgeschrieben?

Punkte werden im Standard erst gutgeschrieben, wenn die Bestellung versandt wurde.

Changelog

v1.0.0 (Dezember 2024)

  • Initiales Release

v1.0.1 (Dezember 2024)

  • Verbesserung: Plugin Name im Shop Backend auf deutsch umgestellt

Support und Kontakt

siehe Support und Kontakt