DataFirefly Treue & Empfehlung: Bonuspunkte, Stufen und Kunden werben Kunden für PrestaShop

Installation

Installieren Sie das Modul über Module > Modulverwaltung > Modul hochladen mit der ZIP-Datei, oder kopieren Sie den Ordner dfloyalty in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren.

Bei der Installation legt das Modul seine Tabellen an, speichert die Standardeinstellungen, erstellt vier Statusstufen (Bronze, Silber, Gold, Platin) und fügt den Reiter Kunden > Treue & Empfehlung hinzu. Die Schaltfläche Konfigurieren in der Modulverwaltung öffnet direkt die Einstellungen.

Erste Einstellungen

Die Einstellungen sind in Bereiche gegliedert, erreichbar über das Menü links. Bevor Sie das Programm für Kunden öffnen, prüfen Sie mindestens:

• Punkte pro ausgegebener Währungseinheit: standardmäßig 1, also 1 Punkt pro Euro. Dezimalwerte sind möglich (0,5 = 1 Punkt alle 2 Euro).
• Bestellstatus, die die Punkte bestätigen: standardmäßig Zahlung eingegangen, versandt und zugestellt.
• Umrechnungskurs: standardmäßig 100 Punkte = 5 €. Der Kasten links zeigt live den Prozentsatz, der nach der Umwandlung an Kunden zurückfließt.
• Empfehlungsprämien: standardmäßig 10 € für den Freund und 500 Punkte für den Werber.

Punkte sammeln

Berechnung

Die Punkte werden aus den Produktpositionen der Bestellung berechnet, in der Währung des Kunden und dann in die Standardwährung umgerechnet. Versandkosten bringen nie Punkte. Drei Optionen passen die Grundlage an:

• Auf Bruttopreise berechnen: deaktivieren, um auf Nettopreise zu berechnen.
• Gutscheine und Rabatte abziehen: die Warenkorbregeln der Bestellung (außer kostenlosem Versand) werden anteilig von der Grundlage abgezogen.
• Keine Punkte auf bereits reduzierte Produkte: Produkte mit Preisnachlass werden ausgeschlossen.

Danach werden der Multiplikator der Kundenstufe und die Extrapunkte des Produkts angewendet. Das Ergebnis wird abgerundet.

Lebenszyklus der Punkte

• Bei der Bestellung werden die Punkte als ausstehend erfasst. Der Kunde sieht sie im Konto, kann sie aber nicht einsetzen.
• Erreicht die Bestellung einen der bestätigenden Status, werden sie verfügbar.
• Wechselt die Bestellung in einen der stornierenden Status, werden sie entfernt, ob ausstehend oder verfügbar.
• Eine Teilgutschrift zieht den Punkteanteil ab, der dem erstatteten Produktbetrag entspricht.
• Kehrt eine stornierte Bestellung in einen bestätigenden Status zurück, kommen die Punkte zurück.

Jede Bewegung wird in einem Verlauf gespeichert, der nie überschrieben wird: Statt eine Zeile zu ändern, wird eine Korrekturzeile hinzugefügt.

Punkte bei der Registrierung

Die Einstellung Punkte bei der Registrierung schreibt bei jeder Kundenkonto-Erstellung eine feste Punktzahl gut (nicht bei Gastbestellungen). Mit 0 ist sie deaktiviert.

Statusstufen

Der Reiter Stufen listet die Stufen nach Schwelle. Jede Stufe hat einen übersetzbaren Namen und Vorteilstext, eine Schwelle in Statuspunkten, einen Punkte-Multiplikator und eine Farbe für die Mitgliedskarte des Kunden.

Statuspunkte sind die gesammelten Punkte abzüglich Stornierungen und Erstattungen. Das Umwandeln in Gutscheine oder der Verfall von Punkten senkt den Status nicht. Die Einstellung Statuszeitraum begrenzt die Berechnung auf die letzten N Monate; mit 0 zählt alles seit der Registrierung.

