DataFirefly Recensioni Verificate: documentazione

Requisiti e installazione

DataFirefly Recensioni Verificate funziona su PrestaShop da 8.0 a 9.0 con PHP da 8.0 a 8.4. Dalla versione 1.1.0 un unico ZIP copre entrambi i rami: al download non c’è da scegliere tra una versione PS 8 e una versione PS 9.

1. Nel back office aprite Moduli → Gestore moduli e cliccate su Carica un modulo.
2. Trascinate il file dfreviews.zip scaricato dal vostro account DataFirefly.
3. Cliccate su Configura a installazione completata.

L’installazione crea sei tabelle dedicate (recensioni, media, richieste, voti utili, riassunti IA, statistiche) e aggiunge una scheda Recensioni Verificate nel menu Catalogo. È da quella scheda che si moderano le recensioni; la schermata di configurazione resta accessibile dal gestore moduli.

Configurare l’attivazione delle richieste di recensione

È il cuore del modulo. Due impostazioni, nella sezione Parametri generali:

• Attiva dopo lo stato: Spedito (predefinito) o Consegnato. Scegliete quello che, nel vostro flusso reale, indica che il cliente ha il prodotto tra le mani.
• Attesa prima dell’invio: 3 giorni per impostazione predefinita. Considerate il tempo di consegna più qualche giorno di utilizzo. Per un prodotto che si giudica all’uso (cosmetici, materassi), salite a 10 o 15 giorni.

Quando un ordine raggiunge lo stato scelto, una richiesta viene messa in coda con la data di invio calcolata. Non parte subito: se ne occupa il CRON.

Impostare il CRON

Senza CRON non parte nessuna email. L’URL da chiamare è mostrato in cima alla schermata di configurazione del modulo e contiene un token unico generato durante l’installazione. Programmatelo ogni ora presso il vostro hosting:

0 * * * * wget -q -O /dev/null "URL_CRON_MOSTRATO_NEL_MODULO"

A ogni passaggio il CRON esegue tre elaborazioni e restituisce un riepilogo JSON del lavoro svolto:

• invio delle richieste in scadenza, a lotti di 50;
• invio dei solleciti per le richieste rimaste senza risposta;
• scadenza delle richieste più vecchie di 60 giorni.

Solleciti e codice sconto come ricompensa

La sezione Sollecito attiva una seconda email se la recensione non è stata lasciata dopo un intervallo configurabile (5 giorni per impostazione predefinita, contati dal primo invio). Viene inviato un solo sollecito per richiesta.

La sezione Codice sconto incentivo genera un buono sconto non appena una recensione viene pubblicata da un cliente identificato. Impostate la percentuale (10 % per impostazione predefinita) e la durata di validità (30 giorni). Il codice creato è una regola carrello nativa PrestaShop, nominativa e monouso, quindi lo ritrovate in Catalogo → Sconti.

Attivare il riassunto IA

Inserite la vostra chiave API OpenAI nella sezione Intelligenza Artificiale e scegliete un modello. gpt-4o-mini è quello predefinito: è il più economico, nell’ordine di mezzo centesimo per riassunto.

Il riassunto si attiva a partire da tre recensioni pubblicate su un prodotto. Il modulo invia fino a 100 recensioni a OpenAI e recupera tre elementi strutturati: punti di forza, punti deboli, sintesi complessiva. Il risultato viene messo in cache per prodotto, per negozio e per lingua, poi mostrato in cima all’area recensioni della scheda prodotto.

Potete disattivare la visualizzazione senza eliminare la chiave grazie all’opzione Mostra il riassunto IA sulla pagina prodotto.

Rich snippet e visualizzazione front office

Quando l’opzione Rich Snippet è attiva, il modulo inietta dati strutturati Schema.org (AggregateRating, Review, Offer, Brand) su ogni scheda prodotto che raggiunge il numero minimo di recensioni configurato. Verificate il risultato con lo strumento di test dei risultati avanzati di Google dopo il passaggio del crawler.

Lato visualizzazione, il modulo si aggancia agli hook nativi del tema:

• displayProductAdditionalInfo: le stelle e il voto medio sotto il titolo del prodotto;
• displayProductExtraContent: la scheda «Recensioni clienti» con elenco, filtri e modulo;
• displayProductListReviews: le stelle nelle liste di categoria;
• displayCustomerAccount: il link «Le mie recensioni» nell’account cliente.

