Installatie, configuratie en productattributen

Reikwijdte van het document

Dit document beschrijft de installatie van de Estimated Delivery Date-module, de configuratie in het Magento 2-beheerpaneel en het beheer van attributen die aan het product worden toegevoegd. De beschrijving van de velden is gebaseerd op de huidige implementatie van de module.

Installatie

Het pakket is bedoeld voor installatie via Composer.

Voorbeeld van installatie vanuit een 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

Na productie-uitrol moet het standaardproces voor compilatie en deployment van statische assets worden uitgevoerd volgens het Magento-project:

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

Locatie van de configuratie

De configuratie van de module is beschikbaar in het beheerpaneel:

Stores > Configuration > Sales > Estimated Delivery Date

De instellingen zijn beschikbaar op default-, website- en store view-niveau, conform het configuratiemechanisme van Magento.

General

Enabled

Schakelt de module in of uit voor het betreffende configuratiebereik. Wanneer het veld is uitgeschakeld, mogen meldingen op de frontend niet worden getoond.

Standaardwaarde: Yes.

Calculation Timezone

Tijdzone die wordt gebruikt voor de berekening van datums en het cut-off tijdstip. Als het veld leeg blijft, gebruikt de module de tijdzone van de winkel die in Magento is geconfigureerd.

Voorbeeldwaarde:

Europe/Warsaw

Toepassing: handig wanneer de winkel meerdere store views heeft of wanneer het magazijn dat de verzending afhandelt in een andere tijdzone werkt dan de standaardconfiguratie van de winkel.

Fallback Message

Vervangende melding die als noodtekst wordt gebruikt wanneer de winkel algemene informatie wil tonen in plaats van een specifieke datum.

Standaardwaarde:

We bevestigen de levertermijn na het plaatsen van de bestelling.

Date Format

Datumformaat dat wordt gebruikt bij het renderen van meldingen voor de klant. Het veld gebruikt het ICU-patroon dat wordt ondersteund door Magento-datumopmaak.

Standaardwaarde:

EEEE, d MMMM

Voorbeeldeffect:

maandag, 18 mei

Date Calculation

Processing Days Min

Minimaal aantal werkdagen dat nodig is om de bestelling te verwerken vóór verzending.

Standaardwaarde: 1.

Toepassing: bepaalt de vroegst mogelijke verzenddatum.

Processing Days Max

Maximaal aantal werkdagen dat nodig is om de bestelling te verwerken.

Standaardwaarde: 1.

Toepassing: maakt het mogelijk een verzenddatumbereik te maken wanneer de verwerking langer kan duren dan de minimale tijd.

Transport Days Min

Minimaal aantal werkdagen voor transport van verzending tot levering.

Standaardwaarde: 1.

Toepassing: bepaalt de vroegst mogelijke leverdatum na verzending.

Transport Days Max

Maximaal aantal werkdagen voor transport.

Standaardwaarde: 2.

Toepassing: maakt het mogelijk een leveringsbereik te tonen, bijvoorbeeld wanneer de vervoerder meestal binnen 1-2 werkdagen levert.

Same-day Shipping Cut-off Time

Uiterste tijdstip voor verzending op dezelfde dag. De waarde moet worden ingevoerd in het formaat HH:MM.

Standaardwaarde:

14:00

Als het huidige tijdstip later is dan de cut-off, verschuift de module het begin van de berekening naar de volgende werkdag.

Non-working Weekdays

Lijst met weekdagen die als niet-werkdagen worden behandeld. Waarden moeten worden opgegeven als ISO-nummers gescheiden door komma's:

• 1 - maandag,
• 2 - dinsdag,
• 3 - woensdag,
• 4 - donderdag,
• 5 - vrijdag,
• 6 - zaterdag,
• 7 - zondag.

Standaardwaarde:

6,7

Toepassing: slaat standaard zaterdagen en zondagen over bij het berekenen van werkdagen.