Die erste Stufe sollte die Schwelle 0 haben, damit jeder Kunde ab der ersten Bestellung einen Status hat. Erreicht ein Kunde eine neue Stufe, sieht er beim nächsten Besuch der Treueseite eine Glückwunschmeldung.

Kundengruppe der Stufe

Im Formular einer Stufe verknüpft das Feld Kundengruppe dieser Stufe die Stufe mit einer PrestaShop-Gruppe. Das Modul fügt Kunden, die die Stufe erreichen, dieser Gruppe hinzu und entfernt sie, wenn sie die Stufe verlassen. Richten Sie für die Gruppe einen Rabatt ein (Kunden > Gruppen), eine auf die Gruppe beschränkte Warenkorbregel für kostenlosen Versand oder Sonderpreise: Der Vorteil gilt ohne Handarbeit.

• Legen Sie für jede Stufe eine eigene Gruppe an. Ein Kunde, der von Hand in diese Gruppe gesetzt wurde, würde entfernt, wenn er die Stufe nicht hat.
• Die Standardgruppe des Kunden wird nie geändert.
• Die Synchronisierung erfolgt bei jeder Punktebewegung, beim Speichern einer Stufe und täglich mit der geplanten Aufgabe.

Extrapunkte auf Produkte

Im Reiter Bonusprodukte vergeben Sie mehr Punkte auf ausgewählte Produkte. Suchen Sie das Produkt nach Name oder Artikelnummer und wählen Sie:

• Multiplikator: 2 verdoppelt die Punkte dieses Produkts.
• Feste Punkte pro Artikel: eine Punktzahl pro Stück, zusätzlich zu den Standardpunkten.

Start- und Enddatum sind optional. Ohne Daten gilt der Bonus dauerhaft. Die Produktseite zeigt ein Badge (x2, +50) und die zu sammelnden Punkte, neu berechnet, wenn der Kunde die Menge ändert. Der Bonus wird mit dem Stufen-Multiplikator kombiniert.

Punkte in Gutscheine umwandeln

Im Kundenkonto

Im Reiter Prämien der Treueseite wählt der Kunde per Schieberegler, wie viele Punkte er umwandelt, in Vielfachen der Punktzahl des Umrechnungskurses. Er erhält einen persönlichen Gutschein mit dem Code DFPTS-XXXXXXXX, angezeigt in einem Fenster mit Kopier-Schaltfläche und, wenn die Option aktiv ist, per E-Mail zugeschickt.

Direkt im Warenkorb

Ist Kunden erlauben, ihre Punkte direkt im Warenkorb einzulösen aktiv, zeigt der Treueblock im Warenkorb einen Schieberegler. Der Gutschein wird mit einem Klick erstellt und angewendet, höchstens bis zur Produktsumme. Aus diesem Block kann pro Warenkorb ein Punkte-Gutschein angewendet werden. Bereits erzeugte, unbenutzte Gutscheine erscheinen ebenfalls mit einer Schaltfläche Anwenden.

Gutschein-Einstellungen

• Mindestpunktzahl für die Umwandlung: darunter sieht der Kunde einen Fortschrittsbalken bis zum ersten Gutschein.
• Gültigkeit des Gutscheins: in Tagen, standardmäßig 365.
• Mindestwarenkorb für die Einlösung: 0 für kein Minimum.
• Kombinierbarkeit mit anderen Warenkorbregeln: deaktivieren, wenn Treuegutscheine nicht mit Ihren Aktionscodes kombinierbar sein sollen.

Die Gutscheine sind Standard-Warenkorbregeln von PrestaShop, sichtbar unter Katalog > Rabatte, dem Kunden zugeordnet und nur einmal einlösbar.

Kunden werben Kunden

Der Link des Werbers