Questi hook esistono nei temi Classic e Hummingbird. Su un tema su misura che li avesse rimossi, vanno ripristinati nei template interessati, altrimenti le recensioni non compariranno da nessuna parte.

Moderare le recensioni

La schermata Catalogo → Recensioni Verificate mostra una dashboard (totale, pubblicate, in attesa, segnalate, voto medio, richieste in coda) seguita dall’elenco completo delle recensioni.

Per impostazione predefinita ogni recensione attende la vostra convalida. Attivate Approvazione automatica se preferite la pubblicazione immediata. Dall’elenco potete approvare o rifiutare in blocco e aprire una recensione per modificarla o rispondere.

La risposta del venditore viene mostrata pubblicamente sotto la recensione. Se è configurata una chiave OpenAI, un pulsante Suggerimento IA di risposta propone una bozza adatta al tono della recensione, da rileggere e correggere prima di salvare, mai da pubblicare così com’è.

Foto dei clienti

I clienti possono allegare fino a N foto per recensione (3 per impostazione predefinita). Formati accettati: JPEG, PNG e WebP, 5 MB massimo per file. Il tipo reale del file viene verificato alla ricezione, indipendentemente dal nome.

Le immagini sono archiviate in modules/dfreviews/uploads/. Includete questa cartella nei vostri backup: eliminare una recensione elimina anche i suoi file.

Importare ed esportare le recensioni

Dalla schermata Recensioni Verificate, il pulsante Esporta CSV produce un file UTF-8 separato da punto e virgola, leggibile direttamente in Excel. Il blocco di importazione, subito sotto, permette di caricare un file nello stesso formato.

Due colonne sono obbligatorie: id_product e rating (da 1 a 5). Le altre sono facoltative: customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply e date_add. Le righe il cui prodotto non esiste vengono ignorate e segnalate. Spuntate Approva automaticamente per pubblicare subito le recensioni importate.

Il modo più semplice per preparare una migrazione da Trustpilot o da un vecchio modulo: esportare prima un file dal modulo per recuperare l’intestazione esatta, poi versarci i vostri dati.

Multinegozio e multilingua

Tutta la configurazione è indipendente per sotto-negozio: chiave OpenAI, stato attivatore, tempi, colori, incentivo. Le recensioni sono separate per id_shop, quindi uno stesso prodotto presente in più negozi può mostrare insiemi di recensioni diversi a seconda del contesto.

Le recensioni e i riassunti IA sono archiviati con il loro id_lang. Un riassunto viene generato per la lingua in cui è richiesto.

Passare da PrestaShop 8 a PrestaShop 9

Non serve alcuna migrazione di dati: lo schema è identico sui due rami. Sostituite il modulo con la versione 1.1.0 prima o dopo l’aggiornamento di PrestaShop, nell’ordine che preferite.

Se aggiornate da una 1.0.x su un negozio già passato a PS 9, due punti da conoscere: le versioni precedenti alla 1.1.0 non si installano su PS 9 (la registrazione di hook senza metodo corrispondente viene rifiutata) e la configurazione esistente viene conservata integralmente durante l’aggiornamento.

Risoluzione dei problemi

Non parte nessuna email di richiesta. Verificate prima che il CRON giri davvero chiamando il suo URL a mano: la risposta JSON indica il numero di invii. Controllate poi lo stato attivatore configurato e le impostazioni email del negozio in Parametri avanzati → E-mail.

Le stelle non compaiono sulla scheda prodotto. Probabilmente il tema non chiama gli hook elencati sopra. Verificate anche che almeno una recensione sia pubblicata: senza recensioni attive non viene mostrato nulla.

Il riassunto IA non viene generato. Servono almeno tre recensioni pubblicate e una chiave OpenAI valida e con credito. Gli errori di chiamata API sono tracciati in Parametri avanzati → Log.

Le stelle non compaiono su Google. L’indicizzazione richiede da qualche giorno a qualche settimana. Verificate il markup con lo strumento di test dei risultati avanzati e controllate che un altro modulo SEO non inietti un secondo blocco Product concorrente sulla stessa pagina.

L’importazione CSV non fa nulla. Era un difetto delle versioni 1.0.x, corretto nella 1.1.0.