Safety Buffer Days

Extra veiligheidsbuffer die aan de transporttijd wordt toegevoegd.

Standaardwaarde: 0.

Toepassing: handig in periodes met een verhoogd aantal bestellingen, bij instabiele prestaties van vervoerders of bij producten waarvoor een voorzichtiger leverbelofte nodig is.

Display Settings

Show on Product Page

Schakelt de weergave van de verwachte datum op de productpagina in.

Standaardwaarde: Yes.

Show in Cart

Schakelt de weergave van de verwachte datum in de winkelwagen in.

Standaardwaarde: Yes.

Show in Admin Order

Schakelt de sectie Estimated Delivery Date in de orderweergave van het beheerpaneel in.

Standaardwaarde: Yes.

Show Cut-off Widget on Product Page

Schakelt de widget die aftelt tot het cut-off tijdstip in op de productpagina.

Standaardwaarde: Yes.

Show Cut-off Widget in Cart

Schakelt de cut-off widget in de winkelwagen in.

Standaardwaarde: No.

Cut-off Widget Mode

Bepaalt de wijze waarop de cut-off widget wordt weergegeven.

Beschikbare waarden:

• Inline - de widget wordt weergegeven op de plaats waar het blok is ingevoegd,
• Fixed - de widget is vastgezet aan een gekozen hoek van het scherm,
• Inline + Fixed - de widget werkt tegelijk als inline- en fixed-element.

Standaardwaarde: Inline.

Fixed Widget Position

Bepaalt de positie van de fixed widget.

Beschikbare waarden:

• Bottom Right - rechterbenedenhoek,
• Bottom Left - linkerbenedenhoek,
• Top Right - rechterbovenhoek,
• Top Left - linkerbovenhoek.

Standaardwaarde: Bottom Right.

Fixed Widget Devices

Bepaalt op welk type apparaten de fixed widget zichtbaar moet zijn.

Beschikbare waarden:

• Desktop,
• Mobile,
• Desktop + Mobile.

Standaardwaarde: Desktop + Mobile.

After Cut-off Behavior

Bepaalt het gedrag van de widget na het verstrijken van het cut-off tijdstip.

Beschikbare waarden:

• Hide Widget - de widget wordt verborgen,
• Show After Cut-off Message - de widget toont een melding na cut-off.

Standaardwaarde: Show After Cut-off Message.

Customer Messages

Meldingen ondersteunen eenvoudige variabelen in het formaat {{nazwa_zmiennej}}.

Beschikbare variabelen voor leveringsmeldingen:

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

Beschikbare variabelen voor cut-off meldingen:

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

Delivery Range Message

Berichtsjabloon dat wordt gebruikt wanneer de berekening een bereik van leverdatums oplevert.

Standaardwaarde:

Verwachte levering: {{delivery_date_from}} - {{delivery_date_to}}

Single Delivery Date Message

Berichtsjabloon dat wordt gebruikt wanneer de vroegste en de laatste leverdatum gelijk zijn.

Standaardwaarde:

Verwachte levering: {{delivery_date}}

Cut-off Countdown Message

Melding die wordt getoond vóór het verstrijken van het cut-off tijdstip.

Standaardwaarde:

Bestel binnen {{cutoff_countdown}} en we verzenden nog vandaag.

After Cut-off Message

Melding die wordt getoond nadat het cut-off tijdstip is verstreken, als het veld After Cut-off Behavior is ingesteld op het tonen van een melding.

Standaardwaarde:

De verzending van vandaag is al gesloten. We verzenden op de volgende werkdag.

Emails

Send Separate Email After Payment

Schakelt een apart e-mailbericht in dat wordt verzonden nadat de bestelling is betaald.

Standaardwaarde: No.

Toepassing: maakt het mogelijk de klant te bevestigen dat de betaling is ontvangen en de bestelling in behandeling is genomen.

Payment Confirmation Template

E-mailsjabloon dat na betaling wordt verzonden.