Jeder Kunde hat einen Empfehlungscode und -link (Parameter ?dfref=CODE auf der Startseite), sichtbar im Reiter Empfehlungen der Treueseite. Er kann den Link kopieren, per WhatsApp, E-Mail, Facebook oder X teilen oder über die Teilen-Funktion seines Smartphones, und über das Formular E-Mail-Einladungen versenden.

Die Ankunft des Freundes

Wer auf den Link klickt, wird für die unter Link-Speicherdauer eingestellte Zeit gespeichert (standardmäßig 30 Tage). Ein dezentes Banner stellt das Geschenk vor, und ein Hinweis begleitet das Registrierungsformular. Bei der Kontoerstellung, auch im Bestellprozess:

• ist die Prämie für den Freund ein Betrag oder ein Prozentsatz, wird ein Gutschein ohne Code erstellt und automatisch in den Warenkorb gelegt, mit dem eingestellten Mindestbestellwert und der Gültigkeit;
• sind es Punkte, werden sie bei der Bestätigung der ersten Bestellung gutgeschrieben.

Code bei der Registrierung

Mit der Option Optionales Feld „Empfehlungscode“ im Registrierungsformular hinzufügen kann ein Freund, der den Code mündlich erhalten hat, ihn bei der Kontoerstellung eingeben. Ein unbekannter Code wird mit einer Fehlermeldung abgelehnt. Das Feld erscheint nicht, wenn der Besucher bereits über einen Empfehlungslink kam.

Die Prämie des Werbers

Der Werber wird belohnt, wenn die erste Bestellung des Freundes einen bestätigenden Status erreicht und ihre Produktsumme brutto den Mindestwert der ersten Bestellung des Freundes erreicht. Er erhält Punkte oder einen Gutschein mit dem Code DFREF-XXXXXXXX sowie eine Dankes-E-Mail.

Schutzmechanismen

• Niemand kann sich selbst werben, auch nicht mit derselben E-Mail-Adresse.
• Eine E-Mail-Adresse, die bereits im Shop bestellt hat, wird keinem Werber zugeordnet.
• Nur die erste bestätigte Bestellung des Freundes zählt. Liegt sie unter dem Minimum, wird die Empfehlung als Nicht berechtigt markiert.
• E-Mail-Einladungen sind pro Kunde und Tag begrenzt, und dieselbe Adresse kann innerhalb von 7 Tagen nicht zweimal eingeladen werden.

Status einer Empfehlung

Eingeladen: E-Mail vom Kunden gesendet. Registriert: Konto über den Link erstellt. Belohnt: erste Bestellung bestätigt, Prämien gewährt. Nicht berechtigt: erste Bestellung unter dem Minimum.

Verfall und geplante Aufgabe

Die Einstellung Verfall nach Inaktivität lässt das Guthaben verfallen, wenn der Kunde in der angegebenen Anzahl Monate keine Punkte gesammelt hat. Jede Bestellung verschiebt das Datum, und der Kunde sieht es im Konto. Mit 0 verfallen Punkte nie.

Der Verfall wird beim Öffnen der Treueseite durch den Kunden und durch die tägliche Aufgabe angewendet, deren URL unter Einstellungen > Wartung steht. Planen Sie sie einmal täglich in Ihrer Cron-Verwaltung oder einem PrestaShop-Cronmodul. Sie versendet außerdem die Verfallserinnerungen, schreibt die Geburtstagspunkte gut und aktualisiert die Gruppen der Stufen. Die Schaltfläche Tägliche Aufgabe jetzt ausführen im Bereich Wartung macht dasselbe.

Die Einstellung Erinnerung vor dem Verfall (standardmäßig 30 Tage) schickt dem Kunden eine E-Mail mit Guthaben, Gegenwert und Verfallsdatum. Pro Verfallsdatum wird eine Erinnerung versendet; bestellt der Kunde zwischendurch, verschiebt sich das Datum und zu gegebener Zeit folgt eine neue Erinnerung.

Mit &resync=1 an der URL werden zusätzlich die Bestellstatus der letzten 7 Tage erneut verarbeitet.

