Installazione, configurazione e attributi del prodotto

Ambito del documento

Questo documento descrive l'installazione del modulo Estimated Delivery Date, la configurazione nel pannello di amministrazione di Magento 2 e la gestione degli attributi aggiunti al prodotto. La descrizione dei campi si basa sull'implementazione attuale del modulo.

Installazione

Il pacchetto è destinato all'installazione tramite Composer.

Esempio di installazione da repository VCS:

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

Dopo il deploy in produzione, è necessario eseguire il processo standard di compilazione e deploy delle risorse statiche conforme al progetto Magento:

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

Posizione della configurazione

La configurazione del modulo è disponibile nel pannello di amministrazione:

Stores > Configuration > Sales > Estimated Delivery Date

Le impostazioni sono disponibili a livello default, website e store view, in conformità con il meccanismo di configurazione di Magento.

General

Enabled

Abilita o disabilita il modulo per il determinato ambito di configurazione. Quando il campo è disattivato, i messaggi nel frontend non devono essere mostrati.

Valore predefinito: Yes.

Calculation Timezone

Fuso orario utilizzato per il calcolo delle date e dell'orario cut-off. Se il campo resta vuoto, il modulo utilizza il fuso orario del negozio configurato in Magento.

Esempio di valore:

Europe/Warsaw

Applicazione: utile quando il negozio opera con più store view o quando il magazzino che gestisce le spedizioni lavora in un fuso orario diverso dalla configurazione predefinita del negozio.

Fallback Message

Messaggio sostitutivo utilizzato come testo di emergenza quando il negozio vuole mostrare un'informazione generale invece di una data specifica.

Valore predefinito:

Confermeremo la data di consegna dopo l'invio dell'ordine.

Date Format

Formato data utilizzato per il rendering dei messaggi al cliente. Il campo utilizza il pattern ICU supportato dalla formattazione delle date di Magento.

Valore predefinito:

EEEE, d MMMM

Esempio di risultato:

lunedì, 18 maggio

Date Calculation

Processing Days Min

Numero minimo di giorni lavorativi necessari per la preparazione dell'ordine prima della spedizione.

Valore predefinito: 1.

Applicazione: determina la prima data possibile di spedizione.

Processing Days Max

Numero massimo di giorni lavorativi necessari per la preparazione dell'ordine.

Valore predefinito: 1.

Applicazione: consente di creare un intervallo di date di spedizione quando la preparazione può richiedere più tempo rispetto al minimo.

Transport Days Min

Numero minimo di giorni lavorativi di trasporto dalla spedizione alla consegna.

Valore predefinito: 1.

Applicazione: determina la prima data possibile di consegna dopo la spedizione.

Transport Days Max

Numero massimo di giorni lavorativi di trasporto.

Valore predefinito: 2.

Applicazione: consente di mostrare un intervallo di consegna, ad esempio quando il corriere di solito consegna in 1-2 giorni lavorativi.

Same-day Shipping Cut-off Time

Orario limite per la spedizione nello stesso giorno. Il valore deve essere inserito nel formato HH:MM.

Valore predefinito:

14:00

Se l'ora attuale è successiva al cut-off, il modulo sposta l'inizio del calcolo al giorno lavorativo successivo.

Non-working Weekdays

Elenco dei giorni della settimana considerati non lavorativi. I valori devono essere forniti come numeri ISO separati da virgole:

• 1 - lunedì,
• 2 - martedì,
• 3 - mercoledì,
• 4 - giovedì,
• 5 - venerdì,
• 6 - sabato,
• 7 - domenica.

Valore predefinito:

6,7

Applicazione: per impostazione standard esclude sabati e domeniche nel conteggio dei giorni lavorativi.

Safety Buffer Days

Buffer di sicurezza aggiuntivo sommato al tempo di trasporto.

Valore predefinito: 0.

Applicazione: utile nei periodi con un numero elevato di ordini, in caso di operatività instabile dei corrieri o per prodotti che richiedono una promessa di consegna più prudente.

Display Settings

Show on Product Page

Abilita la visualizzazione della data prevista nella scheda prodotto.

Valore predefinito: Yes.

Show in Cart

Abilita la visualizzazione della data prevista nel carrello.

Valore predefinito: Yes.

Show in Admin Order

Abilita la sezione Estimated Delivery Date nella vista ordine del pannello di amministrazione.

Valore predefinito: Yes.

Show Cut-off Widget on Product Page

Abilita il widget di conto alla rovescia fino all'orario cut-off nella scheda prodotto.

Valore predefinito: Yes.

Show Cut-off Widget in Cart

Abilita il widget cut-off nel carrello.

Valore predefinito: No.

Cut-off Widget Mode

Definisce il modo di visualizzazione del widget cut-off.

Valori disponibili:

• Inline - il widget viene mostrato nel punto in cui è inserito il blocco,
• Fixed - il widget è ancorato all'angolo selezionato dello schermo,
• Inline + Fixed - il widget funziona contemporaneamente come elemento inline e fixed.

