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 Magento 2 e la gestione degli attributi aggiunti al prodotto. La descrizione dei campi si basa sull'attuale implementazione del modulo.

Installazione

Il pacchetto è destinato all'installazione tramite Composer.

Installazione dal repository Composer Kowal:

I dati di accesso al repository Composer, ovvero l indirizzo e-mail del cliente e il token di licenza, saranno inviati via e-mail dopo l acquisto. Sono disponibili anche nel pannello cliente dopo l accesso su kowal.store. Sostituisci TWOJ_EMAIL_KLIENTA con l indirizzo e-mail del tuo account e TWOJ_TOKEN con il token ricevuto. Esegui i comandi nella directory principale di 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

Dopo il rilascio in produzione è necessario eseguire il processo standard di compilazione e deploy delle risorse statiche previsto dal progetto Magento:

bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/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à al meccanismo di configurazione Magento.

General

Enabled

Attiva o disattiva il modulo per un determinato ambito di configurazione. Quando il campo è disattivato, i messaggi sul frontend non dovrebbero essere mostrati.

Valore predefinito:Yes.

Calculation Timezone

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

Esempio di valore:

Europe/Warsaw

Utilizzo: utile quando il negozio opera su più store view oppure quando il magazzino che gestisce le spedizioni lavora in un fuso orario diverso rispetto alla configurazione predefinita del negozio.

Fallback Message

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

Valore predefinito:

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

Date Format

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

Valore predefinito:

EEEE, d MMMM

Risultato di esempio:

poniedziałek, 18 maja

Date Calculation

Processing Days Min

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

Valore predefinito:1.

Utilizzo: definisce la prima data di spedizione possibile.

Processing Days Max

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

Valore predefinito:1.

Utilizzo: consente di creare un intervallo di date di spedizione quando la preparazione può richiedere più tempo del minimo.

Transport Days Min

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

Valore predefinito:1.

Utilizzo: definisce la prima data di consegna possibile dopo la spedizione.

Transport Days Max

Numero massimo di giorni lavorativi di trasporto.

Valore predefinito:2.

Utilizzo: 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 formatoHH:MM.

Valore predefinito:

14:00

Se l'ora corrente è 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 indicati come numeri ISO separati da virgole:

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

Valore predefinito:

6,7

Utilizzo: per impostazione standard esclude sabati e domeniche dal conteggio dei giorni lavorativi.

Safety Buffer Days

Buffer di sicurezza aggiuntivo sommato al tempo di trasporto.

Valore predefinito:0.

Utilizzo: utile nei periodi con un aumento del numero 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

Attiva la visualizzazione della data prevista nella scheda prodotto.

Valore predefinito:Yes.

Show in Cart

Attiva la visualizzazione della data prevista nel carrello.

Valore predefinito:Yes.

Show in Admin Order

Attiva la sezione Estimated Delivery Date nella vista dell'ordine nel pannello di amministrazione.

Valore predefinito:Yes.

Show Cut-off Widget on Product Page

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

Valore predefinito:Yes.

Show Cut-off Widget in Cart

Attiva il widget cut-off nel carrello.

Valore predefinito:No.

Cut-off Widget Mode

Definisce la modalità di visualizzazione del widget cut-off.

Valori disponibili:

• Inline- il widget viene mostrato nel punto in cui il blocco è inserito,
• Fixed- il widget è fissato all'angolo dello schermo selezionato,
• 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 su cui 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 di cut-off.

Valori disponibili:

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

Valore predefinito:Show After Cut-off Message.

Customer Messages

I messaggi supportano variabili semplici 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 di 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:

Przewidywana dostawa: {{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:

Przewidywana dostawa: {{delivery_date}}

Cut-off Countdown Message

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

Valore predefinito:

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

After Cut-off Message

Messaggio mostrato dopo il superamento dell'orario di cut-off, se il campoAfter Cut-off Behaviorè impostato per mostrare il messaggio.

Valore predefinito:

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

Emails

Send Separate Email After Payment

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

Valore predefinito:No.

Utilizzo: consente di confermare al cliente che il pagamento è stato accettato 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 relativo alla modifica della data di consegna.

Valore predefinito:

sales

Default Apology Message

Testo predefinito di scuse utilizzato nel messaggio relativo alla modifica della data di consegna.

Valore predefinito:

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

Require Delay Reason

Richiede l'indicazione del motivo del ritardo in caso di modifica manuale della data nella vista dell'ordine.

Valore predefinito:No.

Utilizzo: impone una maggiore 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 dell'ordine.

Gestione degli attributi del prodotto

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

Gli attributi del prodotto hanno priorità sulle 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 Magento:

Catalog > Products > Edit Product > Estimated Delivery Date

Se il gruppo non è visibile in un determinato attribute set, è necessario verificare la configurazione del set di attributi del 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.

Utilizzo: un prodotto disponibile immediatamente può avere valore0, mentre un prodotto reperito 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.

Utilizzo: se la preparazione è variabile, è possibile impostare ad esempio un minimo di2e un massimo di5, in modo che 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.

Utilizzo: 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.

Utilizzo: per prodotti ingombranti, 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:

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

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

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

EDD Confidence

Codice attributo:

edd_confidence

Livello di certezza della data salvato insieme alla promessa di consegna.

Valori consigliati:

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

L'attuale implementazione salva questo valore nel risultato del calcolo e negli snapshot. Può essere utilizzato da template, integrazioni o da 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 il widget cut-off.

Utilizzo: prodotti non disponibili, prodotti che richiedono una quotazione individuale della consegna, servizi, prodotti in prevendita o articoli per i quali il negozio non vuole formulare una promessa di data.

Buone pratiche per la 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 uno specifico prodotto differisce realmente dal processo logistico standard.

Approccio di esempio:

• prodotti disponibili immediatamente: lasciare vuoto oppure impostare un tempo di preparazione più breve,
• prodotti reperiti dal fornitore: impostare un intervallo di preparazione più lungo,
• prodotti ingombranti: impostare un trasporto più lungo,
• prodotti personalizzati: utilizzare un messaggio statico personalizzato,
• prodotti senza una data affidabile: attivareDisable Estimated Delivery Dateoppure impostare un messaggio esplicativo.

Dopo la modifica degli attributi del prodotto è necessario aggiornare la cache Magento, se il negozio utilizza la cache completa della pagina o meccanismi di cache aggiuntivi 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 opzionali:

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

Tipi supportati nella colonnatype:

• single- singola data, richiededate_from,
• range- intervallo di date, richiededate_fromedate_to,
• recurring- data ricorrente, richiedemontheday.

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 di inizio nel formatoYYYY-MM-DD,
• date_to- data di fine nel formatoYYYY-MM-DD,
• month- mese per una voce ricorrente,
• day- giorno del mese per una voce ricorrente,
• country- codice paese,
• region- regione,
• postcode_pattern- pattern del codice postale,
• shipping_method- metodo di consegna,
• source_code- codice sorgente MSI,
• store_id- identificatore della store view,
• scope- ambito di applicazione, per impostazione predefinitashipping_delivery,
• is_active- stato di attività della voce.

Esempio:

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

Gestione della data nell'ordine

La sezione Estimated Delivery Date è disponibile nella vista dell'ordine se il campoShow 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 è attiva, l'amministratore può selezionare l'invio del messaggio con le scuse e la 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/: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 restituisce, tra le altre informazioni, la data di spedizione, la data di consegna, il messaggio, il livello di certezza, il codice della regola, la data del calcolo e la fonte dei dati. Per l'ordine il modulo restituisce lo snapshot salvato, se esiste.