Recensioni Verificate WooCommerce — Documentazione

DataFirefly Reviews (dfreviews) trasforma il sistema di recensioni nativo di WooCommerce in una macchina di riprova sociale: richieste di recensioni automatiche post-acquisto, badge Acquisto verificato, foto dei clienti, voti utili, riepilogo IA sulla scheda prodotto, risposta automatica alle recensioni tramite IA, coupon premio e rich snippet Schema.org. Questa documentazione copre installazione, configurazione completa e risoluzione dei problemi.

Installazione

1. Nell’amministrazione di WordPress, apra Plugin → Aggiungi nuovo → Carica plugin.
2. Selezioni dfreviews-1.0.0.zip, clicchi su Installa ora e poi su Attiva.
3. Compare un nuovo sottomenu WooCommerce → DF Reviews: è il centro di controllo del plugin.

Requisiti: WooCommerce 8 o 9, WordPress 6.0+, PHP da 8.0 a 8.3. Il plugin è compatibile HPOS (High-Performance Order Storage) e funziona senza jQuery né Composer.

Configurazione della chiave OpenAI

Il riepilogo IA e la risposta automatica utilizzano la sua chiave API OpenAI personale:

1. Crei una chiave su platform.openai.com.
2. La incolli in WooCommerce → DF Reviews → Settings, sezione OpenAI.
3. Il modello predefinito è gpt-4o-mini — il più economico, consigliato. Un riepilogo o una risposta costa in genere molto meno di un centesimo.

Richieste di recensioni automatiche

Sezione Review requests delle impostazioni:

• Stato attivatore: la richiesta viene messa in coda quando un ordine raggiunge questo stato (predefinito Completato).
• Ritardo di invio: giorni di attesa dopo lo stato attivatore (predefinito: 3 giorni).
• Promemoria: parte un’unica email di promemoria se non è stata pubblicata alcuna recensione (predefinito: 5 giorni dopo la prima email).

Ogni email contiene un link di recensione personale con token: la recensione pubblicata tramite esso riceve automaticamente il badge Acquisto verificato. Gli invii avvengono a lotti di 50 a ogni passaggio del cron. La scheda Request queue elenca le ultime 100 richieste con il loro stato (pending, sent, reminded, completed, failed, unsubscribed) e permette di avviare un’elaborazione manuale.

Riepilogo IA delle recensioni

Non appena un prodotto raggiunge il numero minimo di recensioni pubblicate (predefinito: 3), il cron genera un blocco mostrato in cima alla scheda recensioni: punti di forza, punti di attenzione e sintesi.

• Il riepilogo è memorizzato nella cache per prodotto e per lingua: con Polylang o WPML, ogni versione linguistica mostra un riepilogo nella propria lingua.
• Viene rigenerato automaticamente alla pubblicazione di nuove recensioni (invalidazione tramite impronta delle recensioni analizzate).
• L’impostazione Max reviews analyzed limita quante recensioni vengono inviate al modello.

La scheda AI tools elenca i riepiloghi generati con lingua e data.

Risposta automatica alle recensioni tramite IA

Ogni recensione pubblicata può ricevere una risposta del venditore generata dall’IA, redatta nella lingua della recensione. Impostazioni chiave:

• Modalità di pubblicazione: Bozza (consigliata all’inizio — ogni risposta attende la sua approvazione nella schermata Commenti) o Pubblicazione immediata.
• Tono: caloroso, professionale o conciso.
• Nome della firma: mostrato come autore della risposta (vuoto = nome del sito).
• Rispondere ai voti da: 1 per rispondere a tutte le recensioni — consigliato, poiché le recensioni negative sono quelle che beneficiano di più di una risposta.

Salvaguardie integrate: per voti di 3/5 o inferiori, la risposta si scusa e rinvia all’assistenza, senza mai promettere un rimborso. Le risposte sono limitate a circa 70 parole, mostrate con il badge Risposta ufficiale ed escluse dalle medie e dai rich snippet.