Valore predefinito: Inline.

Fixed Widget Position

Definisce la posizione del widget fixed.

Valori disponibili:

• Bottom Right - angolo in basso a destra,
• Bottom Left - angolo in basso a sinistra,
• Top Right - angolo in alto a destra,
• Top Left - angolo in alto a sinistra.

Valore predefinito: Bottom Right.

Fixed Widget Devices

Definisce il tipo di dispositivi sui quali il widget fixed deve essere visibile.

Valori disponibili:

• Desktop,
• Mobile,
• Desktop + Mobile.

Valore predefinito: Desktop + Mobile.

After Cut-off Behavior

Definisce il comportamento del widget dopo il superamento dell'orario cut-off.

Valori disponibili:

• Hide Widget - il widget verrà nascosto,
• Show After Cut-off Message - il widget mostrerà un messaggio post cut-off.

Valore predefinito: Show After Cut-off Message.

Customer Messages

I messaggi supportano semplici variabili nel formato {{nazwa_zmiennej}}.

Variabili disponibili per i messaggi di consegna:

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

Variabili disponibili per i messaggi cut-off:

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

Delivery Range Message

Template del messaggio utilizzato quando il calcolo restituisce un intervallo di date di consegna.

Valore predefinito:

Consegna prevista: {{delivery_date_from}} - {{delivery_date_to}}

Single Delivery Date Message

Template del messaggio utilizzato quando la prima e l'ultima data di consegna coincidono.

Valore predefinito:

Consegna prevista: {{delivery_date}}

Cut-off Countdown Message

Messaggio mostrato prima del superamento dell'orario cut-off.

Valore predefinito:

Ordina entro {{cutoff_countdown}} e spediremo ancora oggi.

After Cut-off Message

Messaggio mostrato dopo il superamento dell'orario cut-off, se il campo After Cut-off Behavior è impostato sulla visualizzazione del messaggio.

Valore predefinito:

La spedizione di oggi è già chiusa. Spediremo il prossimo giorno lavorativo.

Emails

Send Separate Email After Payment

Abilita un'e-mail separata inviata dopo il pagamento dell'ordine.

Valore predefinito: No.

Applicazione: consente di confermare al cliente che il pagamento è stato ricevuto e che l'ordine è entrato in lavorazione.

Payment Confirmation Template

Template dell'e-mail inviata dopo il pagamento.

Valore predefinito:

estimated_delivery_date_emails_payment_template

Payment Confirmation Sender

Mittente del messaggio dopo il pagamento. Il campo utilizza le identità e-mail configurate in Magento.

Valore predefinito:

sales

Allow Email After Delivery Date Change

Consente di inviare al cliente un messaggio dopo la modifica manuale della data di consegna nel pannello di amministrazione.

Valore predefinito: Yes.

Delivery Date Change Template

Template dell'e-mail inviata dopo la modifica della data di consegna.

Valore predefinito:

estimated_delivery_date_emails_date_change_template

Delivery Date Change Sender

Mittente del messaggio sulla modifica della data di consegna.

Valore predefinito:

sales

Default Apology Message

Testo predefinito delle scuse utilizzato nel messaggio sulla modifica della data di consegna.

Valore predefinito:

Ci scusiamo, la data di evasione del tuo ordine è cambiata.

Require Delay Reason

Richiede l'inserimento del motivo del ritardo durante la modifica manuale della data nella vista ordine.

Valore predefinito: No.

Applicazione: impone una migliore disciplina operativa e facilita le successive spiegazioni delle modifiche di data.

Send Automatically After Manual Date Change

Invia automaticamente un messaggio al cliente dopo la modifica manuale della data di consegna.

Valore predefinito: No.

Se il campo è disattivato, l'amministratore può decidere l'invio selezionando la checkbox nella vista ordine.

Gestione degli attributi del prodotto

Il modulo aggiunge al prodotto un gruppo di attributi Estimated Delivery Date. Gli attributi sono facoltativi e hanno ambito store view. Se non vengono compilati, il modulo utilizza le regole o la configurazione globale.

Gli attributi del prodotto hanno priorità rispetto alle regole calcolate per il prodotto. Questo consente di sovrascrivere rapidamente la data per uno SKU specifico senza modificare le impostazioni globali.

Dove modificare gli attributi

Gli attributi sono disponibili nel pannello di amministrazione di Magento:

Catalog > Products > Edit Product > Estimated Delivery Date

Se il gruppo non è visibile in un determinato attribute set, occorre verificare la configurazione del set di attributi prodotto in Magento.

EDD Processing Days Min

Codice attributo:

edd_processing_days_min

Numero minimo di giorni lavorativi necessari per la preparazione di uno specifico prodotto.

Applicazione: un prodotto disponibile immediatamente può avere valore 0, mentre un prodotto ordinato dal fornitore ad esempio 3.

EDD Processing Days Max

Codice attributo:

edd_processing_days_max

Numero massimo di giorni lavorativi di preparazione di uno specifico prodotto.

