Installation, Konfiguration und Produktattribute

Umfang des Dokuments

Dieses Dokument beschreibt die Installation des Moduls Estimated Delivery Date, die Konfiguration im Magento 2-Administrationsbereich sowie die Verwaltung der dem Produkt hinzugefügten Attribute. Die Beschreibung der Felder basiert auf der aktuellen Implementierung des Moduls.

Installation

Das Paket ist für die Installation über Composer vorgesehen.

Beispielinstallation aus einem VCS-Repository:

composer config repositories.kowal.estimated.delivery.date vcs https://github.com/kowalco/estimated-delivery-datecomposer require kowal/module-estimated-delivery-datebin/magento module:enable Kowal_EstimatedDeliveryDatebin/magento setup:upgradebin/magento cache:flush

Nach dem produktiven Deployment sollte der standardmäßige Prozess zur Kompilierung und zum Deploy statischer Ressourcen entsprechend dem Magento-Projekt ausgeführt werden:

bin/magento setup:di:compilebin/magento setup:static-content:deploybin/magento cache:flush

Ort der Konfiguration

Die Konfiguration des Moduls ist im Administrationsbereich verfügbar:

Stores > Configuration > Sales > Estimated Delivery Date

Die Einstellungen sind auf den Ebenen Default, Website und Store View verfügbar, entsprechend dem Konfigurationsmechanismus von Magento.

General

Enabled

Aktiviert oder deaktiviert das Modul für den jeweiligen Konfigurationsbereich. Wenn das Feld deaktiviert ist, sollten Nachrichten im Frontend nicht angezeigt werden.

Standardwert: Yes.

Calculation Timezone

Zeitzone, die für die Berechnung von Daten und der Cut-off-Uhrzeit verwendet wird. Wenn das Feld leer bleibt, verwendet das Modul die in Magento konfigurierte Zeitzone des Shops.

Beispielwert:

Europe/Warsaw

Anwendung: nützlich, wenn der Shop mit mehreren Store Views arbeitet oder wenn das Versandlager in einer anderen Zeitzone arbeitet als die Standardkonfiguration des Shops.

Fallback Message

Ersatznachricht, die als Fallback-Text verwendet wird, wenn der Shop statt eines konkreten Datums eine allgemeine Information anzeigen möchte.

Standardwert:

Den Liefertermin bestätigen wir nach Eingang der Bestellung.

Date Format

Datumsformat, das beim Rendern von Nachrichten für den Kunden verwendet wird. Das Feld nutzt das von der Magento-Datumsformatierung unterstützte ICU-Muster.

Standardwert:

EEEE, d MMMM

Beispielausgabe:

Montag, 18. Mai

Date Calculation

Processing Days Min

Minimale Anzahl an Arbeitstagen, die für die Kommissionierung der Bestellung vor dem Versand benötigt werden.

Standardwert: 1.

Anwendung: definiert das frühestmögliche Versanddatum.

Processing Days Max

Maximale Anzahl an Arbeitstagen, die für die Kommissionierung der Bestellung benötigt werden.

Standardwert: 1.

Anwendung: ermöglicht die Erstellung eines Versanddatumsbereichs, wenn die Kommissionierung länger als die Mindestzeit dauern kann.

Transport Days Min

Minimale Anzahl an Arbeitstagen für den Transport vom Versand bis zur Lieferung.

Standardwert: 1.

Anwendung: definiert das frühestmögliche Lieferdatum nach dem Versand.

Transport Days Max

Maximale Anzahl an Arbeitstagen für den Transport.

Standardwert: 2.

Anwendung: ermöglicht die Anzeige eines Lieferbereichs, z. B. wenn der Versanddienstleister üblicherweise in 1-2 Arbeitstagen zustellt.

Same-day Shipping Cut-off Time

Stichtagsuhrzeit für den Versand am selben Tag. Der Wert sollte im Format HH:MM eingegeben werden.

Standardwert:

14:00

Wenn die aktuelle Uhrzeit später als der Cut-off ist, verschiebt das Modul den Start der Berechnung auf den nächsten Arbeitstag.

Non-working Weekdays

Liste der Wochentage, die als arbeitsfrei behandelt werden. Die Werte müssen als ISO-Nummern, durch Kommas getrennt, angegeben werden:

• 1 - Montag,
• 2 - Dienstag,
• 3 - Mittwoch,
• 4 - Donnerstag,
• 5 - Freitag,
• 6 - Samstag,
• 7 - Sonntag.

Standardwert:

6,7

