DataFirefly Cart History & Restore Links: Warenkorb-Verlauf und Wiederherstellungslinks

Installation

Installieren Sie das Modul über Module > Modulmanager > Modul hochladen, indem Sie die ZIP-Datei senden, oder kopieren Sie den Ordner dfcartrestore in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren.

Die Installation legt eine Protokolltabelle an (dfcartrestore_log), erzeugt den geheimen Schlüssel, mit dem die Links signiert werden, und fügt dem Kundenkonto die Seite Meine gespeicherten Warenkörbe hinzu. Keine native Tabelle wird verändert: Wiederhergestellte Warenkörbe sind gewöhnliche PrestaShop-Warenkörbe.

Funktionsweise

Ein Wiederherstellungslink überträgt nie einen Warenkorb. Wenn jemand ihn öffnet, liest das Modul die Positionen des Quell-Warenkorbs und legt sie einzeln in den eigenen Warenkorb dieser Person, als würde sie bei jedem Artikel auf „In den Warenkorb“ klicken.

• Der Quell-Warenkorb wird nie verändert, auch wenn er einem anderen Kunden gehört oder zu einer Bestellung gehört.
• Niemand wird im Konto des Warenkorb-Inhabers angemeldet, anders als beim nativen Wiederherstellungslink von PrestaShop.
• Preise, Aktionen, Bestand, Mindestmengen und Bestellbarkeit entsprechen dem Stand zum Zeitpunkt der Wiederherstellung.
• Derselbe Link kann mehrmals und von mehreren Personen verwendet werden.

Wiederherstellungslinks im Backoffice

Warenkorbliste

Unter Kunden > Warenkörbe zeigt die Spalte Wiederherstellungslink für jeden Warenkorb mit Produkten eine Schaltfläche Link kopieren. Der Link wird in die Zwischenablage kopiert, ohne den Warenkorb zu öffnen. Im CSV-Export der Liste enthält diese Spalte die URL im Klartext.

Detailseite des Warenkorbs

Oben auf der Warenkorbseite zeigt eine Box den vollständigen Link mit den Schaltflächen Link kopieren und Öffnen sowie die Anzahl der bisherigen Nutzungen. Ist eine Gültigkeitsdauer eingestellt, wird das Ablaufdatum angezeigt.

Kundenseite

Der Block Warenkörbe und Wiederherstellungslinks listet die letzten 10 nicht leeren Warenkörbe des Kunden mit Datum, Artikelanzahl, Artikelsumme, Bestellstatus und Kopier-Schaltfläche.

Der Link wird in der Sprache und für den Shop des Warenkorbs erzeugt: Ein italienischer Kunde erhält einen Link zur italienischen Version des Shops.

Was die Person sieht, die den Link öffnet

Mit aktivierter Vorschauseite (Standardeinstellung) öffnet der Link eine Seite mit den Artikeln des Warenkorbs, ihren Vorschaubildern und Mengen. Der Besucher klickt auf Diese Artikel in meinen Warenkorb legen, um die Wiederherstellung zu starten, und wird je nach Einstellung zum Warenkorb oder zur Kasse weitergeleitet.

Eine Meldung fasst das Ergebnis zusammen: hinzugefügte Produkte, angewendete Gutscheine, an den Bestand angepasste Mengen und Artikel, die nicht hinzugefügt werden konnten.

Seite Meine gespeicherten Warenkörbe

Der Link Meine gespeicherten Warenkörbe erscheint im Kundenkonto und im Block Mein Konto in der Fußzeile. Die Seite listet die Warenkörbe des Kunden mit Produkten, die neuesten zuerst, jeweils mit:

• dem Datum der letzten Änderung, der Artikelanzahl und der Artikelsumme;
• dem Status Bestellt mit Referenz und Link zur Bestellung oder Nicht bestellt;
• Vorschaubildern der Produkte und aufklappbaren Details, in denen nicht mehr verfügbare Artikel markiert sind;
• der Schaltfläche Diesen Warenkorb wiederherstellen und, falls aktiviert, der Schaltfläche Teilen-Link kopieren.

Der aktuelle Warenkorb des Kunden wird nicht aufgeführt. Im Ersetzen-Modus weist eine Bestätigung darauf hin, dass der aktuelle Warenkorb ersetzt wird und auf derselben Seite wieder zu finden ist.

Einstellungen

Kundenkonto

