Wiederkehrende & Geplante Bestellungen — Dokumentation PrestaShop 8 & 9

Was das Modul leistet

Das Modul erlaubt Ihren Kunden, die Wiederholung einer Bestellung im Kundenkonto zu planen: wöchentlich, monatlich, vierteljährlich, jährlich oder in einem frei gewählten Intervall in Tagen.

Vor jedem Termin schickt ein Planer dem Kunden eine E-Mail mit einem sicheren Link. Klickt der Kunde darauf, wird sein Warenkorb genau in diesem Moment neu aufgebaut, und er gelangt in den gewohnten Bestellprozess, in dem er mit der Zahlungsart seiner Wahl bezahlt.

Installation

1. Öffnen Sie im Backoffice Module — Modulmanager und dann Modul hochladen.
2. Legen Sie die gelieferte ZIP-Datei ab, oder kopieren Sie den Ordner dfrecurringorder in das Verzeichnis modules/ Ihres Shops.
3. Klicken Sie auf Installieren. Tabellen, Administrationsreiter und Standardwerte werden automatisch angelegt.
4. Richten Sie die geplante Aufgabe aus dem nächsten Abschnitt ein. Ohne sie geht keine einzige Erinnerungs-E-Mail hinaus.

Das Modul ergänzt ein Menü Bestellungen — Wiederkehrende Bestellungen mit drei Ansichten: der Liste der Planungen, der Versandhistorie und der Konfiguration.

Den Planer einrichten

Das Modul muss einmal täglich aufgerufen werden. Ein täglicher Lauf genügt: Der Planer verarbeitet in einem Durchgang alle fälligen Planungen.

Per URL

Die Konfigurationsseite zeigt die genaue URL inklusive Token. Sie sieht so aus:

https://ihr-shop.tld/module/dfrecurringorder/cron?token=IHR_TOKEN

Diese URL funktioniert mit dem offiziellen PrestaShop-Modul Cron-Aufgaben, mit einem externen Cron-Dienst oder aus einer Server-Crontab:

0 6 * * * wget -q -O - "https://ihr-shop.tld/module/dfrecurringorder/cron?token=IHR_TOKEN"

Über die Kommandozeile

Das ist die empfohlene Methode auf einem dedizierten Server: Sie umgeht die Zeitlimits des Webservers.

0 6 * * * php /pfad/zum/shop/modules/dfrecurringorder/cli/run.php --token=IHR_TOKEN

Die Option --id_shop=N beschränkt den Lauf im Multishop-Kontext auf einen einzelnen Shop. Ohne sie werden alle Shops verarbeitet.

Die Funktion prüfen

Die Konfigurationsseite bietet eine Schaltfläche Planer jetzt ausführen. Sie löst einen sofortigen Durchgang aus und zeigt einen Bericht: verarbeitete Planungen, versendete E-Mails und Fehlschläge. Der URL-Aufruf liefert denselben Bericht als JSON.

Modulkonfiguration

Kundenerlebnis

• Kunden dürfen eigene Planungen anlegen — blendet die Schaltfläche „Diese Bestellung planen“ auf der Bestelldetail- und der Bestätigungsseite ein. Deaktivieren Sie sie, wenn Sie Planungen lieber selbst im Backoffice anlegen.
• Maximale Anzahl Planungen pro Kunde — 0 für unbegrenzt. Standard ist 20.
• Mindestabstand in Tagen — verhindert zu dicht aufeinanderfolgende Planungen.

Verfügbare Rhythmen

Jeder Rhythmus lässt sich einzeln aktivieren oder deaktivieren: täglich, wöchentlich, zweiwöchentlich, monatlich, zweimonatlich, vierteljährlich, halbjährlich, jährlich und benutzerdefiniert in Tagen. Im Kundenformular erscheinen nur die aktivierten Rhythmen.

Standardmäßig sind wöchentlich, zweiwöchentlich, monatlich, zweimonatlich, vierteljährlich, halbjährlich und jährlich aktiv. Täglich und das benutzerdefinierte Intervall sind ausgeschaltet, da sie vor allem für bestimmte B2B-Fälle taugen.

E-Mails und Zahlungslink