Applicazione: se la preparazione è variabile, si può impostare ad esempio un minimo di 2 e un massimo di 5 affinché il messaggio mostri un intervallo più prudente.

EDD Transport Days Min

Codice attributo:

edd_transport_days_min

Numero minimo di giorni lavorativi di trasporto per uno specifico prodotto.

Applicazione: per prodotti spediti con un altro corriere o da un altro magazzino.

EDD Transport Days Max

Codice attributo:

edd_transport_days_max

Numero massimo di giorni lavorativi di trasporto per uno specifico prodotto.

Applicazione: per prodotti voluminosi, su pallet o che richiedono una logistica speciale.

EDD Static Customer Message

Codice attributo:

edd_static_text

Messaggio personalizzato per il cliente mostrato al posto del messaggio della configurazione globale.

Esempi:

Prodotto realizzato su ordinazione. Confermeremo la data di consegna dopo l'acquisto.

Consegna prevista: {{delivery_date_from}} - {{delivery_date_to}}

L'attributo può utilizzare le stesse variabili di data disponibili nei messaggi globali di consegna.

EDD Confidence

Codice attributo:

edd_confidence

Livello di affidabilità della data salvato insieme alla promessa di consegna.

Valori consigliati:

• guaranteed - data garantita,
• likely - data probabile,
• estimated - data indicativa,
• unknown - assenza di una stima affidabile.

L'implementazione attuale salva questo valore nel risultato del calcolo e negli snapshot. Può essere utilizzato da template, integrazioni o ulteriori personalizzazioni dei messaggi.

Disable Estimated Delivery Date

Codice attributo:

edd_disable

Disattiva la visualizzazione della consegna prevista per uno specifico prodotto nella scheda prodotto e disattiva per esso anche il widget cut-off.

Applicazione: prodotti non disponibili, prodotti che richiedono un preventivo di consegna personalizzato, servizi, prodotti in prevendita o articoli per i quali il negozio non vuole formulare una promessa di data.

Prassi di compilazione degli attributi

Per la maggior parte dei prodotti gli attributi possono essere lasciati vuoti e si può utilizzare la configurazione globale. Conviene compilarli solo quando un prodotto specifico si differenzia realmente dal processo logistico standard.

Approccio di esempio:

• prodotti disponibili immediatamente: lasciare vuoti oppure impostare un tempo di preparazione più breve,
• prodotti ordinati dal fornitore: impostare un intervallo di preparazione più lungo,
• prodotti voluminosi: impostare un trasporto più lungo,
• prodotti personalizzati: usare un messaggio statico personalizzato,
• prodotti senza una data affidabile: abilitare Disable Estimated Delivery Date oppure impostare un messaggio esplicativo.

Dopo la modifica degli attributi del prodotto è necessario aggiornare la cache di Magento, se il negozio utilizza la full page cache o ulteriori meccanismi di cache nel tema.

Importazione di festività e giorni non lavorativi

L'importazione è disponibile nel pannello di amministrazione:

Sales > Estimated Delivery Date > Import Holidays

Il file CSV deve contenere le colonne:

code,name,type

Colonne facoltative:

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

Tipi supportati nella colonna type:

• single - data singola, richiede date_from,
• range - intervallo di date, richiede date_from e date_to,
• recurring - data ricorrente, richiede month e day.

Descrizione dei campi di importazione selezionati:

• code - codice univoco della festività o del giorno non lavorativo,
• name - nome visibile a livello amministrativo,
• type - tipo di voce: giorno singolo, intervallo o data ricorrente,
• date_from - data iniziale nel formato YYYY-MM-DD,
• date_to - data finale nel formato YYYY-MM-DD,
• month - mese per la voce ricorrente,
• day - giorno del mese per la voce ricorrente,
• country - codice paese,
• region - regione,
• postcode_pattern - pattern del CAP,
• shipping_method - metodo di consegna,
• source_code - codice sorgente MSI,
• store_id - identificatore store view,
• scope - ambito di applicazione, per impostazione predefinita shipping_delivery,
• is_active - stato di attività della voce.

Esempio:

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

Gestione della data nell'ordine

La sezione Estimated Delivery Date è disponibile nella vista ordine, se è stato abilitato il campo Show in Admin Order.

L'amministratore può modificare:

• data di spedizione da,
• data di spedizione a,
• data di consegna da,
• data di consegna a,
• messaggio per il cliente,
• motivo del ritardo.

Se l'e-mail dopo la modifica della data è abilitata, l'amministratore può selezionare l'invio del messaggio con scuse e nuova data. Il modulo salva la cronologia delle modifiche insieme alla data precedente e a quella nuova, al motivo e all'informazione sull'invio dell'e-mail.

REST API

Il modulo mette a disposizione gli endpoint:

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

L'API restituisce, tra gli altri, la data di spedizione, la data di consegna, il messaggio, il livello di affidabilità, il codice regola, la data di calcolo e la fonte dei dati. Per l'ordine il modulo restituisce lo snapshot salvato, se esiste.