Geschätztes Lieferdatum — Vollständige Anleitung

Überblick

DataFirefly Delivery Date zeigt ein geschätztes Lieferdatum auf der Produktseite, im Warenkorb und im Checkout Ihres PrestaShop-8- oder -9-Shops an. Die Berechnung kombiniert vier Faktoren: die produktspezifische Vorbereitungszeit, die Lieferspanne des Versanddienstleisters (Min/Max-Werktage), Wochenenden und Feiertage sowie Ihre tägliche Cutoff-Zeit. Vor dem Cutoff zeigt ein Live-Countdown dem Kunden, wie lange er noch für einen Versand am selben Tag Zeit hat.

Installation

1. Öffnen Sie in Ihrem PrestaShop-Backoffice Module → Modul-Manager → Ein Modul hochladen.
2. Laden Sie die Datei dfdeliverydate.zip hoch.
3. Klicken Sie auf Installieren und anschließend auf Konfigurieren.

Die Installation erstellt drei Tabellen (ps_dfdeliverydate_product, ps_dfdeliverydate_carrier, ps_dfdeliverydate_holiday), registriert die benötigten Hooks, fügt einen Verwaltungs-Tab für Feiertage hinzu und legt die acht französischen Nationalfeiertage als jährlich wiederkehrende Einträge an.

Allgemeine Konfiguration

Unter Module → Modul-Manager → DataFirefly Delivery Date → Konfigurieren bündelt das erste Panel die globalen Einstellungen:

• Cutoff-Stunde und -Minute — die Bestellfrist für den Versand am selben Tag (Standard 14:00).
• Versand-Zeitzone — PHP-Zeitzonen-String, Standard Europe/Paris. Alle Datumsberechnungen laufen in dieser Zeitzone, unabhängig von der Zeitzone des Servers.
• Standard-Vorbereitungstage — gelten für alle Produkte ohne spezifischen Wert.
• Standard Min/Max-Tage des Versanddienstleisters — verwendet, wenn ein Versanddienstleister keine eigene Spanne hat.
• Wochenend-Ausschluss — schließt Samstag und Sonntag aus der Berechnung aus. Wenn deaktiviert, können Sie nur den Sonntag ausschließen (nächste Option), falls Sie samstags versenden.
• Anzeigemodus — Spanne (zwischen Min und Max), nur spätestes Datum, oder Spanne mit Versanddatum.
• Anzeigezonen — drei unabhängige Schalter: Produktseite, Warenkorb, Checkout.
• Live-Countdown — aktiviert oder deaktiviert den HH:MM:SS-Zähler bis zum Cutoff.

Vorbereitungszeit pro Produkt

Jede Produktseite im Backoffice zeigt ein Panel „Delivery date — preparation time“. Geben Sie die Anzahl der Werktage ein, die vor dem Versand dieses Produkts benötigt werden:

• 0 — Lagerartikel, sofort versandfertig (vor dem Cutoff für den Versand am selben Tag geeignet);
• 2 — Produkt mit zwei Werktagen Vorbereitungszeit;
• 14 — auf Bestellung gefertigtes oder individualisiertes Produkt.

Der Wert wird beim Speichern des Produkts gespeichert. Im Warenkorb bestimmt das Produkt mit der längsten Vorbereitungszeit das Versanddatum der gesamten Bestellung.

Versanddienstleister-Konfiguration

Das zweite Panel der Konfigurationsseite listet alle aktiven Versanddienstleister auf. Legen Sie für jeden das Minimum und Maximum der Lieferwerktage fest. Übliche Beispiele: Expressdienste 1–2, Standardpost 2–4, Paketshop-Netzwerke 3–6. Auf der Produktseite und im Warenkorb wird die Spanne des Standard-Versanddienstleisters des Shops verwendet; im Checkout wechselt das Modul zu dem Versanddienstleister, den der Kunde tatsächlich ausgewählt hat.

Wenn PrestaShop einen Versanddienstleister versioniert (nach einer Änderung wird automatisch eine neue ID erstellt), kopiert das Modul die Konfiguration auf die neue ID — keine Einstellungen gehen verloren.

