# Modulo Carrello Sticky e Cross-sell IA — Installazione e configurazione

> Installa e configura il modulo Carrello Sticky e Cross-sell IA per PrestaShop 8 e 9: cassetto Ajax, motore di raccomandazione self-hosted, barra di spedizione gratuita e strato di IA opzionale.

- Pagina: <https://www.datafirefly.com/it/documentation/dfstickycart/>
- Lingua: it
- Aggiornato il: 2026-06-17
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfstickycart/index.md), [en](https://www.datafirefly.com/en/documentation/dfstickycart/index.md), [es](https://www.datafirefly.com/es/documentation/dfstickycart/index.md), [de](https://www.datafirefly.com/de/documentation/dfstickycart/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfstickycart/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfstickycart/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfstickycart/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## 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

1. Nel back office, apri **Moduli > Gestore moduli**.
2. Clicca su **Carica un modulo** e seleziona il file `dfstickycart.zip`.
3. 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à:

1. **Co-acquisto (market-basket)**: prodotti realmente ordinati insieme a quelli del carrello, dagli ordini validi (peso maggiore).
2. **Affinità di categoria**: prodotti delle stesse categorie del carrello.
3. **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.