PS PrestaShop Intermedio

Checkout Semplice ed Elegante (dfsimplecheckout) — Guida completa

Installare, configurare e gestire il checkout one-page: colori, logo, modalità senza distrazioni, login Google e Facebook, Google Places, modulo indirizzo per paese, codice sconto AJAX e risoluzione dei problemi per PrestaShop 8 e 9.

Aggiornato Versione del modulo 1.3.3

Panoramica

DataFirefly Simple Checkout sostituisce il checkout nativo in 5 passaggi di PrestaShop con un processo d’acquisto one-page moderno, ispirato ai checkout di Shopify e Stripe. Il modulo monta il proprio controller a runtime tramite l’hook actionDispatcher: nessun file override viene scritto su disco, e gli override di terze parti esistenti su OrderController vengono ereditati in modo pulito.

Funzionalità principali: layout a due colonne con riepilogo permanente, login social Google e Facebook, autocompletamento indirizzo Google Places, modulo indirizzo adattivo per paese, codice sconto AJAX, cinque colori personalizzabili, modalità senza distrazioni.

Checkout PrestaShop in una sola pagina con dati personali, indirizzi, spedizione e pagamento
Checkout PrestaShop in una sola pagina con dati personali, indirizzi, spedizione e pagamento
Checkout in una pagina su smartphone con riepilogo dell'ordine comprimibile
Checkout in una pagina su smartphone con riepilogo dell’ordine comprimibile
Riepilogo dell'ordine aperto su smartphone con prodotti, codice sconto e totale
Riepilogo dell’ordine aperto su smartphone con prodotti, codice sconto e totale

Installazione

  1. Nel back-office di PrestaShop, vai su Moduli → Gestore moduli → Carica un modulo.
  2. Seleziona il file dfsimplecheckout-1.3.3.zip scaricato dal tuo account DataFirefly.
  3. Clicca su Installa e poi su Configura.
  4. Svuota la cache di PrestaShop (Parametri avanzati → Prestazioni → Svuota cache).
  5. Visita la pagina /order del tuo negozio con un prodotto nel carrello: il nuovo checkout appare immediatamente.

Il modulo è compatibile con PrestaShop 8.0 → 9.x. Nessuna modifica al tema richiesta. La disinstallazione ripristina automaticamente il checkout nativo.

Novità della versione 1.3.3 (16/11/2026): nuova opzione «Il cliente deve confermare il metodo di spedizione». Se attiva, lo step di spedizione resta aperto finché il cliente non conferma il proprio corriere, invece di confermare automaticamente quello preselezionato. È disattivata per impostazione predefinita: il checkout non cambia finché non la attivi. Aggiornamento: installa il nuovo zip sopra la 1.3.2, le tue impostazioni vengono mantenute.

Novità della versione 1.3.2 (05/11/2026): il modulo carta integrato di Mollie (Mollie Components) paga direttamente nel checkout, senza reindirizzamento alla pagina di pagamento di Mollie; «Salva carta» e «Usa carta salvata» vengono trasmessi. Aggiornamento: installa il nuovo zip sopra la 1.3.1, le tue impostazioni vengono conservate.

Novità della versione 1.3.1 (30/10/2026): con un corriere a punto di ritiro (Colissimo Punti di Ritiro…), lo step di consegna resta aperto e il pagamento bloccato finché non viene scelto un punto di ritiro; il blocco Express checkout di Mollie (Apple Pay, Google Pay, PayPal) appare in cima allo step di pagamento; due nuovi colori (sfondo del checkout, sfondo dei blocchi); costo della confezione regalo mostrato accanto alla casella; spaziature corrette sui temi personalizzati (caselle di spunta, titoli degli step, pulsante di scelta del punto di ritiro). Aggiornamento: installi il nuovo zip sopra la 1.3.0, le impostazioni vengono conservate.

Novità della versione 1.3.0 (29/10/2026): compatibilità con PrestaShop 9.1 (il checkout non si visualizzava più), codici sconto di nuovo applicati su PrestaShop 9, campo Stato/Provincia per Stati Uniti, Spagna, Italia, Canada…, dati inseriti conservati al cambio di paese, protezione contro il doppio clic su «Effettua l’ordine», importo del pagamento aggiornato dopo un codice sconto, messaggi chiari in caso di interruzione di rete o sessione scaduta, confezione regalo conservata, interfaccia tradotta in 8 lingue (FR, EN, ES, DE, IT, PT, PL, NL). Verificato su PrestaShop 8.2.1 (tema Classic) e 9.1.5 (tema Hummingbird). Aggiornamento: installi il nuovo zip sopra il precedente, le impostazioni vengono conservate.

Configurazione generale

Colori