Standaardwaarde:

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Afzender van het bericht na betaling. Het veld maakt gebruik van de e-mailidentiteiten die in Magento zijn geconfigureerd.

Standaardwaarde:

sales

Allow Email After Delivery Date Change

Maakt het mogelijk om de klant een bericht te sturen na handmatige wijziging van de leverdatum in het beheerpaneel.

Standaardwaarde: Yes.

Delivery Date Change Template

E-mailsjabloon dat wordt verzonden na wijziging van de levertermijn.

Standaardwaarde:

estimated_delivery_date_emails_date_change_template

Delivery Date Change Sender

Afzender van het bericht over de wijziging van de levertermijn.

Standaardwaarde:

sales

Default Apology Message

Standaard excuustekst die wordt gebruikt in het bericht over de wijziging van de levertermijn.

Standaardwaarde:

Onze excuses, de verwerkingstermijn van uw bestelling is gewijzigd.

Require Delay Reason

Vereist het opgeven van een reden voor vertraging bij handmatige wijziging van de termijn in de orderweergave.

Standaardwaarde: No.

Toepassing: zorgt voor betere operationele discipline en maakt het later eenvoudiger om termijnwijzigingen toe te lichten.

Send Automatically After Manual Date Change

Verstuurt automatisch een bericht naar de klant na handmatige wijziging van de levertermijn.

Standaardwaarde: No.

Als het veld is uitgeschakeld, kan de beheerder besluiten het bericht te verzenden door het selectievakje in de orderweergave aan te vinken.

Beheer van productattributen

De module voegt een attribuutgroep Estimated Delivery Date toe aan het product. De attributen zijn optioneel en hebben store view-bereik. Als ze niet worden ingevuld, gebruikt de module regels of globale configuratie.

Productattributen hebben voorrang op regels die voor het product zijn berekend. Hierdoor kan de termijn voor een specifiek SKU snel worden overschreven zonder globale instellingen te wijzigen.

Waar attributen te bewerken

De attributen zijn beschikbaar in het Magento-beheerpaneel:

Catalog > Products > Edit Product > Estimated Delivery Date

Als de groep niet zichtbaar is in een bepaalde attribute set, controleer dan de configuratie van de productattribuutset in Magento.

EDD Processing Days Min

Attribuutcode:

edd_processing_days_min

Minimaal aantal werkdagen dat nodig is om een specifiek product te verwerken.

Toepassing: een direct leverbaar product kan de waarde 0 hebben, en een product dat van een leverancier wordt betrokken bijvoorbeeld 3.

EDD Processing Days Max

Attribuutcode:

edd_processing_days_max

Maximaal aantal werkdagen voor de verwerking van een specifiek product.

Toepassing: als de verwerking variabel is, kan bijvoorbeeld een minimum van 2 en een maximum van 5 worden ingesteld zodat het bericht een veiliger bereik toont.

EDD Transport Days Min

Attribuutcode:

edd_transport_days_min

Minimaal aantal werkdagen voor transport van een specifiek product.

Toepassing: bij producten die met een andere vervoerder of vanuit een ander magazijn worden verzonden.

EDD Transport Days Max

Attribuutcode:

edd_transport_days_max

Maximaal aantal werkdagen voor transport van een specifiek product.

Toepassing: bij grote producten, palletzendingen of producten die speciale logistiek vereisen.

EDD Static Customer Message

Attribuutcode:

edd_static_text

Eigen klantmelding die wordt getoond in plaats van de melding uit de globale configuratie.

Voorbeelden:

Product wordt op bestelling gemaakt. We bevestigen de levertermijn na aankoop.

Verwachte levering: {{delivery_date_from}} - {{delivery_date_to}}

Het attribuut kan dezelfde datumvariabelen gebruiken die beschikbaar zijn in de globale leveringsmeldingen.

EDD Confidence

Attribuutcode:

edd_confidence

