Installation, Konfiguration und Produktattribute

Umfang des Dokuments

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

Installation

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

Installation aus dem Kowal Composer-Repository:

Die Zugangsdaten zum Composer-Repository, also E-Mail-Adresse des Kunden und Lizenz-Token, erhalten Sie nach dem Kauf per E-Mail. Sie sind außerdem im Kundenpanel nach dem Einloggen auf kowal.store verfügbar. Ersetzen Sie TWOJ_EMAIL_KLIENTA durch die E-Mail-Adresse Ihres Kontos und TWOJ_TOKEN durch den erhaltenen Token. Führen Sie die Befehle im Magento-Stammverzeichnis aus.

composer config repositories.kowal composer https://repo.kowal.storecomposer config http-basic.repo.kowal.store 'TWOJ_EMAIL_KLIENTA' 'TWOJ_TOKEN'composer require kowal/module-estimated-delivery-datebin/magento module:enable Kowal_EstimatedDeliveryDatebin/magento setup:upgradebin/magento cache:flush

Nach dem Produktions-Deployment muss der standardmäßige Kompilierungs- und Deployment-Prozess für statische Ressourcen ausgeführt werden, der dem Magento-Projekt entspricht:

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

Position der Konfiguration

Die Modulkonfiguration ist im Admin-Panel verfügbar:

Stores > Configuration > Sales > Estimated Delivery Date

Die Einstellungen sind auf den Ebenen default, website und store view verfügbar, gemäß dem Magento-Konfigurationsmechanismus.

General

Enabled

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

Standardwert: Yes.

Calculation Timezone

Zeitzone, die für die Datumsberechnung und die Cut-off-Zeit verwendet wird. Wenn das Feld leer bleibt, nutzt das Modul die in Magento konfigurierte Shop-Zeitzone.

Beispielwert:

Europe/Warsaw

Anwendung: nützlich, wenn der Shop in mehreren Store Views arbeitet oder wenn das für den Versand zuständige Lager in einer anderen Zeitzone arbeitet als die Standardkonfiguration des Shops.

Fallback Message

Ersatzhinweis, der als Ausweichtext verwendet wird, wenn der Shop eine allgemeine Information statt eines konkreten Datums anzeigen möchte.

Standardwert:

Termin dostawy potwierdzimy po złożeniu zamówienia.

Date Format

Datumsformat, das beim Rendern von Kundenhinweisen verwendet wird. Das Feld nutzt ein ICU-Muster, das von der Datumsformatierung in Magento unterstützt wird.

Standardwert:

EEEE, d MMMM

Beispielergebnis:

poniedziałek, 18 maja

Date Calculation

Processing Days Min

Mindestanzahl an Werktagen, die für die Kommissionierung der Bestellung vor dem Versand benötigt werden.

Standardwert: 1.

Anwendung: bestimmt das frühestmögliche Versanddatum.

Processing Days Max

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

Standardwert: 1.

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

Transport Days Min

Mindestanzahl an Werktagen für den Transport vom Versand bis zur Lieferung.

Standardwert: 1.

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

Transport Days Max

Maximale Anzahl an Werktagen für den Transport.

Standardwert: 2.

Anwendung: ermöglicht die Anzeige eines Lieferzeitraums, z. B. wenn der Versanddienstleister in der Regel innerhalb von 1-2 Werktagen zustellt.

Same-day Shipping Cut-off Time

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

Standardwert:

14:00

Wenn die aktuelle Uhrzeit nach der Cut-off-Zeit liegt, verschiebt das Modul den Start der Berechnung auf den nächsten Werktag.

Non-working Weekdays

Liste der Wochentage, die als arbeitsfrei behandelt werden. Die Werte sind als durch Kommas getrennte ISO-Nummern anzugeben:

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

Standardwert:

6,7

Anwendung: lässt standardmäßig Samstage und Sonntage bei der Berechnung von Werktagen aus.

Safety Buffer Days

Zusätzlicher Sicherheitspuffer, der zur Transportzeit hinzugerechnet wird.

Standardwert: 0.

Anwendung: nützlich in Zeiten erhöhten Bestellaufkommens, bei instabiler Arbeit 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 Admin-Panel.

Standardwert: Yes.

Show Cut-off Widget on Product Page

Aktiviert das Widget, das auf der Produktseite bis zur Cut-off-Zeit herunterzählt.

Standardwert: Yes.

Show Cut-off Widget in Cart

Aktiviert das Cut-off-Widget im Warenkorb.

Standardwert: No.

Cut-off Widget Mode

Legt fest, wie das Cut-off-Widget angezeigt wird.

Verfügbare Werte:

• Inline - das Widget wird an der Einbettungsstelle des Blocks angezeigt,
• Fixed - das Widget wird an der ausgewählten Bildschirmecke angeheftet,
• Inline + Fixed - das Widget funktioniert gleichzeitig als Inline- und Fixed-Element.

Standardwert: Inline.

Fixed Widget Position

Legt die Position des Fixed-Widgets fest.

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

Legt fest, auf welchen Gerätetypen das Fixed-Widget sichtbar sein soll.

Verfügbare Werte:

• Desktop,
• Mobile,
• Desktop + Mobile.

Standardwert: Desktop + Mobile.

After Cut-off Behavior

Legt das Verhalten des Widgets nach Überschreiten der Cut-off-Zeit fest.

Verfügbare Werte:

• Hide Widget - das Widget wird ausgeblendet,
• Show After Cut-off Message - das Widget zeigt einen Hinweis nach dem Cut-off.

