# 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),… - Pagina: - Lingua: it - Aggiornato il: 2026-07-07 - Altre lingue: [fr](https://www.datafirefly.com/documentation/carrousel-avis-google-shopware/index.md), [en](https://www.datafirefly.com/en/documentation/carrousel-avis-google-shopware/index.md), [es](https://www.datafirefly.com/es/documentation/carrousel-avis-google-shopware/index.md), [de](https://www.datafirefly.com/de/documentation/carrousel-avis-google-shopware/index.md), [pl](https://www.datafirefly.com/pl/documentation/carrousel-avis-google-shopware/index.md), [nl](https://www.datafirefly.com/nl/documentation/carrousel-avis-google-shopware/index.md), [pt](https://www.datafirefly.com/pt/documentation/carrousel-avis-google-shopware/index.md) - Indice: 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. La modalità automatica utilizza il blocco `base_footer`. Se un tema personalizzato sovrascrive completamente questo blocco senza chiamare `parent()`, usa la modalità manuale qui sotto. ### 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. **Degradazione elegante**: se l'API Google è momentaneamente non disponibile, le ultime recensioni valide in cache continuano a essere mostrate. Lo storefront non viene mai rotto dal widget. ## 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.