Betrouwbaarheidsniveau van de termijn dat bij de leverbelofte wordt opgeslagen.

Aanbevolen waarden:

• guaranteed - gegarandeerde termijn,
• likely - waarschijnlijke termijn,
• estimated - indicatieve termijn,
• unknown - geen betrouwbare schatting beschikbaar.

De huidige implementatie slaat deze waarde op in het resultaat van de berekening en in snapshots. Deze kan worden gebruikt door sjablonen, integraties of verdere personalisatie van meldingen.

Disable Estimated Delivery Date

Attribuutcode:

edd_disable

Schakelt de weergave van de verwachte levering voor een specifiek product op de productpagina uit en schakelt ook de cut-off widget voor dat product uit.

Toepassing: niet-beschikbare producten, producten die een individuele offerte voor levering vereisen, diensten, pre-orderproducten of artikelen waarvoor de winkel geen leverbelofte wil doen.

Praktijk voor het invullen van attributen

Voor de meeste producten kunnen attributen leeg blijven en kan de globale configuratie worden gebruikt. Het is de moeite waard om ze alleen in te vullen wanneer een specifiek product werkelijk afwijkt van het standaard logistieke proces.

Voorbeeldbenadering:

• direct leverbare producten: leeg laten of een kortere verwerkingstijd instellen,
• producten die van een leverancier worden betrokken: een langer verwerkingsbereik instellen,
• grote producten: langer transport instellen,
• gepersonaliseerde producten: een eigen statische melding gebruiken,
• producten zonder betrouwbare termijn: Disable Estimated Delivery Date inschakelen of een verklarende melding instellen.

Na wijziging van productattributen moet de Magento-cache worden vernieuwd als de winkel full page cache of extra cachemechanismen in het thema gebruikt.

Import van feestdagen en vrije dagen

De import is beschikbaar in het beheerpaneel:

Sales > Estimated Delivery Date > Import Holidays

Het CSV-bestand moet de kolommen bevatten:

code,name,type

Optionele kolommen:

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

Ondersteunde typen in de kolom type:

• single - afzonderlijke datum, vereist date_from,
• range - datumbereik, vereist date_from en date_to,
• recurring - terugkerende datum, vereist month en day.

Beschrijving van geselecteerde importvelden:

• code - unieke code van de feestdag of vrije dag,
• name - administratief zichtbare naam,
• type - type invoer: afzonderlijke dag, bereik of terugkerende datum,
• date_from - begindatum in formaat YYYY-MM-DD,
• date_to - einddatum in formaat YYYY-MM-DD,
• month - maand voor een terugkerende invoer,
• day - dag van de maand voor een terugkerende invoer,
• country - landcode,
• region - regio,
• postcode_pattern - patroon van de postcode,
• shipping_method - verzendmethode,
• source_code - MSI-broncode,
• store_id - identifier van de store view,
• scope - toepassingsbereik, standaard shipping_delivery,
• is_active - activiteitsstatus van de invoer.

Voorbeeld:

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

Beheer van de termijn in de bestelling

De sectie Estimated Delivery Date is beschikbaar in de orderweergave als het veld Show in Admin Order is ingeschakeld.

De beheerder kan bewerken:

• verzenddatum vanaf,
• verzenddatum tot,
• leverdatum vanaf,
• leverdatum tot,
• klantmelding,
• reden van vertraging.

Als e-mail na termijnwijziging is ingeschakeld, kan de beheerder het verzenden van een bericht met excuses en een nieuwe termijn aanvinken. De module slaat de wijzigingsgeschiedenis op samen met de vorige en nieuwe termijn, de reden en informatie over de verzending van de e-mail.

REST API

De module biedt endpoints:

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

De API retourneert onder meer de verzenddatum, leverdatum, melding, betrouwbaarheidsniveau, regelcode, berekeningsdatum en databron. Voor een bestelling retourneert de module de opgeslagen snapshot, indien aanwezig.