Installation, configuration et attributs du produit

Portée du document

Ce document décrit l’installation du module Estimated Delivery Date, sa configuration dans le panneau d’administration Magento 2 ainsi que la gestion des attributs ajoutés au produit. La description des champs repose sur l’implémentation actuelle du module.

Installation

Le package est destiné à être installé via Composer.

Installation depuis le dépôt Composer Kowal :

Les identifiants d’accès au dépôt Composer, c’est-à-dire l’adresse e-mail du client et le token de licence, vous seront envoyés par e-mail après l’achat. Ils sont également disponibles dans l’espace client après connexion sur kowal.store. Remplacez TWOJ_EMAIL_KLIENTA par l’adresse e-mail de votre compte et TWOJ_TOKEN par le token reçu. Exécutez les commandes dans le répertoire racine de Magento.

composer config repositories.kowal composer https://repo.kowal.store
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"
composer require kowal/module-estimated-delivery-date
bin/magento module:enable Kowal_EstimatedDeliveryDate
bin/magento setup:upgrade
bin/magento cache:flush

Après un déploiement en production, il convient d’exécuter le processus standard de compilation et de déploiement des ressources statiques conformément au projet Magento :

bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento cache:flush

Emplacement de la configuration

La configuration du module est disponible dans le panneau d’administration :

Stores > Configuration > Sales > Estimated Delivery Date

Les paramètres sont disponibles aux niveaux default, website et store view, conformément au mécanisme de configuration de Magento.

General

Enabled

Active ou désactive le module pour le périmètre de configuration donné. Lorsque le champ est désactivé, les messages ne doivent pas être affichés sur le frontend.

Valeur par défaut :Yes.

Calculation Timezone

Fuseau horaire utilisé pour le calcul des dates et de l’heure cut-off. Si le champ reste vide, le module utilise le fuseau horaire de la boutique configuré dans Magento.

Exemple de valeur :

Europe/Warsaw

Utilisation : utile lorsque la boutique fonctionne avec plusieurs store views ou lorsque l’entrepôt chargé des expéditions travaille dans un autre fuseau horaire que la configuration par défaut de la boutique.

Fallback Message

Message de remplacement utilisé comme texte de secours lorsque la boutique souhaite afficher une information générale au lieu d’une date précise.

Valeur par défaut :

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

Date Format

Format de date utilisé lors du rendu des messages destinés au client. Le champ utilise un modèle ICU pris en charge par le formatage des dates de Magento.

Valeur par défaut :

EEEE, d MMMM

Exemple de résultat :

poniedziałek, 18 maja

Date Calculation

Processing Days Min

Nombre minimal de jours ouvrés nécessaires à la préparation de la commande avant l’expédition.

Valeur par défaut :1.

Utilisation : définit la première date d’expédition possible.

Processing Days Max

Nombre maximal de jours ouvrés nécessaires à la préparation de la commande.

Valeur par défaut :1.

Utilisation : permet de créer une plage de dates d’expédition lorsque la préparation peut prendre plus de temps que le délai minimal.

Transport Days Min

Nombre minimal de jours ouvrés de transport entre l’expédition et la livraison.

Valeur par défaut :1.

Utilisation : définit la première date de livraison possible après l’expédition.

Transport Days Max

Nombre maximal de jours ouvrés de transport.

Valeur par défaut :2.

Utilisation : permet d’afficher une plage de livraison, par exemple lorsque le transporteur livre généralement sous 1 à 2 jours ouvrés.

Same-day Shipping Cut-off Time

Heure limite pour l’expédition le jour même. La valeur doit être saisie au formatHH:MM.

Valeur par défaut :

14:00

Si l’heure actuelle est postérieure au cut-off, le module décale le début du calcul au jour ouvré suivant.

Non-working Weekdays

Liste des jours de la semaine considérés comme non ouvrés. Les valeurs doivent être indiquées sous forme de numéros ISO séparés par des virgules :

• 1- lundi,
• 2- mardi,
• 3- mercredi,
• 4- jeudi,
• 5- vendredi,
• 6- samedi,
• 7- dimanche.

Valeur par défaut :

6,7

Utilisation : par défaut, les samedis et dimanches sont ignorés lors du calcul des jours ouvrés.

Safety Buffer Days

Marge de sécurité supplémentaire ajoutée au délai de transport.

Valeur par défaut :0.

Utilisation : utile pendant les périodes de forte augmentation du nombre de commandes, en cas de fonctionnement instable des transporteurs ou pour les produits nécessitant une promesse de livraison plus prudente.

Display Settings

Show on Product Page

Active l’affichage de la date estimée sur la fiche produit.

Valeur par défaut :Yes.

Show in Cart

Active l’affichage de la date estimée dans le panier.

Valeur par défaut :Yes.

Show in Admin Order

Active la section Estimated Delivery Date dans la vue de commande du panneau d’administration.

Valeur par défaut :Yes.

Show Cut-off Widget on Product Page

