Popolarità Carrello — Documentazione
Installare e configurare il modulo di conteggio dei carrelli nella scheda prodotto.
Il modulo Popolarità Carrello mostra nella scheda prodotto un badge di riprova sociale che indica il numero di carrelli che contengono il prodotto, ad esempio «In oltre 20 carrelli». Questa guida copre l’installazione, la configurazione di ogni impostazione, il funzionamento del conteggio e la risoluzione dei problemi.
Installazione
Il modulo si installa come qualsiasi modulo PrestaShop, senza dipendenze esterne.
- Dal back-office, aprire Moduli > Gestore moduli.
- Fare clic su Carica un modulo e selezionare il file
dfcartpopularity.zip. - Al termine dell’installazione, fare clic su Configura.
Compatibile con PrestaShop da 8.0 a 9.x. Non è richiesta alcuna dipendenza Composer né libreria JavaScript esterna.
Configurazione
La pagina di configurazione raccoglie tutte le impostazioni di visualizzazione e di conteggio.
Testo visualizzato
Il messaggio presentato nel badge, traducibile per lingua. Utilizzare il segnaposto {count} per inserire dinamicamente il numero. Esempio: In oltre {count} carrelli. Le traduzioni francese, inglese, spagnola, tedesca e italiana sono fornite di default.
Soglia di visualizzazione
Numero minimo di carrelli a partire dal quale appare il badge. Al di sotto di questa soglia non viene mostrato nulla, evitando di esporre una cifra poco valorizzante. Valore predefinito: 20.
Modalità di visualizzazione del numero
- Soglia arrotondata: il contatore viene arrotondato per difetto a uno scaglione (es. 23 carrelli mostra «oltre 20»). Ideale per un effetto credibile che evolve a fasce.
- Numero esatto: viene mostrata la cifra reale, per i negozi che preferiscono la massima trasparenza.
Scaglione di arrotondamento
Utilizzato solo in modalità a scaglioni. Determina la fascia di arrotondamento: uno scaglione di 10 trasforma 23 in «oltre 20» e 37 in «oltre 30».
Finestra temporale (ore)
Conta solo i carrelli aggiornati entro questa finestra. Ad esempio, 168 = 7 giorni. Impostare su 0 per non applicare alcun limite di tempo.
Solo carrelli attivi
Quando questa opzione è attiva, i carrelli già trasformati in ordine sono esclusi dal conteggio. In questo modo si riflette solo la domanda attiva.
Posizione
Scegliere dove visualizzare il badge nella scheda: sotto il blocco di aggiunta al carrello (informazioni aggiuntive) o vicino ai pulsanti di acquisto.
Durata della cache (secondi)
Durata di conservazione del conteggio prima del ricalcolo. Per impostazione predefinita 600 secondi (10 minuti). Impostare su 0 per ricalcolare a ogni visualizzazione, cosa sconsigliata in produzione.
A ogni salvataggio delle impostazioni, la cache di conteggio viene svuotata automaticamente per applicare immediatamente i nuovi parametri.
Come funziona il conteggio
Il modulo conta i carrelli reali che contengono il prodotto. Il conteggio è deduplicato per carrello — uno stesso carrello non viene mai contato due volte — e limitato al negozio corrente in contesto multi-negozio. La finestra temporale e l’opzione «solo carrelli attivi» affinano questo conteggio affinché rifletta la domanda pertinente.
Prestazioni e cache
Per evitare una query di conteggio a ogni visualizzazione del prodotto, il risultato viene memorizzato in una tabella di cache dedicata con una durata configurabile. Il conteggio viene ricalcolato solo alla scadenza della cache, preservando le prestazioni anche sui negozi ad alto traffico.
Multi-negozio e multilingue
In multi-negozio, il conteggio è limitato al negozio consultato. Per quanto riguarda le lingue, il testo del badge è interamente traducibile: si imposta in modo indipendente per ogni lingua attiva del negozio, con il segnaposto {count} per il numero.
Integrazione nel tema
Il badge è renderizzato lato server tramite un template del modulo. Se si desidera riposizionarlo con precisione nel proprio tema, la variabile Smarty {$dfcp_message} contiene il messaggio pronto all’uso e può essere inserita in un override della scheda prodotto.
Risoluzione dei problemi
Il badge non viene visualizzato
Verificare che il numero reale di carrelli che contengono il prodotto raggiunga la soglia definita. Se la soglia è 20 ma il prodotto è solo in 5 carrelli, non appare alcun badge: è il comportamento previsto. Ridurre temporaneamente la soglia per testare la visualizzazione.
Il numero non si aggiorna immediatamente
È l’effetto della cache. Attendere la scadenza della durata configurata, oppure salvare le impostazioni per forzare uno svuotamento immediato della cache.
Il contatore sembra troppo basso
Se l’opzione «solo carrelli attivi» è attiva e la finestra temporale è breve, vengono contati solo i carrelli recenti e non ordinati. Ampliare la finestra temporale o disattivare l’opzione per un conteggio più inclusivo.