Standardwert: Show After Cut-off Message.

Customer Messages

Hinweise unterstützen einfache Variablen im Format {{nazwa_zmiennej}}.

Verfügbare Variablen für Lieferhinweise:

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

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

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

Delivery Range Message

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

Standardwert:

Przewidywana dostawa: {{delivery_date_from}} - {{delivery_date_to}}

Single Delivery Date Message

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

Standardwert:

Przewidywana dostawa: {{delivery_date}}

Cut-off Countdown Message

Hinweis, der vor Überschreiten der Cut-off-Zeit angezeigt wird.

Standardwert:

Zamów w ciągu {{cutoff_countdown}}, a wyślemy jeszcze dzisiaj.

After Cut-off Message

Hinweis, der nach Überschreiten der Cut-off-Zeit angezeigt wird, wenn das Feld After Cut-off Behavior auf Anzeige des Hinweises eingestellt ist.

Standardwert:

Dzisiejsza wysyłka już zamknięta. Wyślemy w następny dzień roboczy.

Emails

Send Separate Email After Payment

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

Standardwert: No.

Anwendung: ermöglicht dem Kunden zu bestätigen, dass die Zahlung angenommen wurde und die Bestellung in Bearbeitung gegangen ist.

Payment Confirmation Template

Vorlage der nach der Zahlung gesendeten E-Mail.

Standardwert:

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Absender der Nachricht nach Zahlung. Das Feld nutzt 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 Admin-Panel.

Standardwert: Yes.

Delivery Date Change Template

Vorlage der E-Mail, die nach Ä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

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

Standardwert:

Przepraszamy, termin realizacji Twojego zamówienia uległ zmianie.

Require Delay Reason

Erfordert die Angabe eines Verzögerungsgrundes bei manueller Terminänderung in der Bestellansicht.

Standardwert: No.

Anwendung: erzwingt eine bessere operative Disziplin und erleichtert spätere Erklärungen von Terminänderungen.

Send Automatically After Manual Date Change

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

Standardwert: No.

Wenn das Feld deaktiviert ist, kann der Administrator über das Markieren einer Checkbox in der Bestellansicht über den Versand entscheiden.

Verwaltung von Produktattributen

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

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

Wo Attribute bearbeitet werden

Die Attribute sind im Magento-Admin-Panel 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

Mindestanzahl an Werktagen, die für die Kommissionierung eines konkreten 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 Werktagen für die Kommissionierung eines konkreten Produkts.

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

EDD Transport Days Min

Attributcode:

edd_transport_days_min

Mindestanzahl an Werktagen für den Transport eines konkreten 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 Werktagen für den Transport eines konkreten Produkts.

Anwendung: bei sperrigen Produkten, Palettenware oder Produkten, die spezielle Logistik erfordern.

EDD Static Customer Message

Attributcode:

edd_static_text

Eigener Kundenhinweis, der anstelle des Hinweises aus der globalen Konfiguration angezeigt wird.

Beispiele:

Produkt wykonywany na zamówienie. Termin dostawy potwierdzimy po zakupie.

Przewidywana dostawa: {{delivery_date_from}} - {{delivery_date_to}}

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

EDD Confidence

Attributcode:

edd_confidence

Sicherheitsgrad des Termins, der beim Lieferversprechen gespeichert wird.

Empfohlene Werte:

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

Die aktuelle Implementierung speichert diesen Wert im Berechnungsergebnis und in Snapshots. Er kann von Vorlagen, Integrationen oder weiterer Personalisierung von Hinweisen genutzt werden.

Disable Estimated Delivery Date

Attributcode:

edd_disable

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

Anwendung: nicht verfügbare Produkte, Produkte, die eine individuelle Lieferkalkulation erfordern, Dienstleistungen, Vorverkaufsprodukte oder Waren, für die der Shop kein Terminversprechen abgeben möchte.

Praxis beim Ausfüllen von Attributen

Für die meisten Produkte können Attribute leer bleiben und die globale Konfiguration genutzt werden. Es lohnt sich, sie nur dann auszufüllen, wenn sich ein konkretes Produkt tatsächlich vom Standard-Logistikprozess unterscheidet.

Beispielhafter Ansatz:

• sofort verfügbare Produkte: leer lassen oder kürzere Kommissionierungszeit setzen,
• vom Lieferanten beschaffte Produkte: längeren Kommissionierungsbereich setzen,
• sperrige Produkte: längeren Transport setzen,
• personalisierte Produkte: eigenen statischen Hinweis verwenden,
• Produkte ohne zuverlässigen Termin: Disable Estimated Delivery Date aktivieren oder einen erklärenden Hinweis setzen.

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

Import von Feiertagen und arbeitsfreien Tagen

Der Import ist im Admin-Panel 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 arbeitsfreien Tages,
• name - administrativ sichtbarer Name,
• type - Eintragstyp: 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 den wiederkehrenden Eintrag,
• day - Tag des Monats für den wiederkehrenden Eintrag,
• country - Ländercode,
• region - Region,
• postcode_pattern - Postleitzahlenmuster,
• shipping_method - Liefermethode,
• source_code - MSI-Quellcode,
• store_id - Store View-Kennung,
• 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

Terminverwaltung 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,
• Kundenhinweis,
• Verzögerungsgrund.

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

REST API

Das Modul stellt 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 u. a. Versanddatum, Lieferdatum, Hinweis, Sicherheitsgrad, Regelcode, Berechnungsdatum und Datenquelle zurück. Für eine Bestellung gibt das Modul den gespeicherten Snapshot zurück, sofern vorhanden.