Anwendung: überspringt standardmäßig Samstage und Sonntage bei der Berechnung von Arbeitstagen.

Safety Buffer Days

Zusätzlicher Sicherheitspuffer, der zur Transportzeit hinzuaddiert wird.

Standardwert: 0.

Anwendung: nützlich in Zeiten erhöhter Bestellmengen, bei instabiler Leistung von Versanddienstleistern oder bei Produkten, die ein vorsichtigeres Lieferversprechen erfordern.

Display Settings

Show on Product Page

Aktiviert die Anzeige des voraussichtlichen Datums auf der Produktseite.

Standardwert: Yes.

Show in Cart

Aktiviert die Anzeige des voraussichtlichen Datums im Warenkorb.

Standardwert: Yes.

Show in Admin Order

Aktiviert den Bereich Estimated Delivery Date in der Bestellansicht im Administrationsbereich.

Standardwert: Yes.

Show Cut-off Widget on Product Page

Aktiviert das Countdown-Widget bis zur Cut-off-Uhrzeit auf der Produktseite.

Standardwert: Yes.

Show Cut-off Widget in Cart

Aktiviert das Cut-off-Widget im Warenkorb.

Standardwert: No.

Cut-off Widget Mode

Bestimmt die Art der Darstellung des Cut-off-Widgets.

Verfügbare Werte:

• Inline - das Widget wird an der Einbindungsstelle des Blocks angezeigt,
• Fixed - das Widget ist an einer ausgewählten Ecke des Bildschirms fixiert,
• Inline + Fixed - das Widget funktioniert gleichzeitig als Inline- und Fixed-Element.

Standardwert: Inline.

Fixed Widget Position

Bestimmt die Position des Fixed-Widgets.

Verfügbare Werte:

• Bottom Right - rechte untere Ecke,
• Bottom Left - linke untere Ecke,
• Top Right - rechte obere Ecke,
• Top Left - linke obere Ecke.

Standardwert: Bottom Right.

Fixed Widget Devices

Bestimmt den Gerätetyp, auf dem das Fixed-Widget sichtbar sein soll.

Verfügbare Werte:

• Desktop,
• Mobile,
• Desktop + Mobile.

Standardwert: Desktop + Mobile.

After Cut-off Behavior

Bestimmt das Verhalten des Widgets nach Überschreiten der Cut-off-Uhrzeit.

Verfügbare Werte:

• Hide Widget - das Widget wird ausgeblendet,
• Show After Cut-off Message - das Widget zeigt eine Nachricht nach dem Cut-off an.

Standardwert: Show After Cut-off Message.

Customer Messages

Die Nachrichten unterstützen einfache Variablen im Format {{nazwa_zmiennej}}.

Verfügbare Variablen für Liefernachrichten:

• {{ship_date}},
• {{ship_date_from}},
• {{ship_date_to}},
• {{delivery_date}},
• {{delivery_date_from}},
• {{delivery_date_to}}.

Verfügbare Variablen für Cut-off-Nachrichten:

• {{cutoff_time}},
• {{cutoff_countdown}}.

Delivery Range Message

Nachrichtenvorlage, die verwendet wird, wenn die Berechnung einen Lieferdatumsbereich zurückgibt.

Standardwert:

Voraussichtliche Lieferung: {{delivery_date_from}} - {{delivery_date_to}}

Single Delivery Date Message

Nachrichtenvorlage, die verwendet wird, wenn das früheste und das späteste Lieferdatum identisch sind.

Standardwert:

Voraussichtliche Lieferung: {{delivery_date}}

Cut-off Countdown Message

Nachricht, die vor dem Überschreiten der Cut-off-Uhrzeit angezeigt wird.

Standardwert:

Bestellen Sie innerhalb von {{cutoff_countdown}}, und wir versenden noch heute.

After Cut-off Message

Nachricht, die nach dem Überschreiten der Cut-off-Uhrzeit angezeigt wird, wenn das Feld After Cut-off Behavior auf die Anzeige einer Nachricht gesetzt ist.

Standardwert:

Der heutige Versand ist bereits geschlossen. Wir versenden am nächsten Arbeitstag.

Emails

Send Separate Email After Payment

Aktiviert eine separate E-Mail, die nach der Bezahlung der Bestellung gesendet wird.

Standardwert: No.

Anwendung: ermöglicht die Bestätigung gegenüber dem Kunden, dass die Zahlung eingegangen ist und die Bestellung in Bearbeitung ist.

Payment Confirmation Template

E-Mail-Vorlage, die nach der Zahlung versendet wird.