Geburtstag, Newsletter und Aktionen

Geburtstagspunkte

Die Einstellung Geburtstagspunkte schreibt einmal pro Jahr Punkte am im Kundenkonto hinterlegten Geburtsdatum gut, mit einer Glückwunsch-E-Mail. Die Vergabe erfolgt über die tägliche Aufgabe und zusätzlich bei der Anmeldung des Kunden oder beim Öffnen seiner Treueseite. Kunden, die am 29. Februar geboren sind, erhalten sie in Nicht-Schaltjahren am 28. Standardmäßig erhalten nur Kunden mit einer bestätigten Bestellung die Punkte, damit keine Konten nur für das Geschenk angelegt werden.

Punkte für die Newsletter-Anmeldung

Die Einstellung Punkte für die Newsletter-Anmeldung schreibt einmal pro Kunde Punkte gut: bei der Registrierung, wenn das Newsletter-Kästchen angehakt ist, bei einer späteren Anmeldung im Konto oder über den Newsletter-Block in der Fußzeile für eine Adresse, die zu einem Kundenkonto gehört. Abonnenten von vor der Aktivierung der Option erhalten keine rückwirkende Gutschrift.

Punkteaktionen

Der Bereich Punkteaktion vervielfacht alle zwischen zwei Daten gesammelten Punkte: 2 für doppelte Punkte. Der Multiplikator kommt zum Stufen-Multiplikator und zu den Produktboni hinzu. Während der Aktion erscheint ein Badge auf den Produktseiten, im Warenkorbblock und auf der Treueseite. Maßgeblich ist das Bestelldatum: Eine während der Aktion aufgegebene Bestellung behält ihre erhöhten Punkte, auch wenn sie nach dem Ende bestätigt wird.

Kundengruppen ausschließen

Haken Sie unter Einstellungen > Allgemein die vom Programm ausgeschlossenen Kundengruppen an, zum Beispiel Geschäftskunden oder Mitarbeiter. Ein Kunde aus einer dieser Gruppen sammelt keine Punkte, sieht weder die Kachel noch die Treueseite noch die Produkt- und Warenkorbblöcke, und sein Empfehlungslink bringt keine Prämie.

Was der Kunde sieht

• Mein Konto: eine Kachel mit Programmname und Guthaben sowie ein Link im Block Mein Konto der Fußzeile.
• Treueseite: Mitgliedskarte in den Farben der Stufe, Fortschritt, Reiter Prämien, Empfehlungen, Verlauf und Status.
• Produktseite: zu sammelnde Punkte, Wert in Euro, Bonus-Badge. Option Zu sammelnde Punkte auf den Produktseiten anzeigen.
• Warenkorb: Punkte der Bestellung, Guthaben, Punkteeinlösung und verfügbare Gutscheine. Option Punkteblock im Warenkorb anzeigen. Der Block aktualisiert sich bei jeder Änderung des Warenkorbs.
• Bestellbestätigung: gesammelte Punkte, ausstehend oder bereits gutgeschrieben.

Backoffice

Übersicht

Punkte im Umlauf und ihr Wert (die Verbindlichkeit, die die Guthaben darstellen), ausstehende Punkte, Anzahl der Mitglieder, gesammelte und umgewandelte Punkte über 30 Tage mit Diagramm, Mitglieder nach Stufe, erstellte und verwendete Gutscheine, Empfehlungstrichter, Top-Werber und letzte Aktivität.

Mitglieder und Mitgliederakte

Der Reiter Mitglieder listet Kunden mit Punkten, sortiert nach Guthaben. Die Suche umfasst Name, E-Mail, Kunden-ID oder Empfehlungscode und schließt Kunden ohne Punkte ein, damit Sie ihnen Punkte gutschreiben können. Die Mitgliederakte zeigt Guthaben, Stufe, Verlauf, Gutscheine und geworbene Freunde und erlaubt eine manuelle Anpassung: Geben Sie eine positive oder negative Zahl und einen Grund ein, den der Kunde in seinem Verlauf sieht.

