Statistiche Live di vendite & visualizzazioni dei prodotti: configurazione e aiuto

1. Carica lo ZIP di Product Sales & Views Live Stats tramite "Modules > Module Manager".
2. Apri "Configure".
3. Lascia "Enable module" attivo e scegli i conteggi da mostrare.
4. Lascia "Minimum count to display" a 0 per il primo test, poi salva.
5. Visita un prodotto in un browser normale con un ID ospite PrestaShop. Ricarica e controlla il widget.
6. Prova il badge vendite su un prodotto con un ordine valido e apri la finestra degli acquisti recenti.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.

Ogni statistica prodotto compare solo se attiva e maggiore di zero. Impostare la soglia a 0 non mostra badge con valore zero. I badge degli elenchi possono apparire indipendentemente dal comando "Show sales count" della pagina prodotto.

L'hook displayHeader registra una visualizzazione solo sulle pagine prodotto con un ID prodotto e un ID ospite. I controlli sui bot precedono l'inserimento. Lo stesso ospite, prodotto e negozio non vengono registrati di nuovo per 30 minuti.

La statistica delle visualizzazioni conta gli ID ospite distinti nell'intero periodo, anche se un ospite ha più record salvati. La statistica vendite conta gli ordini distinti con valid = 1 nel periodo e nel negozio. Gli ordini validi esistenti possono contribuire subito; le visualizzazioni storiche precedenti all'installazione non vengono importate.

I visitatori live sono gli ospiti distinti registrati nella finestra recente. Non è un conteggio continuo della presenza online. Il browser non invia segnali periodici per mantenere un visitatore live e la soppressione dei duplicati può impedire alle visite ripetute di aggiornare il timestamp per 30 minuti.

Il filtro bot usa una tabella condivisa mpr_sessions compatibile quando disponibile. Altrimenti confronta lo user-agent con modelli comuni di bot e automazione.

Il form attuale delle impostazioni per il commerciante espone le sette opzioni di visualizzazione sopra elencate. I valori seguenti sono salvati dal modulo, ma non hanno controlli separati in quel form. Questi nomi sono chiavi di memorizzazione, non un file di configurazione importabile.

Le visualizzazioni e le vendite mostrate usano max(0, round(raw * multiplier) + flat). Mantieni i moltiplicatori a 1.0 e gli importi fissi a 0 per ottenere i conteggi grezzi. Un'integrazione sviluppata appositamente può impostare 24 ore, 30 giorni o 3 mesi. Non esistono un conteggio iniziale per prodotto, un campo per modelli di testo o impostazioni di esclusione di prodotti/categorie.

La finestra recupera i dettagli degli ordini validi recenti del prodotto selezionato, inclusi nome dell'acquirente mascherato per impostazione predefinita, città, paese, tempo relativo, nome prodotto e quantità. Una riga di acquisto recente è una riga di dettaglio ordine; più combinazioni in un ordine possono generare più righe. Non è la stessa unità del totale vendite basato su ordini distinti.

Il widget prodotto usa displayProductAdditionalInfo. L'output negli elenchi usa displayProductListReviews; le risorse vengono preparate per pagine di categoria, ricerca, produttore, fornitore, nuovi prodotti, più venduti e offerte quando la visualizzazione negli elenchi è attiva.

Per un tema personalizzato privo di questi hook, aggiungi una sola volta la chiamata appropriata:

{hook h='displayProductAdditionalInfo' product=$product}
{hook h='displayProductListReviews' product=$product}

Il controller AJAX supporta action=getRecentOrders e action=getStats, entrambi con id_product. Genera l'URL del modulo con gli helper dei link PrestaShop nelle integrazioni personalizzate. Lo script incluso carica la finestra acquisti; la presenza di un endpoint statistiche non significa che il widget si aggiorni continuamente.

• Usa un browser normale per i test delle visualizzazioni. Gli strumenti automatici possono essere filtrati come bot. Verifica che il browser abbia un ID ospite PrestaShop.
• Visita lo stesso prodotto due volte entro 30 minuti. Non dovrebbe aggiungere una seconda visualizzazione salvata. Usa un'altra sessione ospite per verificare i visitatori distinti.
• Confronta le vendite con gli ordini validi creati nell'intervallo di riferimento, anziché con le unità totali ordinate o tutti gli stati ordine.
• Se non compare alcun badge, controlla impostazioni attive, conteggi zero, soglia e hook del tema.
• Se la finestra non funziona, controlla risposta AJAX, errori JavaScript e connessione al database del negozio. Ricorda che l'anonimizzazione nasconde solo i nomi.

Usa .mprpsvls-widget, .mprpsvls-bar e .mprpsvls-listing-badge nel foglio di stile del tema. Theme Detector fornisce variabili tra cui --mprpsvls-primary, --mprpsvls-bg e --mprpsvls-border.

.mprpsvls-widget { margin: 12px 0 18px; }
.mprpsvls-bar { --mprpsvls-primary: #1f7a4d; }
.mprpsvls-listing-badge { font-size: 0.75rem; }

Disattiva "Enable module" per interrompere output e tracciamento normali. La disinstallazione rimuove configurazione del modulo, menu, registrazione Theme Detector e tabella di tracciamento delle visualizzazioni. Salva prima una copia della tabella se ti serve lo storico. Gli ordini PrestaShop esistenti restano intatti.