Foto, voti e coupon premio

• Foto dei clienti: i clienti allegano fino a 3 foto (configurabile, max 10) alla recensione — jpg, png, webp, gif, max 5 MB, mostrate con lightbox.
• Voti utili: pulsanti «Questa recensione ti è stata utile?» con protezione antiduplicati per account e per IP con hash. Mai mostrati sulle risposte del venditore.
• Coupon premio: alla pubblicazione della recensione, il cliente riceve un coupon percentuale (predefinito: 10 %, 30 giorni), unico, monouso, limitato alla sua email. Anti-farming: un solo premio per email e per prodotto.

Modulo e visualizzazione

• Campo titolo della recensione, facoltativo od obbligatorio.
• Lunghezza minima della recensione in caratteri (predefinito: 10).
• Blocco di distribuzione delle valutazioni (barre da 5★ a 1★) sopra l’elenco delle recensioni.
• Colore delle stelle personalizzabile (esadecimale, predefinito #e7a11a).

Rich snippet Schema.org

Il plugin conserva il markup AggregateRating e Review nativo di WooCommerce ripulendolo: le risposte del venditore sono escluse dal markup e dalle medie, per stelle Google sempre esatte. L’opzione può essere disattivata nelle impostazioni, il che rimuove allora tutto il markup delle recensioni.

Cron: invii affidabili

L’elaborazione (richieste, promemoria, riepiloghi IA, risposte di recupero) viene eseguita ogni ora tramite WP-Cron. Poiché WP-Cron si attiva solo con le visite al sito, configuri un vero cron server per un invio affidabile:

1. Copi l’URL di cron con token mostrato in Settings → Cron.
2. Lo aggiunga al cron del suo hosting (o crontab), ogni 15-60 minuti, ad esempio con curl -s "URL" > /dev/null.

Un blocco anticoncorrenza impedisce due esecuzioni simultanee. Il pulsante Run processing now della scheda Request queue avvia un’elaborazione manuale in qualsiasi momento.

Importazione ed esportazione CSV

Scheda Import / Export:

• Esportazione: tutte le recensioni prodotto con voto, titolo, indicatore verificato e date.
• Importazione: CSV con riga di intestazione e colonne product_id o sku, author, email, rating, title, content, date (Y-m-d H:i:s, facoltativo), verified (1/0, facoltativo). Le statistiche delle valutazioni vengono ricalcolate automaticamente dopo l’importazione.

Account cliente

Una scheda Le mie recensioni viene aggiunta all’account cliente (Il mio account): ogni cliente vi ritrova le sue recensioni con stato di moderazione, stelle e badge verificato. Se la scheda restituisce un errore 404 dopo l’attivazione, salvi di nuovo i permalink in Impostazioni → Permalink → Salva.

GDPR e dati

• Link di disiscrizione in ogni email di richiesta; indirizzi disiscritti memorizzati come hash SHA-256, mai in chiaro.
• Indirizzi IP dei votanti con hash tramite il salt di WordPress.
• Unica chiamata in uscita: l’API OpenAI che lei controlla, e solo se una chiave è configurata.
• La disinstallazione elimina tabelle e impostazioni del plugin ma conserva tutte le recensioni (recensioni WooCommerce native).

Risoluzione dei problemi

• Le richieste non partono: verifichi che la funzione sia attiva, che gli ordini raggiungano lo stato attivatore e che il cron giri (ultimo passaggio mostrato in AI tools). Configuri l’URL di cron server.
• Nessun riepilogo IA: chiave OpenAI configurata? Numero minimo di recensioni pubblicate raggiunto? Il riepilogo viene generato al passaggio del cron, non istantaneamente.
• Nessuna risposta IA: verifichi la modalità (in bozza, la risposta attende in Commenti → In attesa), il voto minimo configurato e la chiave API.
• Email non ricevute: il plugin invia tramite il mailer di WooCommerce — testi la sua configurazione email globale (si consiglia un plugin SMTP).