Standardwert:

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Absender der Nachricht nach der Zahlung. Das Feld verwendet die in Magento konfigurierten E-Mail-Identitäten.

Standardwert:

sales

Allow Email After Delivery Date Change

Erlaubt das Senden einer Nachricht an den Kunden nach manueller Änderung des Liefertermins im Administrationsbereich.

Standardwert: Yes.

Delivery Date Change Template

E-Mail-Vorlage, die nach der Änderung des Liefertermins gesendet wird.

Standardwert:

estimated_delivery_date_emails_date_change_template

Delivery Date Change Sender

Absender der Nachricht über die Änderung des Liefertermins.

Standardwert:

sales

Default Apology Message

Standardtext der Entschuldigung, der in der Nachricht über die Änderung des Liefertermins verwendet wird.

Standardwert:

Es tut uns leid, der Bearbeitungstermin Ihrer Bestellung hat sich geändert.

Require Delay Reason

Erfordert die Angabe eines Verzögerungsgrundes bei manueller Änderung des Termins in der Bestellansicht.

Standardwert: No.

Anwendung: sorgt für bessere operative Disziplin und erleichtert die spätere Klärung von Terminänderungen.

Send Automatically After Manual Date Change

Sendet automatisch eine Nachricht an den Kunden nach manueller Änderung des Liefertermins.

Standardwert: No.

Wenn das Feld deaktiviert ist, kann der Administrator den Versand durch Ankreuzen einer Checkbox in der Bestellansicht entscheiden.

Verwaltung von Produktattributen

Das Modul fügt dem Produkt die Attributgruppe Estimated Delivery Date hinzu. Die Attribute sind optional und haben den Geltungsbereich Store View. Wenn sie nicht ausgefüllt werden, verwendet das Modul Regeln oder die globale Konfiguration.

Produktattribute haben Vorrang vor für das Produkt berechneten Regeln. Dadurch kann der Termin für eine konkrete SKU schnell überschrieben werden, ohne globale Einstellungen zu ändern.

Wo die Attribute bearbeitet werden

Die Attribute sind im Magento-Administrationsbereich verfügbar:

Catalog > Products > Edit Product > Estimated Delivery Date

Wenn die Gruppe in einem bestimmten Attribute Set nicht sichtbar ist, sollte die Konfiguration des Produktattributsatzes in Magento geprüft werden.

EDD Processing Days Min

Attributcode:

edd_processing_days_min

Minimale Anzahl an Arbeitstagen, die für die Kommissionierung eines bestimmten Produkts benötigt werden.

Anwendung: ein sofort verfügbares Produkt kann den Wert 0 haben, ein vom Lieferanten beschafftes Produkt z. B. 3.

EDD Processing Days Max

Attributcode:

edd_processing_days_max

Maximale Anzahl an Arbeitstagen für die Kommissionierung eines bestimmten Produkts.

Anwendung: wenn die Kommissionierung variabel ist, kann z. B. ein Minimum von 2 und ein Maximum von 5 gesetzt werden, damit die Nachricht einen sichereren Bereich anzeigt.

EDD Transport Days Min

Attributcode:

edd_transport_days_min

Minimale Anzahl an Arbeitstagen für den Transport eines bestimmten Produkts.

Anwendung: bei Produkten, die mit einem anderen Versanddienstleister oder aus einem anderen Lager versendet werden.

EDD Transport Days Max

Attributcode:

edd_transport_days_max

Maximale Anzahl an Arbeitstagen für den Transport eines bestimmten Produkts.

Anwendung: bei sperrigen Produkten, Palettenware oder Produkten mit spezieller Logistik.

EDD Static Customer Message

Attributcode:

edd_static_text

Eigene Kundennachricht, die anstelle der Nachricht aus der globalen Konfiguration angezeigt wird.

Beispiele:

Produkt wird auf Bestellung gefertigt. Den Liefertermin bestätigen wir nach dem Kauf.

Voraussichtliche Lieferung: {{delivery_date_from}} - {{delivery_date_to}}

Das Attribut kann dieselben Datumsvariablen verwenden, die auch in den globalen Liefernachrichten verfügbar sind.

EDD Confidence

Attributcode:

edd_confidence

Vertrauensstufe des Termins, die beim Lieferversprechen gespeichert wird.

Empfohlene Werte:

• guaranteed - garantierter Termin,
• likely - wahrscheinlicher Termin,
• estimated - geschätzter Termin,
• unknown - keine verlässliche Schätzung.

Die aktuelle Implementierung speichert diesen Wert im Berechnungsergebnis und in Snapshots. Er kann von Templates, Integrationen oder für die weitere Personalisierung von Nachrichten verwendet werden.

