Passa al contenuto principale

Integrazione Widget: Posiziona le Date di Consegna Ovunque

Il modulo Estimated Delivery non è limitato alla posizione predefinita della pagina prodotto. Puoi posizionare il widget della data di consegna ovunque nel tuo negozio — sia che tu utilizzi un costruttore di pagine drag-and-drop oppure preferisca lavorare direttamente nei template PHP.

Ci sono due modi per farlo, descritti nelle sezioni separate qui sotto:

  • PrettyBlocks — drag-and-drop, nessuna programmazione richiesta, adatto alla maggior parte dei commercianti
  • PrestaShop WidgetInterface — per gli sviluppatori che vogliono il pieno controllo sul posizionamento

Non è necessaria alcuna configurazione per attivare nessuno dei due approcci. L'interfaccia widget è sempre disponibile, e i blocchi PrettyBlocks appaiono automaticamente una volta che PrettyBlocks è installato nello stesso negozio.

PrettyBlocks: Blocchi Drag-and-Drop​

Se il tuo negozio usa PrettyBlocks, due blocchi vengono registrati automaticamente nel momento in cui il modulo Estimated Delivery viene installato insieme ad esso.

Identificatore bloccoCosa fa
estimateddelivery_productRenderizza la data di consegna per il prodotto attualmente nella pagina. Posizionalo ovunque in un layout di pagina prodotto — rileva il prodotto automaticamente, non è necessario alcun ID manuale.
estimateddelivery_cartRenderizza le informazioni di consegna nel contesto del carrello corrente. Usalo nei layout della pagina carrello per rassicurare i clienti prima del checkout.

Apri l'editor PrettyBlocks, trova uno dei due blocchi nella libreria dei blocchi, e trascinalo in qualsiasi zona del layout. Entrambi i blocchi renderizzano lo stesso messaggio di consegna che hai configurato nelle impostazioni del modulo — non sono design separati, sono lo stesso widget incorporato in una nuova posizione.

Quando usare ciascun blocco

Usa estimateddelivery_product per aggiungere date di consegna a una sezione personalizzata della pagina prodotto che hai costruito con PrettyBlocks. Usa estimateddelivery_cart quando vuoi mostrare le aspettative di consegna al momento del checkout, riducendo le esitazioni prima che il cliente effettui l'ordine.

Per Sviluppatori: PrestaShop WidgetInterface​

Il modulo implementa il WidgetInterface di PrestaShop, il che significa che qualsiasi template PHP o modulo personalizzato può richiedere l'HTML della data di consegna e produrlo ovunque sia necessario.

Questo è utile quando vuoi:

  • Incorporare le date di consegna in un template di tema personalizzato (file .tpl)
  • Visualizzare le date di consegna in una pagina categoria o landing page
  • Costruire un blocco personalizzato per un costruttore di pagine diverso da PrettyBlocks

Come chiamarlo​

$deliveryHtml = Module::getInstanceByName('estimateddelivery')
    ->renderWidget('displayProductAdditionalInfo', [
        'id_product' => $idProduct,
        'id_product_attribute' => $idProductAttribute,
    ]);
  • Usa displayProductAdditionalInfo quando hai un contesto prodotto (passa id_product e id_product_attribute).
  • Usa displayShoppingCart per il contesto carrello.

Il metodo restituisce una stringa HTML che puoi produrre direttamente nel tuo template. Se non è configurata alcuna data di consegna per il prodotto, restituisce una stringa vuota — quindi la chiamata è sicura da effettuare senza condizioni.

Domande Frequenti​

Funziona con costruttori di pagine diversi da PrettyBlocks?

I blocchi drag-and-drop nativi sono forniti solo per PrettyBlocks. Per altri costruttori — come Creative Elements o Elementor per PrestaShop — puoi usare l'approccio WidgetInterface: chiama renderWidget() da un blocco HTML o PHP personalizzato che quei costruttori espongono.

Posso mostrare le date di consegna in una pagina categoria o landing page?

Sì. Chiama renderWidget() con l'ID prodotto e l'ID attributo del prodotto che vuoi visualizzare, e mostra il risultato all'interno del tuo template. Funziona su qualsiasi pagina, non solo sulla pagina prodotto standard.

Il blocco PrettyBlocks viene renderizzato vuoto — cosa devo controllare?

Innanzitutto conferma che PrettyBlocks sia installato e attivo. Poi verifica che la data di consegna sia configurata per il prodotto in questione — se nessuna regola corrisponde al prodotto, il blocco restituisce output vuoto per design. Puoi verificare la configurazione nella sezione Regole di Consegna del modulo.

Devo fare qualcosa per attivare queste funzioni?

No. Il WidgetInterface è sempre attivo. I blocchi PrettyBlocks si registrano automaticamente quando sia il modulo Estimated Delivery che PrettyBlocks sono installati. Non c'è nessun toggle né passaggio di configurazione aggiuntivo.