• Warenkorb-Verlauf im Kundenkonto anzeigen: aktiviert die Seite Meine gespeicherten Warenkörbe und ihre Zugangslinks.
• Verhalten bei der Wiederherstellung: Aktuellen Warenkorb ersetzen legt einen neuen Warenkorb an und lässt den bisherigen im Verlauf; Zum aktuellen Warenkorb hinzufügen führt die Artikel mit den vorhandenen zusammen. Gäste führen immer zusammen, da sie einen ersetzten Warenkorb nicht zurückholen könnten.
• Bereits bestellte Warenkörbe anzeigen: ermöglicht das Nachbestellen derselben Artikel mit einem Klick.
• Warenkörbe pro Seite: 1 bis 50, standardmäßig 10.
• Verlaufszeitraum (Tage): Nur in diesem Zeitraum geänderte Warenkörbe werden angezeigt, standardmäßig 365, 0 ohne Begrenzung.
• Kunden das Kopieren eines Teilen-Links erlauben: nützlich im B2B, wenn ein Einkäufer den Warenkorb vorbereitet und ein Kollege bestellt.
• Nach der Wiederherstellung den Kunden weiterleiten zu: Warenkorbseite oder Kasse. Wurden Artikel angepasst oder übersprungen, führt der Weg immer über die Warenkorbseite, damit der Kunde sie sieht.

Wiederherstellungslinks

• Gültigkeit der Links (Tage): gilt für ab jetzt erzeugte Links, 0 für Links ohne Ablauf.
• Vor der Wiederherstellung eine Vorschauseite anzeigen: empfohlen, siehe Abschnitt Sicherheit.
• Gutscheine übernehmen: Nie, Nur wenn der Kunde über sein Konto wiederherstellt (Standard) oder Immer. Ein Gutschein wird nur angewendet, wenn er für den neuen Warenkorb und dessen Inhaber noch gültig ist. Automatische Regeln ohne Code wendet PrestaShop selbst erneut an.

Link-Sicherheit

Jeder Link enthält die Warenkorb-ID und eine HMAC-SHA256-Signatur, die mit dem geheimen Schlüssel des Moduls berechnet wird. Eine von Hand geänderte ID macht den Link ungültig.

Die Schaltfläche Alle bestehenden Links ungültig machen erzeugt einen neuen geheimen Schlüssel: Alle bis dahin geteilten Links funktionieren nicht mehr, die neuen Links im Backoffice funktionieren normal.

Regeln bei der Wiederherstellung

• Produkt deaktiviert, nicht bestellbar oder nicht im Shop: übersprungen.
• Gelöschte Variante: übersprungen.
• Menge unter der Mindestmenge: auf die Mindestmenge angehoben.
• Bestand zu niedrig und keine Bestellung ohne Lagerbestand erlaubt: Menge auf den verfügbaren Bestand reduziert, sofern die Mindestmenge noch erreicht wird, sonst wird der Artikel übersprungen.
• Personalisiertes Produkt: Texte kopiert, hochgeladene Dateien auf dem Server dupliziert, damit das Löschen der kopierten Position nie die Datei einer Bestellung entfernt.
• Kein Artikel hinzugefügt: Der dafür angelegte Warenkorb wird gelöscht und der aktuelle Warenkorb des Besuchers wiederhergestellt.

Protokoll der Wiederherstellungen

Die Konfigurationsseite zeigt die letzten 30 Wiederherstellungen des Shops: Datum, Herkunft (Link oder Kundenkonto), Quell-Warenkorb, neuer Warenkorb, Kunde oder Gast, Anzahl hinzugefügter und übersprungener Artikel. Die Warenkorbnummern öffnen die jeweilige Seite im Backoffice.

Für Entwickler

• actionDfcartrestoreAfterRestore: wird nach jeder erfolgreichen Wiederherstellung ausgelöst, mit id_cart_source, id_cart und origin (link oder account).
• actionDfcartrestoreCustomizationCopy: wird nach dem Kopieren einer Personalisierung ausgelöst, mit id_customization_source, id_customization, id_cart_source und id_cart. Ein Modul, das eigene Daten pro Personalisierung speichert (Konfigurator, Gravur), dupliziert sie darüber.

Fehlerbehebung

Die Spalte oder Box erscheint bei manchen Mitarbeitern nicht

PrestaShop überspringt die Hooks eines Moduls, wenn das Profil des angemeldeten Mitarbeiters nicht das Recht Anzeigen für dieses Modul hat (Erweiterte Einstellungen > Team > Berechtigungen, Abschnitt Module). Erteilen Sie dieses Recht den betreffenden Profilen.

Der Link zeigt „Dieser Link ist ungültig.“

Der Link wurde vom E-Mail-Programm abgeschnitten, oder alle Links wurden nach dem Versand ungültig gemacht. Kopieren Sie einen neuen Link aus dem Backoffice.

Der Link zeigt „Dieser Link ist abgelaufen.“

Die Gültigkeitsdauer ist überschritten. Kopieren Sie einen neuen Link oder verlängern Sie die Gültigkeit für künftige Links.

Der Link Meine gespeicherten Warenkörbe erscheint nicht im Konto

Prüfen Sie, ob die Option für das Kundenkonto aktiv ist, und leeren Sie den Shop-Cache. Manche Themes zeigen den Hook displayCustomerAccount nicht an; die Seite bleibt unter index.php?fc=module&module=dfcartrestore&controller=carts erreichbar.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei deckt beide Versionen ab.
• Multishop, mehrsprachig und Mehrwährung.
• Keine Composer-Abhängigkeit.
• Oberfläche auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.