• E-Mail X Tage vor dem Termin senden — Standardwert für neue Planungen. Der Kunde kann ihn für seine eigene anpassen. Drei Tage sind ein guter Ausgangspunkt: früh genug zum Reagieren, spät genug, um präsent zu bleiben.
• Gültigkeitsdauer des Zahlungslinks — in Tagen, standardmäßig 14. Danach zeigt der Link eine Ablaufmeldung und lädt den Kunden ein, im Konto einen neuen zu erzeugen.
• Nicht verfügbare Produkte überspringen — standardmäßig aktiv. Siehe Abschnitt Sonderfälle.
• Kopie an den Händler senden — in der Einführungsphase nützlich, um die tatsächliche Darstellung der E-Mails zu prüfen.

Planer

• Planungen pro Lauf — standardmäßig 50. Erhöhen Sie den Wert, wenn Ihr Tagesvolumen darüber liegt, oder starten Sie den Cron mehrmals täglich.
• Alle Daten bei der Deinstallation löschen — standardmäßig aus. Siehe Abschnitt Deinstallation.

Kundenseite: eine Bestellung planen

Der Ablauf beginnt immer bei einer bereits getätigten Bestellung. So sind Produkte, Adresse und Versandart von vornherein stimmig.

1. Der Kunde öffnet eine Bestellung in seiner Historie oder bleibt direkt nach dem Kauf auf der Bestätigungsseite.
2. Er klickt auf Diese Bestellung planen.
3. Er passt bei Bedarf die Mengen an. Eine Menge von 0 entfernt das Produkt aus der Planung.
4. Er wählt seinen Rhythmus, das Datum der nächsten Bestellung und optional ein Enddatum oder eine maximale Anzahl an Bestellungen.
5. Er speichert. Eine Bestätigungs-E-Mail fasst die Planung zusammen.

Die Planung erscheint anschließend unter Mein Konto — Meine geplanten Bestellungen. Dort kann der Kunde jederzeit:

• Rhythmus, Datum oder Mengen ändern;
• pausieren und später reaktivieren, wobei der nächste Termin in die Zukunft neu berechnet wird;
• die Planung endgültig löschen;
• auf Jetzt bestellen klicken, um seinen Warenkorb sofort auszulösen, ohne den Termin abzuwarten.

Händlerseite: Planungen verfolgen

Liste der wiederkehrenden Bestellungen

Sie zeigt je Planung den Kunden, den Rhythmus, die Anzahl Produkte, den nächsten Termin, wie viele E-Mails bereits versendet wurden, wie viele Bestellungen tatsächlich zustande kamen, und den Status. Die Spalte mit den Bestellungen ist die aussagekräftigste Kennzahl: Sie zeigt, wie viele Planungen sich wirklich in Umsatz verwandeln.

In der Detailansicht einer Planung lässt sich der Zahlungslink sofort an den Kunden senden — praktisch im Support, wenn ein Kunde meldet, seine E-Mail nicht erhalten zu haben.

Versandhistorie

Jeder erzeugte Link führt zu einer Zeile in der Historie, deren Status sich im Verlauf ändert:

• Gesendet — die E-Mail ist raus, der Link wurde noch nicht geöffnet.
• Link geöffnet — der Kunde hat geklickt, ein Warenkorb wurde aufgebaut.
• In Bestellung umgewandelt — aus dem Warenkorb wurde eine Bestellung. Die Bestellnummer wird automatisch verknüpft.
• Abgelaufen — die Gültigkeit verstrich ohne Bestellung.
• Fehler — der E-Mail-Versand ist fehlgeschlagen. Prüfen Sie die E-Mail-Konfiguration des Shops.

In der Bestellansicht

Ein Panel am Fuß der Bestellansicht listet die aus dieser Bestellung erstellten Planungen mit direktem Zugriff auf ihr Detail.

Wie der Zahlungslink funktioniert

Wer diesen Ablauf kennt, beantwortet Kundenfragen deutlich schneller.

1. Beim Versand der E-Mail legt das Modul keinen Warenkorb an. Es erzeugt lediglich ein zufälliges Token aus 48 Zeichen, einmalig nutzbar und mit Zeitstempel.
2. Klickt der Kunde, prüft das Modul das Token und dessen Ablaufdatum.
3. Ist der Kunde nicht angemeldet, wird er auf die Standard-Anmeldeseite geleitet und danach automatisch zu seinem Link zurückgeführt. Der Link authentifiziert den Besucher nie von sich aus.
4. Nach der Identifizierung wird der Warenkorb aus der Planung aufgebaut, mit den Preisen, Aktionen, Warenkorbregeln und Beständen des Moments.
5. Der Kunde gelangt in den Bestellprozess. Ein zweiter Klick auf denselben Link nutzt den bereits erstellten Warenkorb weiter, solange daraus keine Bestellung wurde.