Active le widget de compte à rebours jusqu’à l’heure cut-off sur la fiche produit.

Valeur par défaut :Yes.

Show Cut-off Widget in Cart

Active le widget cut-off dans le panier.

Valeur par défaut :No.

Cut-off Widget Mode

Définit le mode d’affichage du widget cut-off.

Valeurs disponibles :

• Inline- le widget est affiché à l’emplacement où le bloc est intégré,
• Fixed- le widget est fixé dans l’angle sélectionné de l’écran,
• Inline + Fixed- le widget fonctionne simultanément comme élément inline et fixed.

Valeur par défaut :Inline.

Fixed Widget Position

Définit la position du widget fixed.

Valeurs disponibles :

• Bottom Right- angle inférieur droit,
• Bottom Left- angle inférieur gauche,
• Top Right- angle supérieur droit,
• Top Left- angle supérieur gauche.

Valeur par défaut :Bottom Right.

Fixed Widget Devices

Définit le type d’appareils sur lesquels le widget fixed doit être visible.

Valeurs disponibles :

• Desktop,
• Mobile,
• Desktop + Mobile.

Valeur par défaut :Desktop + Mobile.

After Cut-off Behavior

Définit le comportement du widget après le dépassement de l’heure cut-off.

Valeurs disponibles :

• Hide Widget- le widget sera masqué,
• Show After Cut-off Message- le widget affichera un message après le cut-off.

Valeur par défaut :Show After Cut-off Message.

Customer Messages

Les messages prennent en charge des variables simples au format{{nazwa_zmiennej}}.

Variables disponibles pour les messages de livraison :

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

Variables disponibles pour les messages cut-off :

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

Delivery Range Message

Modèle de message utilisé lorsque le calcul renvoie une plage de dates de livraison.

Valeur par défaut :

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

Single Delivery Date Message

Modèle de message utilisé lorsque la date de livraison la plus proche et la plus lointaine sont identiques.

Valeur par défaut :

Przewidywana dostawa: {{delivery_date}}

Cut-off Countdown Message

Message affiché avant le dépassement de l’heure cut-off.

Valeur par défaut :

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

After Cut-off Message

Message affiché après le dépassement de l’heure cut-off si le champAfter Cut-off Behaviorest défini pour afficher un message.

Valeur par défaut :

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

Emails

Send Separate Email After Payment

Active un e-mail séparé envoyé après le paiement de la commande.

Valeur par défaut :No.

Utilisation : permet de confirmer au client que le paiement a été accepté et que la commande est entrée en traitement.

Payment Confirmation Template

Modèle d’e-mail envoyé après le paiement.

Valeur par défaut :

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Expéditeur du message après paiement. Le champ utilise les identités e-mail configurées dans Magento.

Valeur par défaut :

sales

Allow Email After Delivery Date Change

Permet d’envoyer un message au client après une modification manuelle de la date de livraison dans le panneau d’administration.

Valeur par défaut :Yes.

Delivery Date Change Template

Modèle d’e-mail envoyé après la modification de la date de livraison.

Valeur par défaut :

estimated_delivery_date_emails_date_change_template

Delivery Date Change Sender

Expéditeur du message concernant la modification de la date de livraison.

Valeur par défaut :

sales

Default Apology Message

Contenu par défaut des excuses utilisé dans le message concernant la modification de la date de livraison.

Valeur par défaut :

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

Require Delay Reason

Exige la saisie d’un motif de retard lors de la modification manuelle de la date dans la vue de commande.

Valeur par défaut :No.

Utilisation : impose une meilleure discipline opérationnelle et facilite l’explication ultérieure des changements de date.

Send Automatically After Manual Date Change

Envoie automatiquement un message au client après une modification manuelle de la date de livraison.

Valeur par défaut :No.

Si le champ est désactivé, l’administrateur peut décider de l’envoi en cochant la case dans la vue de commande.

Gestion des attributs du produit

Le module ajoute au produit un groupe d’attributsEstimated Delivery Date. Les attributs sont optionnels et ont une portée store view. S’ils ne sont pas renseignés, le module utilise les règles ou la configuration globale.

Les attributs produit sont prioritaires par rapport aux règles calculées pour le produit. Cela permet de remplacer rapidement la date pour un SKU précis sans modifier les paramètres globaux.

Où modifier les attributs

Les attributs sont disponibles dans le panneau d’administration Magento :

Catalog > Products > Edit Product > Estimated Delivery Date

Si le groupe n’est pas visible dans un attribute set donné, vérifiez la configuration du jeu d’attributs du produit dans Magento.

EDD Processing Days Min

Code de l’attribut :

edd_processing_days_min

Nombre minimal de jours ouvrés nécessaires à la préparation du produit concerné.

Utilisation : un produit disponible immédiatement peut avoir la valeur0, tandis qu’un produit approvisionné auprès d’un fournisseur peut avoir par exemple3.

EDD Processing Days Max

Code de l’attribut :

edd_processing_days_max

