Modulo Prodotti di Tendenza e Ricerche Popolari — Guida completa

Panoramica

DF Trending aggiunge al vostro negozio PrestaShop 8 o 9 un widget di tendenze composto da tre sezioni indipendenti: le ricerche popolari del momento (nuvola di tag cliccabili), i prodotti in crescita (rilevamento per velocità di vendita) e una sezione « in questo momento » autogenerata che combina consultazioni delle schede prodotto e vendite recenti. Una scheda dedicata del back office offre la lettura analitica di questi tre flussi.

Installazione

1. Nel back office, aprite Moduli > Gestore moduli e cliccate su Carica un modulo.
2. Selezionate l’archivio dftrending.zip e confermate.
3. Il modulo crea le sue tabelle dati, i valori di configurazione predefiniti e la scheda Statistiche tendenze, quindi si aggancia automaticamente alla home page.

Configurazione

Aprite la configurazione del modulo dal Gestore moduli. Impostazioni disponibili:

• Mostra le ricerche popolari — attiva o nasconde la nuvola di tag.
• Mostra i prodotti in crescita — attiva o nasconde la sezione velocità.
• Mostra la sezione « in questo momento » — attiva o nasconde la combinazione visualizzazioni + vendite.
• Numero di ricerche da mostrare — dimensione della nuvola di tag (8 predefinito).
• Numero di prodotti in crescita e numero di prodotti « in questo momento » — dimensione delle due griglie prodotti (4 predefinito).
• Finestra di analisi (giorni) — durata della finestra recente confrontata con la finestra precedente della stessa durata (7 predefinito).
• Vendite minime per qualificarsi — soglia sotto la quale un prodotto non è mai considerato in crescita (2 predefinito).
• Durata della cache (secondi) — tempo durante il quale i calcoli delle tendenze sono riutilizzati senza interrogazione (3600 predefinito).

Funzionamento

Ricerche popolari

Il modulo ascolta il motore di ricerca nativo di PrestaShop. Ogni query viene normalizzata (minuscole, spazi ridotti, lunghezza tra 2 e 64 caratteri) e aggregata per giorno, per lingua e per negozio. La nuvola mostra le query più frequenti nella finestra di analisi; ogni tag rimanda alla pagina dei risultati corrispondente.

Prodotti in crescita

Le quantità vendute nella finestra recente sono confrontate con quelle della finestra precedente della stessa durata. Solo gli ordini validi sono conteggiati. Il punteggio pondera la crescita per il volume recente: un prodotto che passa da 50 a 90 vendite supera uno che passa da 2 a 4. I prodotti inattivi o invisibili sono esclusi.

Sezione « in questo momento »

Ogni scheda prodotto visitata invia un segnale leggero dal browser, una volta per prodotto e per sessione. Questo conteggio lato client resta esatto dietro una cache a pagina intera. Il punteggio combina visualizzazioni e vendite recenti (una vendita pesa cinque volte più di una visualizzazione); i prodotti già mostrati nella sezione in crescita sono deduplicati automaticamente.

Posizionamento del widget

Per impostazione predefinita il widget appare sulla home page (hook displayHome). Il modulo implementa l’interfaccia widget di PrestaShop: da Aspetto > Posizioni potete agganciarlo a qualsiasi hook di visualizzazione del tema. I prodotti sono renderizzati con le miniature native del tema, in una griglia autonoma che non dipende dai suoi stili.

Cruscotto del back office

La scheda Statistiche tendenze (sotto Moduli) mostra tre pannelli: le migliori ricerche degli ultimi 30 giorni con il loro numero di occorrenze, i prodotti in crescita con vendite recenti, vendite precedenti e percentuale di crescita, e i prodotti più consultati nella finestra di analisi. Ogni prodotto è collegato direttamente alla sua pagina di modifica.

Dati e privacy

Il modulo non memorizza alcun dato personale: nessun identificativo cliente, nessun indirizzo IP, nessun cookie di tracciamento. Solo contatori giornalieri anonimi (query + numero, prodotto + numero) sono conservati, e tutti i dati più vecchi di 90 giorni vengono eliminati automaticamente.

Risoluzione dei problemi

• Il widget non mostra nulla — è normale in un negozio senza storico: ogni sezione resta nascosta finché non ha dati rilevanti. Verificate anche che le sezioni siano attivate nella configurazione.
• I prodotti si impilano verticalmente — svuotate la cache di PrestaShop e forzate il ricaricamento dei fogli di stile (Ctrl+F5) dopo un aggiornamento del modulo.
• Le visualizzazioni non vengono conteggiate — verificate che nessun blocker filtri il file front.js del modulo e che il controller front track risponda (è attesa una risposta JSON).

Registro delle versioni

• 1.0.2 (2026-07-12) — prima versione pubblica: ricerche popolari, velocità di vendita, sezione « in questo momento », cruscotto, cache interna, eliminazione automatica.