Disable Estimated Delivery Date

Attributcode:

edd_disable

Deaktiviert die Anzeige der voraussichtlichen Lieferung für ein bestimmtes Produkt auf der Produktseite und deaktiviert für dieses Produkt auch das Cut-off-Widget.

Anwendung: nicht verfügbare Produkte, Produkte mit individueller Lieferpreisermittlung, Dienstleistungen, Vorverkaufsprodukte oder Waren, für die der Shop kein Terminversprechen geben möchte.

Praxis beim Ausfüllen der Attribute

Für die meisten Produkte können die Attribute leer bleiben und die globale Konfiguration verwendet werden. Sie sollten nur dann ausgefüllt werden, wenn sich ein bestimmtes Produkt tatsächlich vom Standard-Logistikprozess unterscheidet.

Beispielhafter Ansatz:

• sofort verfügbare Produkte: leer lassen oder kürzere Kommissionierzeit einstellen,
• vom Lieferanten beschaffte Produkte: längeren Kommissionierbereich einstellen,
• sperrige Produkte: längere Transportzeit einstellen,
• personalisierte Produkte: eigene statische Nachricht verwenden,
• Produkte ohne verlässlichen Termin: Disable Estimated Delivery Date aktivieren oder eine erklärende Nachricht einstellen.

Nach Änderungen an Produktattributen sollte der Magento-Cache aktualisiert werden, wenn der Shop Full Page Cache oder zusätzliche Cache-Mechanismen im Theme verwendet.

Import von Feiertagen und freien Tagen

Der Import ist im Administrationsbereich verfügbar:

Sales > Estimated Delivery Date > Import Holidays

Die CSV-Datei muss die Spalten enthalten:

code,name,type

Optionale Spalten:

date_from,date_to,month,day,country,region,postcode_pattern,shipping_method,source_code,store_id,scope,is_active

Unterstützte Typen in der Spalte type:

• single - einzelnes Datum, erfordert date_from,
• range - Datumsbereich, erfordert date_from und date_to,
• recurring - wiederkehrendes Datum, erfordert month und day.

Beschreibung ausgewählter Importfelder:

• code - eindeutiger Code des Feiertags oder freien Tages,
• name - administrativ sichtbarer Name,
• type - Typ des Eintrags: einzelner Tag, Bereich oder wiederkehrendes Datum,
• date_from - Startdatum im Format YYYY-MM-DD,
• date_to - Enddatum im Format YYYY-MM-DD,
• month - Monat für einen wiederkehrenden Eintrag,
• day - Tag des Monats für einen wiederkehrenden Eintrag,
• country - Ländercode,
• region - Region,
• postcode_pattern - Muster der Postleitzahl,
• shipping_method - Versandmethode,
• source_code - MSI-Quellcode,
• store_id - Kennung der Store View,
• scope - Anwendungsbereich, standardmäßig shipping_delivery,
• is_active - Aktivitätsstatus des Eintrags.

Beispiel:

code,name,type,date_from,date_to,month,day,country,store_id,is_activechristmas_2026,Christmas Break,range,2026-12-24,2026-12-26,,,,,1new_year,New Year,recurring,,,1,1,,,1

Verwaltung des Termins in der Bestellung

Der Bereich Estimated Delivery Date ist in der Bestellansicht verfügbar, wenn das Feld Show in Admin Order aktiviert wurde.

Der Administrator kann bearbeiten:

• Versanddatum von,
• Versanddatum bis,
• Lieferdatum von,
• Lieferdatum bis,
• Kundennachricht,
• Verzögerungsgrund.

Wenn die E-Mail nach Terminänderung aktiviert ist, kann der Administrator den Versand einer Nachricht mit Entschuldigung und neuem Termin auswählen. Das Modul speichert die Änderungshistorie zusammen mit dem vorherigen und dem neuen Termin, dem Grund sowie der Information zum Versand der E-Mail.

REST API

Das Modul stellt folgende Endpunkte bereit:

GET /rest/V1/estimated-delivery/product/:skuGET /rest/V1/estimated-delivery/cart/:cartIdGET /rest/V1/estimated-delivery/guest-cart/:cartIdGET /rest/V1/estimated-delivery/order/:orderId

Die API gibt unter anderem Versanddatum, Lieferdatum, Nachricht, Vertrauensstufe, Regelcode, Berechnungsdatum und Datenquelle zurück. Für die Bestellung gibt das Modul den gespeicherten Snapshot zurück, sofern vorhanden.