Die native Kundenseite von PrestaShop zeigt zudem einen Block mit Guthaben, Stufe, Empfehlungscode und einem Link zur Mitgliederakte.

Bestellseite und Exporte

Auf der Bestellseite im Backoffice zeigt ein Block die Punkte der Bestellung und ihren Status, die angewendeten Boni und Multiplikatoren, die verwendeten Treuegutscheine und ob es sich um die erste Bestellung eines geworbenen Kunden handelt. Der Bereich Mitglieder bietet zwei CSV-Exporte: die Mitgliederliste (Guthaben, Stufe, Statuspunkte, Empfehlungscode) und alle Punktebewegungen. Die Dateien lassen sich direkt in Excel oder LibreOffice öffnen.

E-Mails

Das Modul versendet sechs E-Mails in der Sprache des Empfängers: Einladung eines Freundes, Willkommensgeschenk des Freundes, Prämie des Werbers, aus Punkten erstellter Gutschein, Geburtstagsgruß und Verfallserinnerung. Sie nutzen eine einzige Vorlage in der Akzentfarbe mit dem Shop-Logo. Die Texte stammen aus den Modulübersetzungen, die Vorlage liegt in mails/.

Daten und Deinstallation

Standardmäßig ist Guthaben und Einstellungen bei der Deinstallation des Moduls behalten aktiv: Deinstallieren und Neuinstallieren kostet nichts. Deaktivieren Sie die Option vor der Deinstallation, wenn alle Daten gelöscht werden sollen. Wird ein Kunde in PrestaShop gelöscht, werden seine Punkte, erfassten Gutscheine und Empfehlungen mitgelöscht.

Das Modul arbeitet mit dem offiziellen DSGVO-Modul von PrestaShop zusammen: Der Datenexport eines Kunden enthält seinen Punkteverlauf und seinen Empfehlungscode, und das Löschen eines Kunden über dieses Modul entfernt seine Treuedaten.

Fehlerbehebung

Die Punkte bleiben ausstehend

Prüfen Sie, ob der aktuelle Bestellstatus unter Bestellstatus, die die Punkte bestätigen angehakt ist. Hat ein Mitarbeiter den Status geändert, dessen Profil kein Anzeigerecht für das Modul hat (Erweiterte Einstellungen > Team > Berechtigungen), hat PrestaShop das Modul nicht ausgeführt: Nutzen Sie Bestellungen der letzten 90 Tage neu synchronisieren unter Einstellungen > Wartung. Der Vorgang kann ohne Risiko einer Doppelgutschrift wiederholt werden.

Der Treueblock erscheint nicht im Warenkorb

Der Block wird über den Hook displayShoppingCart angezeigt, der im Theme Classic vorhanden ist. Ruft Ihr Theme ihn nicht auf, fügen Sie {hook h='displayShoppingCart'} in die Warenkorb-Vorlage ein oder kontaktieren Sie uns mit dem Namen des Themes.

Das Empfehlungsbanner erscheint nicht

Es wird nur nicht angemeldeten Besuchern angezeigt, die über einen gültigen Link kommen, und bleibt nach dem Schließen 3 Tage ausgeblendet. Testen Sie in einem privaten Browserfenster.

Einige Texte bleiben auf Englisch

Das Modul wird in 8 Sprachen ausgeliefert. Für eine andere Sprache oder um einen Text zu ändern, nutzen Sie International > Übersetzungen > Übersetzungen installierter Module.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei deckt beide Versionen ab.
• Mehrsprachig und mehrere Währungen. Im Multistore ist das Guthaben eines Kunden in allen Shops gemeinsam.
• Architektur mit ModuleAdminController, ohne Composer-Abhängigkeit.
• Modul und E-Mails übersetzt in Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.