Sonderfälle

Produkt zum Termin nicht verfügbar

Mit aktivierter Option Nicht verfügbare Produkte überspringen wird das betroffene Produkt einfach ausgelassen, die übrigen Artikel bleiben bestellbar. Der Warenkorb wird nur abgelehnt, wenn kein einziges Produkt verfügbar ist: Der Kunde sieht dann eine Meldung mit der Bitte, Sie zu kontaktieren oder seine Planung anzupassen.

Deaktivieren Sie die Option, blockiert ein Fehlbestand den Neuaufbau. Dieses Verhalten passt zu Shops, deren Bestellungen vollständig oder gar nicht rausgehen sollen.

Zwischen zwei Terminen gelöschte Adresse

Wurde die in der Planung hinterlegte Lieferadresse vom Kunden gelöscht, wechselt das Modul automatisch auf dessen erste verfügbare Adresse. Die Rechnungsadresse folgt derselben Logik. Der Kunde kann die Adresse im Bestellprozess jederzeit ändern.

Monatsenden

Eine am 31. Januar gestartete monatliche Planung driftet nicht. Das Modul zieht das Datum auf den letzten Tag des Monats zurück, wenn dieser kürzer ist: den 28. oder 29. Februar, dann den 31. März. Der ursprüngliche Tag bleibt gespeichert und geht damit nie verloren.

Multishop

Jede Planung ist an den Shop gebunden, in dem sie angelegt wurde. Die E-Mails gehen mit der Identität dieses Shops raus, und der Zahlungslink zeigt auf dessen Domain.

Ende einer Planung

Eine Planung endet automatisch, wenn das Enddatum überschritten oder die maximale Anzahl an Bestellungen erreicht ist. Sie wechselt dann in den Status Beendet und versendet keine E-Mails mehr, bleibt aber in der Historie einsehbar.

E-Mails anpassen

Das Modul liefert zwei Vorlagen auf Französisch und Englisch, jeweils als HTML- und Textversion:

• dfro_reminder — die Erinnerung vor jedem Termin, mit dem Zahlungslink.
• dfro_created — die Bestätigung beim Anlegen einer Planung.

Bearbeiten lassen sie sich über Design — Theme und Logo — E-Mails oder direkt im Ordner mails/ des Moduls. In der Erinnerung stehen folgende Variablen zur Verfügung: Vor- und Nachname des Kunden, Bezeichnung und Rhythmus der Planung, Datum der nächsten Bestellung, Produkttabelle, geschätzte Summe, Zahlungslink, Verwaltungslink, Gültigkeitsdauer des Links und Shopname.

Fehlerbehebung

Es wird keine E-Mail versendet

Prüfen Sie in dieser Reihenfolge: ob die geplante Aufgabe wirklich läuft, ob das Token in der Crontab dem in der Konfiguration angezeigten entspricht, ob mindestens eine aktive Planung ihren Termin erreicht hat, und ob der Shop überhaupt E-Mails versenden kann. Die Schaltfläche Planer jetzt ausführen grenzt das Problem schnell ein: Versendet sie die E-Mails, liegt es an der geplanten Aufgabe.

Der Link zeigt „Ungültiger Link“

Das Token existiert nicht oder wurde vom E-Mail-Programm abgeschnitten. Erzeugen Sie in der Detailansicht der Planung im Backoffice einen neuen Link.

Der Kunde landet immer wieder auf der Anmeldeseite

Das passiert, wenn der Link mit einem anderen als dem Empfängerkonto geöffnet wird. Der Kunde muss sich abmelden und den Link erneut öffnen.

Der neu aufgebaute Warenkorb ist leer

Alle Produkte der Planung sind deaktiviert oder nicht auf Lager. Prüfen Sie ihren Zustand im Katalog, oder deaktivieren Sie vorübergehend das Überspringen nicht verfügbarer Produkte, um die Diagnose eindeutig zu machen.

Deinstallation

Standardmäßig bleiben Tabellen und Planungen bei der Deinstallation erhalten. Eine spätere Neuinstallation findet also sämtliche Daten wieder vor. Um alles zu entfernen, aktivieren Sie vor der Deinstallation die Option Alle Daten bei der Deinstallation löschen.