Nombre maximal de jours ouvrés de préparation du produit concerné.

Utilisation : si la préparation est variable, vous pouvez définir par exemple un minimum de2et un maximum de5afin que le message affiche une plage plus prudente.

EDD Transport Days Min

Code de l’attribut :

edd_transport_days_min

Nombre minimal de jours ouvrés de transport pour le produit concerné.

Utilisation : pour les produits expédiés par un autre transporteur ou depuis un autre entrepôt.

EDD Transport Days Max

Code de l’attribut :

edd_transport_days_max

Nombre maximal de jours ouvrés de transport pour le produit concerné.

Utilisation : pour les produits volumineux, palettisés ou nécessitant une logistique spécifique.

EDD Static Customer Message

Code de l’attribut :

edd_static_text

Message personnalisé destiné au client, affiché à la place du message issu de la configuration globale.

Exemples :

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

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

L’attribut peut utiliser les mêmes variables de date que celles disponibles dans les messages de livraison globaux.

EDD Confidence

Code de l’attribut :

edd_confidence

Niveau de confiance de la date enregistré avec la promesse de livraison.

Valeurs recommandées :

• guaranteed- date garantie,
• likely- date probable,
• estimated- date estimée,
• unknown- absence d’estimation fiable.

L’implémentation actuelle enregistre cette valeur dans le résultat du calcul et dans les snapshots. Elle peut être utilisée par les templates, les intégrations ou une personnalisation ultérieure des messages.

Disable Estimated Delivery Date

Code de l’attribut :

edd_disable

Désactive l’affichage de la livraison estimée pour le produit concerné sur la fiche produit et désactive également le widget cut-off pour celui-ci.

Utilisation : produits indisponibles, produits nécessitant un devis de livraison individuel, services, produits en prévente ou articles pour lesquels la boutique ne souhaite pas communiquer de promesse de délai.

Bonnes pratiques de renseignement des attributs

Pour la plupart des produits, les attributs peuvent être laissés vides afin d’utiliser la configuration globale. Il est recommandé de les renseigner uniquement lorsqu’un produit précis diffère réellement du processus logistique standard.

Approche possible :

• produits disponibles immédiatement : laisser vide ou définir un délai de préparation plus court,
• produits approvisionnés auprès d’un fournisseur : définir une plage de préparation plus longue,
• produits volumineux : définir un transport plus long,
• produits personnalisés : utiliser un message statique personnalisé,
• produits sans date fiable : activerDisable Estimated Delivery Dateou définir un message explicatif.

Après la modification des attributs du produit, il convient de rafraîchir le cache Magento si la boutique utilise le full page cache ou des mécanismes de cache supplémentaires dans le thème.

Import des jours fériés et jours non ouvrés

L’import est disponible dans le panneau d’administration :

Sales > Estimated Delivery Date > Import Holidays

Le fichier CSV doit contenir les colonnes :

code,name,type

Colonnes optionnelles :

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

Types pris en charge dans la colonnetype:

• single- date unique, nécessitedate_from,
• range- plage de dates, nécessitedate_frometdate_to,
• recurring- date récurrente, nécessitemonthetday.

Description des champs d’import sélectionnés :

• code- code unique du jour férié ou du jour non ouvré,
• name- nom visible dans l’administration,
• type- type d’entrée : jour unique, plage ou date récurrente,
• date_from- date de début au formatYYYY-MM-DD,
• date_to- date de fin au formatYYYY-MM-DD,
• month- mois pour une entrée récurrente,
• day- jour du mois pour une entrée récurrente,
• country- code pays,
• region- région,
• postcode_pattern- modèle de code postal,
• shipping_method- méthode de livraison,
• source_code- code source MSI,
• store_id- identifiant de la store view,
• scope- périmètre d’application, par défautshipping_delivery,
• is_active- statut d’activation de l’entrée.

Exemple :

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

Gestion de la date dans la commande

La section Estimated Delivery Date est disponible dans la vue de commande si le champShow in Admin Order.

L’administrateur peut modifier :

• la date d’expédition à partir du,
• la date d’expédition jusqu’au,
• la date de livraison à partir du,
• la date de livraison jusqu’au,
• le message destiné au client,
• le motif du retard.

Si l’e-mail après modification de la date est activé, l’administrateur peut cocher l’envoi d’un message avec des excuses et la nouvelle date. Le module enregistre l’historique des modifications avec l’ancienne et la nouvelle date, le motif ainsi que l’information relative à l’envoi de l’e-mail.

REST API

Le module met à disposition les endpoints :

GET /rest/V1/estimated-delivery/product/:sku
GET /rest/V1/estimated-delivery/cart/:cartId
GET /rest/V1/estimated-delivery/guest-cart/:cartId
GET /rest/V1/estimated-delivery/order/:orderId

L’API renvoie notamment la date d’expédition, la date de livraison, le message, le niveau de confiance, le code de règle, la date du calcul et la source des données. Pour une commande, le module renvoie le snapshot enregistré s’il existe.