Feiertage

Die Feiertage werden unter Verbessern → Versand → Feiertage (Delivery Date) verwaltet. Jeder Eintrag hat ein Datum, einen Namen, ein Wiederkehrend-Kennzeichen und einen Aktiv/Inaktiv-Status:

• Wiederkehrend — nur Monat und Tag zählen; der Feiertag wird automatisch auf das laufende und das nächste Jahr projiziert (z. B. Weihnachten jeden 25. Dezember).
• Einmalig — ein einzelnes konkretes Datum, ideal für einen Brückentag oder eine außergewöhnliche Schließung.

Die acht französischen Nationalfeiertage sind als wiederkehrend vorinstalliert: 1. Januar, 1. Mai, 8. Mai, 14. Juli, 15. August, Allerheiligen, 11. November, 25. Dezember. Sie können sie einzeln deaktivieren und Ihre eigenen regionalen oder ausländischen Feiertage hinzufügen (z. B. für Bayern, Sachsen oder Ihre Versandländer).

Berechnungsalgorithmus

Die Berechnung folgt diesen Schritten, alle in Werktagen und in der konfigurierten Zeitzone:

1. Das Versanddatum startet bei heute. Liegt die aktuelle Uhrzeit nach dem Cutoff, verschiebt es sich auf morgen.
2. Die Vorbereitungszeit des Produkts (oder das Warenkorb-Maximum) wird in Werktagen addiert, wobei Wochenenden und Feiertage übersprungen werden.
3. Fällt das errechnete Versanddatum auf einen Nicht-Werktag, wird es auf den nächsten Werktag verschoben.
4. Die Lieferspanne ergibt sich durch Addition von Min und Max des Versanddienstleisters, ebenfalls in Werktagen.

Die Meldung „Versand heute“ und der Countdown erscheinen nur, wenn drei Bedingungen erfüllt sind: die aktuelle Uhrzeit liegt vor dem Cutoff, heute ist ein Werktag, und die Vorbereitungszeit beträgt null.

Template-Anpassung

Die drei Frontend-Widgets werden über überschreibbare Smarty-Templates gerendert. Kopieren Sie die betreffende(n) Datei(en) von modules/dfdeliverydate/views/templates/hook/ nach themes/ihr-theme/modules/dfdeliverydate/views/templates/hook/:

• product-delivery-date.tpl — Produktseite;
• cart-delivery-date.tpl — Warenkorb;
• checkout-delivery-date.tpl — Checkout und Bestellbestätigung.

Jedes Template erhält ein Array $dfdd, das unter anderem ships_today, min_date_label, max_date_label, ship_date_label, cutoff_ts und display_mode enthält. Das CSS befindet sich in views/css/front.css (Klassen mit Präfix dfdd-).

Fehlerbehebung

• Das Widget erscheint nicht auf der Produktseite — prüfen Sie, ob die Zone in der Konfiguration aktiviert ist und ob Ihr Theme den Hook displayProductAdditionalInfo implementiert (das Classic-Theme und die meisten Marktplatz-Themes tun dies).
• Der Countdown zeigt 00:00:00 — der heutige Cutoff ist vorbei; der Zähler wird nur angezeigt, solange der Versand am selben Tag noch möglich ist.
• Die Daten wirken um einen Tag verschoben — prüfen Sie die im Modul konfigurierte Zeitzone: die Berechnung verwendet diese Zeitzone, nicht die des Servers oder des Browsers.
• Ein Feiertag wird nicht berücksichtigt — prüfen Sie, ob er aktiv ist, und bei einem einmaligen Feiertag, ob sein Jahr dem laufenden Jahr entspricht.

Deinstallation

Die Deinstallation entfernt die drei Tabellen des Moduls, alle Konfigurationseinträge (Präfix DFDD_), den Feiertage-Verwaltungs-Tab und die Hook-Registrierungen. Die pro Produkt eingegebenen Vorbereitungszeiten gehen damit endgültig verloren — exportieren Sie sie bei Bedarf vorher.