Modulo Carrello Sticky e Cross-sell IA — Installazione e configurazione
Installazione, configurazione e funzionamento del modulo Carrello Sticky e Cross-sell IA.
Panoramica
Il modulo Carrello Sticky e Cross-sell IA (dfstickycart) aggiunge al tuo negozio PrestaShop un cassetto carrello laterale che si apre tramite Ajax a ogni aggiunta, senza ricaricare la pagina. Mostra il contenuto del carrello, una barra di avanzamento della spedizione gratuita e un blocco di raccomandazioni cross-sell calcolate dai tuoi ordini reali, con uno strato di IA opzionale.
Il motore di raccomandazione è completamente self-hosted: il modulo funziona senza alcuna chiave API. L’IA è solo uno strato di riordino opzionale.
Compatibilità
- PrestaShop 8.0 a 9.x
- Negozio singolo e multistore
- 5 lingue: FR, EN, ES, DE, IT
- Nessuna dipendenza (né Composer né framework)
Installazione
- Nel back office, apri Moduli > Gestore moduli.
- Clicca su Carica un modulo e seleziona il file
dfstickycart.zip. - Una volta installato, clicca su Configura.
Il modulo registra automaticamente i suoi hook (actionFrontControllerSetMedia, displayHeader, displayFooter) e crea la sua tabella di cache all’installazione. La disinstallazione elimina questa tabella.
Configurazione
Generale
- Attivare il modulo: mostra o nasconde il cassetto e il pulsante fluttuante.
- Posizione del cassetto: a destra o a sinistra dello schermo.
- Apertura automatica: apre il cassetto a ogni aggiunta al carrello.
- Pulsante fluttuante: mostra un pulsante carrello permanente con il contatore degli articoli.
- Colore principale: colore d’accento del cassetto, dei pulsanti e della barra.
Raccomandazioni
- Attivare le raccomandazioni: mostra il blocco cross-sell nel cassetto.
- Numero di prodotti: numero di suggerimenti visualizzati (3 per impostazione predefinita).
- Strategia: Auto (solo il motore self-hosted) o IA (riordino tramite intelligenza artificiale).
- Messaggio carrello vuoto: testo mostrato quando il carrello non contiene ancora articoli.
Spedizione gratuita
Inserisci la soglia di spedizione gratuita nella valuta predefinita. La barra di avanzamento mostra automaticamente l’importo rimanente («Solo X € alla spedizione gratuita») e si converte nella valuta attiva del cliente. Inserisci 0 per nascondere la barra.
Intelligenza artificiale (opzionale)
- Fornitore: Mistral per impostazione predefinita, o qualsiasi servizio compatibile OpenAI.
- Endpoint: URL dell’API di completamento (per impostazione predefinita l’endpoint di chat Mistral).
- Modello: nome del modello (ad esempio un modello Mistral leggero).
- Chiave API: la tua chiave. Non viene mai più visualizzata e viene conservata se lasci il campo vuoto durante un aggiornamento.
Se la chiave è assente o l’API non risponde, il modulo ricorre silenziosamente al motore self-hosted. Il cassetto non viene mai bloccato da un errore di IA.
Come funziona il motore di raccomandazione
I suggerimenti sono costruiti a partire da un pool di prodotti proveniente da tre fonti, in ordine di priorità:
- Co-acquisto (market-basket): prodotti realmente ordinati insieme a quelli del carrello, dagli ordini validi (peso maggiore).
- Affinità di categoria: prodotti delle stesse categorie del carrello.
- Più venduti: ripiego quando lo storico è insufficiente.
Il risultato viene memorizzato nella cache per composizione del carrello per una durata configurabile, per limitare i calcoli. Se la strategia IA è attiva, lo strato di intelligenza artificiale riordina questo pool e genera una breve motivazione personalizzata per ogni prodotto.
Prestazioni
Il contenuto del cassetto viene caricato tramite Ajax solo all’apertura: nessuna richiesta aggiuntiva viene eseguita finché il cliente non apre il carrello. Le raccomandazioni in cache evitano di ricalcolare il motore a ogni visualizzazione.
FAQ e risoluzione dei problemi
Il cassetto non si apre
Verifica che il modulo sia attivato, svuota la cache di PrestaShop (Parametri avanzati > Prestazioni) e controlla che il tema carichi jQuery nel front.
Non appare alcuna raccomandazione
In un negozio nuovo senza storico ordini, il motore si basa sull’affinità di categoria e poi sui più venduti. Assicurati di avere prodotti attivi e visibili nel catalogo.
I suggerimenti IA non cambiano
I risultati vengono memorizzati nella cache per composizione del carrello. Riduci la durata della cache durante i test, oppure modifica il carrello per generare una nuova chiave di cache.