Carosello di Recensioni Google per Shopware 6 — Installazione, configurazione e utilizzo

Il plugin Carosello di Recensioni Google mostra le recensioni Google della tua attività come carosello responsive nello storefront Shopware 6. Genera automaticamente il markup Schema.org (LocalBusiness + AggregateRating + Review), memorizza le recensioni in cache e include due temi integrati. Non è richiesto alcun build di amministrazione: si installa su qualsiasi hosting, incluso quello condiviso.

Requisiti

• Shopware 6.5.x, 6.6.x o 6.7.x
• PHP 8.1 o superiore
• Una chiave API Google Cloud con l’API Places attivata (gratuita fino a un ampio volume di richieste)
• Il Place ID della tua attività Google

Installazione

Carica l’archivio ZIP tramite Estensioni > Le mie estensioni > Carica estensione, oppure copia la cartella DfGoogleReviews in custom/plugins/. Poi esegui:

bin/console plugin:refresh
bin/console plugin:install --activate DfGoogleReviews
bin/console cache:clear

Il plugin appare quindi in Estensioni > Le mie estensioni, pronto per la configurazione.

Ottenere la chiave API e il Place ID

Chiave API Google

1. Vai su console.cloud.google.com e crea (o seleziona) un progetto.
2. In API e servizi, attiva l’API Places.
3. In Credenziali, crea una chiave API e copiala.
4. Consigliato: limita la chiave all’API Places e al tuo dominio.

Place ID

Utilizza il Place ID Finder di Google (documentazione Google Maps Platform) per recuperare l’identificativo della tua attività. Ha l’aspetto ChIJ....

Configurazione

Apri Estensioni > Le mie estensioni > Carosello di recensioni Google > Configura. Tutte le impostazioni sono gestite per canale di vendita: seleziona il sales channel interessato in alto nella pagina prima di configurare.

Connessione Google

• Attiva il carosello delle recensioni: interruttore principale.
• Chiave API Google: la tua chiave con l’API Places attivata.
• Place ID: l’identificativo della tua attività.
• Lingua delle recensioni: codice lingua (es. fr, de, en) trasmesso all’API per i testi e le date relative. Lascia vuoto per il valore predefinito di Google.

Visualizzazione

• Posizione: Home page (sopra il footer), Tutte le pagine, o Manuale (vedi la sezione successiva).
• Titolo: titolo del carosello (vuoto = titolo tradotto predefinito, incluso in 5 lingue).
• Tema: Light o Dark.
• Scorrimento automatico e intervallo (in millisecondi): pausa automatica al passaggio del mouse e al focus.
• Numero massimo di recensioni: fino a 10 (l’API Google ne restituisce 5 al massimo).
• Valutazione minima: mostra solo le recensioni sopra la soglia (es. 4 per conservare solo quelle a 4 e 5 stelle).

Cache

• Durata della cache: da 1 ora a 7 giorni (24 ore consigliato).

Mostrare il carosello

Modalità automatica

Con la posizione Home page o Tutte le pagine, il carosello viene inserito automaticamente sopra il footer. Non è necessaria alcuna modifica del tema.

Modalità manuale (include Twig)

Scegli la posizione Manuale, poi includi il componente dove vuoi nel tuo tema storefront:

{% sw_include '@DfGoogleReviews/storefront/component/df-google-reviews.html.twig' %}

È ideale per posizionare le recensioni su una pagina CMS specifica, all’interno di una Shopping Experience o in un punto preciso del tuo layout.

Comandi da console

Due comandi facilitano la manutenzione:

# Testare la connessione API e visualizzare in anteprima le recensioni (cache ignorata)
bin/console df:google-reviews:test

# Svuotare la cache delle recensioni
bin/console df:google-reviews:clear-cache

Entrambi accettano l’opzione --sales-channel-id=... per puntare alla configurazione di un canale di vendita specifico. Il comando di test mostra il nome dell’attività, la valutazione complessiva e l’elenco delle recensioni restituite — utile per validare la chiave API e il Place ID prima della pubblicazione.

SEO e Schema.org

A ogni visualizzazione, il plugin inietta un markup JSON-LD completo: LocalBusiness (nome, valutazione complessiva), AggregateRating (media e numero totale di recensioni) e un blocco Review per recensione. Questo markup può far comparire le stelle nei risultati di Google (rich snippet). Poiché il contenuto è renderizzato lato server, le recensioni restano leggibili dai crawler di indicizzazione e dagli utenti senza JavaScript; il carosello è solo un miglioramento progressivo.

Prestazioni

Il CSS (~2 KB) e il JavaScript (~2 KB, vanilla JS) vengono iniettati solo sulle pagine in cui il carosello viene mostrato. Nessuna libreria di terze parti, nessun jQuery. Le chiamate all’API Google Places vengono memorizzate nella cache a oggetti di Shopware secondo la durata configurata.

Risoluzione dei problemi

• Il carosello non appare: verifica che il plugin sia attivato, che la casella «Attiva il carosello delle recensioni» sia selezionata, e che la chiave API e il Place ID siano compilati. Esegui bin/console df:google-reviews:test per diagnosticare.
• Errore API: assicurati che l’API Places sia attivata in Google Cloud e che la chiave non sia troppo limitata. Consulta var/log per i dettagli.
• Le recensioni non si aggiornano: svuota la cache con bin/console df:google-reviews:clear-cache (l’API Google restituisce comunque solo le 5 recensioni più recenti).
• Modalità automatica invisibile su un tema personalizzato: passa alla modalità manuale e aggiungi l’include Twig.

Disinstallazione

Disattiva e poi disinstalla il plugin da Estensioni > Le mie estensioni, oppure tramite:

bin/console plugin:uninstall DfGoogleReviews

Se scegli di rimuovere i dati durante la disinstallazione, tutta la configurazione (chiavi DfGoogleReviews.config.*) viene pulita automaticamente.