Cinque colori sono configurabili nelle impostazioni del modulo:

  • Colore principale — pulsanti, link, stati attivi, radio selezionati (predefinito #1a73e8).
  • Colore hover dei pulsanti — stato hover dei pulsanti primari «Continua», «Ordina» (predefinito #1559b8).
  • Colore accento / successo — indicatori di passaggio completato, pill del codice sconto applicato, etichetta «Gratis» del corriere, messaggi di successo (predefinito #008060).
  • Colore di sfondo del checkout — sfondo della pagina, dietro gli step e il riepilogo (predefinito #fafbfb, grigio molto chiaro). Copre tutta la larghezza della pagina, compreso il contenitore del tema.
  • Colore di sfondo dei blocchi — sfondo dei blocchi degli step, del riepilogo dell’ordine e della barra superiore (predefinito #ffffff, bianco).

I cinque valori vengono iniettati come variabili CSS (--dfsc-primary, --dfsc-primary-hover, --dfsc-success, --dfsc-page-bg, --dfsc-bg) e validati con regex esadecimale rigorosa: un valore non valido viene sostituito dal colore predefinito.

Indica l’URL di un logo personalizzato per l’intestazione del checkout; in mancanza viene usato il logo del negozio. Dimensioni renderizzate: massimo 190×42 px.

Modalità senza distrazioni

L’opzione Nascondi header e footer del tema (attiva di default) rimuove l’intestazione completa del tema (menu, ricerca, carrello) e il suo footer solo sulla pagina /order. L’implementazione sovrascrive i blocchi Smarty header e footer nel nostro template: su un tema che non usa questi blocchi standard, l’opzione semplicemente non ha effetto — mai una pagina bianca.

Conferma del metodo di spedizione

Per impostazione predefinita, il checkout conferma automaticamente il corriere preselezionato da PrestaShop: lo step di spedizione appare completato e chiuso, e il cliente arriva direttamente al pagamento. Se la scelta del corriere è importante per i tuoi clienti (ritiro in negozio, spedizione express, punto di ritiro…), attiva l’opzione Il cliente deve confermare il metodo di spedizione (versione 1.3.3 o successiva):

  • lo step di spedizione resta aperto con l’elenco dei corrieri, e quello preselezionato resta selezionato;
  • lo step di pagamento resta bloccato finché il cliente non clicca su «Procedi al pagamento»;
  • la scelta viene poi mantenuta per quel carrello, anche se la pagina viene ricaricata; un nuovo carrello la richiede di nuovo;
  • i carrelli che contengono solo prodotti virtuali non hanno lo step di spedizione e non sono interessati.

L’opzione è disattivata per impostazione predefinita, sia all’installazione sia all’aggiornamento.

Altre opzioni

  • Campo nota per il venditore (on/off)
  • Campo codice sconto (on/off)
  • Confezione regalo: quando l’opzione è attiva in PrestaShop, il costo appare accanto alla casella (IVA inclusa o esclusa secondo il negozio) e la riga «Confezione regalo» compare nel riepilogo
  • Badge di fiducia — HTML libero mostrato sotto il riepilogo
  • Link legali a piè di checkout (CGV, privacy, resi — rilevati tramite i ruoli CMS nativi)
Impostazioni del modulo nel back office PrestaShop: colori, logo, pagamento express, note, codice sconto e fatturazione
Impostazioni del modulo nel back office PrestaShop: colori, logo, pagamento express, note, codice sconto e fatturazione

Login social Google

Creare le credenziali

  1. Vai su Google Cloud Console e crea (o seleziona) un progetto.
  2. In APIs & Services → Credentials, crea un OAuth client ID di tipo Web application.
  3. In Authorized JavaScript origins, aggiungi l’URL del tuo negozio (es. https://www.mionegozio.it) — senza percorso, con protocollo https.
  4. Copia il Client ID generato (termina con .apps.googleusercontent.com).

Configurare il modulo

  1. Nelle impostazioni del modulo, attiva Google Sign-In e incolla il Client ID.
  2. Salva e svuota la cache.
  3. Su /order, il pulsante Google appare sopra le schede «Sono un nuovo cliente / Ho già un account».

Il flusso: il cliente clicca, seleziona il proprio account Google, e il modulo riceve un JWT che valida lato server tramite l’endpoint ufficiale tokeninfo (verifica di audience, emittente, scadenza ed email verificata). Se esiste un account cliente con quella email, viene connesso; altrimenti viene creato automaticamente un account con nome e cognome del profilo Google.

Login social Facebook

Creare l’applicazione

  1. Su Meta for Developers, crea un’app di tipo Consumer.
  2. Aggiungi il prodotto Facebook Login e dichiara il tuo dominio nelle impostazioni.
  3. Recupera App ID e App Secret in Settings → Basic.

Configurare il modulo

Attiva Facebook Login nelle impostazioni, incolla App ID e App Secret, salva. La validazione lato server è in due fasi: debug_token (verifica che il token appartenga alla tua app) seguita dal recupero del profilo con firma appsecret_proof (HMAC-SHA256). L’App Secret non lascia mai il tuo server.

Autocompletamento indirizzo Google Places

  1. In Google Cloud Console, attiva le API Places API e Maps JavaScript API.
  2. Crea una API key e restringila al tuo dominio (consigliato).
  3. Nel modulo, attiva Autocompletamento indirizzo e incolla la chiave.

Il campo «Indirizzo» del modulo offre quindi suggerimenti durante la digitazione. La selezione di un suggerimento precompila via, complemento, città, CAP, paese e regione se applicabile. I suggerimenti sono limitati ai paesi attivi del tuo negozio (fino a 5 paesi — limite dell’API Google).

Google fattura l’API Places oltre la quota gratuita mensile. Per un negozio a volume moderato, la quota gratuita è generalmente sufficiente.

Modulo indirizzo adattivo per paese

Il modulo indirizzo si adatta automaticamente al paese selezionato:

  • Il paese predefinito del dropdown è quello configurato in Internazionale → Localizzazione del tuo back-office (e non il primo paese alfabetico).
  • Il campo Stato/Regione appare solo per i paesi che ne hanno (USA, Spagna, Italia…) e il suo dropdown elenca unicamente le regioni attive del paese selezionato.
  • Il campo DNI appare per i paesi che lo richiedono (Spagna).
  • La validazione del CAP usa il formato del paese.
  • Al cambio di paese, la pagina si ricarica con il modulo ristrutturato per il nuovo paese.

Modifica indirizzo

Ogni indirizzo salvato mostra un’icona matita. Il clic apre il modulo inline precompilato con tutti i valori dell’indirizzo (caricati lato server con controllo di proprietà — un cliente non può mai consultare l’indirizzo di un altro). Il salvataggio aggiorna l’indirizzo esistente, senza creare duplicati.

Scelta di un indirizzo di consegna salvato tramite schede, con modifica e fatturazione separata
Scelta di un indirizzo di consegna salvato tramite schede, con modifica e fatturazione separata
Modulo indirizzo del checkout con il campo Stato e un errore sul CAP mostrato sotto il campo
Modulo indirizzo del checkout con il campo Stato e un errore sul CAP mostrato sotto il campo

Codice sconto

Il campo codice sconto (attivabile) funziona in AJAX: applicazione e rimozione senza ricaricare, aggiornamento istantaneo del riepilogo. Il codice viene verificato con esattamente le stesse regole del carrello nativo di PrestaShop (CartRule::checkValidity): date, importo minimo, restrizioni per corriere, paese o gruppo, cumulabilità. I messaggi di errore nativi («Questo buono è scaduto», «Importo minimo non raggiunto»…) vengono mostrati tali e quali.

Codice sconto applicato senza ricaricare, riepilogo dell'ordine e importo del pagamento aggiornati
Codice sconto applicato senza ricaricare, riepilogo dell’ordine e importo del pagamento aggiornati

Compatibilità corrieri e Colissimo

Il contenuto extra dei corrieri (mappa dei punti di ritiro Colissimo, widget Mondial Relay…) viene renderizzato tramite {$carrier.extraContent} come nel template nativo. Lo step di consegna viene convalidato solo quando il modulo del corriere lo accetta, esattamente come nel checkout nativo (hook actionValidateStepComplete).

  • Punto di ritiro non scelto (Colissimo Punti di Ritiro, Mondial Relay…): lo step di consegna resta aperto con il pulsante di scelta del punto, e lo step di pagamento resta bloccato. Il messaggio del corriere appare solo se il cliente clicca su «Procedi al pagamento» senza aver scelto un punto.
  • Punto scelto: il pagamento si apre e resta aperto anche dopo aver ricaricato la pagina. Per Colissimo, il punto salvato viene recuperato automaticamente (identificativo e telefono mobile): il cliente non deve sceglierlo di nuovo.
  • Cambio di corriere: se il cliente passa da un corriere classico a un punto di ritiro, lo step di consegna si riapre finché il punto non viene scelto.
Scelta del corriere nel checkout in una pagina con tempi e costi di spedizione
Scelta del corriere nel checkout in una pagina con tempi e costi di spedizione
Checkout in una pagina con omaggio (DF Free Gift) e offerta 3+1 (DF Quantity Deal) nel riepilogo
Checkout in una pagina con omaggio (DF Free Gift) e offerta 3+1 (DF Quantity Deal) nel riepilogo
Pagina di conferma dell'ordine PrestaShop dopo il pagamento con assegno
Pagina di conferma dell’ordine PrestaShop dopo il pagamento con assegno

Pagamento express Mollie (Apple Pay, Google Pay, PayPal)

Dalla versione 1.3.1 il modulo rende gli hook nativi dello step di pagamento. Il blocco Express checkout del modulo Mollie (Express Component: Apple Pay, Google Pay, PayPal) appare quindi in cima allo step di pagamento, sopra i metodi di pagamento. I suoi pulsanti restano bloccati finché le condizioni di vendita non sono spuntate; poi Mollie verifica il carrello prima del pagamento.

  • Attivi il blocco nel modulo Mollie (impostazioni Express checkout). Mollie lo mostra solo in modalità live, e Apple Pay appare solo su Safari (iPhone, iPad, Mac) con un dominio verificato presso Mollie.
  • I pulsanti Apple Pay Direct di Mollie sulla scheda prodotto e nel carrello non passano dal checkout: funzionano così come sono.

Modulo carta integrato di Mollie

Con l’opzione di Mollie per il modulo carta di credito integrato nell’ordine (Mollie Components), i campi della carta appaiono nello step di pagamento e la carta viene pagata direttamente dal checkout: al clic su «Effettua l’ordine», Mollie crea un token sicuro della carta e lo invia con l’ordine, senza reindirizzare alla pagina di pagamento ospitata da Mollie.

  • Funziona anche il pagamento con un clic di Mollie: «Salva carta» e «Usa carta salvata» vengono trasmessi a Mollie.
  • Richiede la versione 1.3.2 del modulo: prima di questa correzione il cliente veniva reindirizzato alla pagina di pagamento di Mollie e doveva reinserire la carta.

Hook per sviluppatori

  • displayDfsimplecheckoutExpress — slot in cima al checkout per i pagamenti express (Apple Pay, Google Pay, PayPal Express).
  • displayDfsimplecheckoutSidebarTop / displayDfsimplecheckoutSidebarBottom — zone di iniezione nella colonna riepilogo.
  • actionDfscSocialLogin — attivato dopo un login social riuscito, con i parametri customer e dfsc_social_provider (google o facebook). Utile per tagging CRM.
  • Hook nativi del checkout, resi nello stesso punto dei template nativi (1.3.1): displayPaymentTop (in cima allo step di pagamento), displayCheckoutBeforeConfirmation (tra le condizioni di vendita e «Effettua l’ordine»), displayBeforeCarrier e displayAfterCarrier (prima e dopo l’elenco dei corrieri).

Risoluzione dei problemi

Il pulsante Google non appare

  • Verifica che il Client ID sia inserito e l’opzione attivata.
  • Controlla nella console del browser che non ci sia un errore «origin not allowed» — in tal caso, aggiungi l’URL esatto del tuo negozio (con https, senza slash finale) negli Authorized JavaScript origins di Google Cloud Console.

Il login social non persiste

Svuota la cache di PrestaShop e quella del browser. Se il problema persiste, verifica che nessun modulo di sicurezza di terze parti invalidi i cookie di sessione dopo il login.

Il campo Stato mostra le regioni sbagliate

Assicurati di usare la versione 1.3.0 o superiore del modulo, che risolve la struttura del modulo lato server per ogni paese.

Il pagamento si apre anche se non è stato scelto un punto di ritiro

Aggiorni alla versione 1.3.1 o superiore: lo step di consegna resta aperto finché il modulo del corriere non convalida il punto di ritiro.

Il pagamento con carta Mollie reindirizza alla pagina di pagamento di Mollie

Aggiorna alla versione 1.3.2 o successiva: il modulo carta integrato trasmette allora la carta a Mollie direttamente dal checkout. Se il problema persiste, svuota la cache di PrestaShop e verifica nella console del browser che nessun errore JavaScript impedisca il caricamento dello script di Mollie.

Lo step di spedizione si convalida da solo

È il comportamento predefinito: il corriere preselezionato viene confermato automaticamente. Perché sia il cliente a sceglierlo, aggiorna alla versione 1.3.3 o successiva e attiva l’opzione «Il cliente deve confermare il metodo di spedizione» nelle impostazioni del modulo.

Pagina bianca su /order

Attiva la modalità debug di PrestaShop (_PS_MODE_DEV_) per mostrare l’errore, o consulta var/logs. Verifica che nessun altro modulo di checkout one-page sia attivo contemporaneamente.

Disinstallazione

Disinstalla il modulo dal Gestore moduli. L’ambiente runtime viene liberato immediatamente e il checkout nativo in 5 passaggi viene ripristinato. Nessun file residuo, nessun dato orfano.

Questa pagina ti è stata utile?

Ancora bloccato? Contatta l'assistenza