# Google-reviewscarrousel voor Shopware 6: installatie, configuratie en gebruik

> De plugin Google-reviewscarrousel toont de Google-reviews van uw vestiging als een responsieve carrousel in de Shopware 6 storefront. De plugin genereert automatisch de Schema.org-markup (LocalBusiness + AggregateRating + Review), slaat…

- Pagina: <https://www.datafirefly.com/nl/documentation/carrousel-avis-google-shopware/>
- Taal: nl
- Bijgewerkt op: 2026-08-18
- Andere talen: [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), [it](https://www.datafirefly.com/it/documentation/carrousel-avis-google-shopware/index.md), [pl](https://www.datafirefly.com/pl/documentation/carrousel-avis-google-shopware/index.md), [pt](https://www.datafirefly.com/pt/documentation/carrousel-avis-google-shopware/index.md)
- Index: <https://www.datafirefly.com/nl/documentation/llms.txt>

De plugin **Google-reviewscarrousel** toont de Google-reviews van uw vestiging als een responsieve carrousel in de Shopware 6 storefront. De plugin genereert automatisch de Schema.org-markup (LocalBusiness + AggregateRating + Review), slaat de reviews op in cache en biedt twee ingebouwde thema's. Er is geen administration build nodig: de plugin werkt op elke hosting, ook op gedeelde hosting.

## Vereisten

- Shopware 6.5.x, 6.6.x of 6.7.x
- PHP 8.1 of hoger
- Een Google Cloud API-sleutel met de **Places API** geactiveerd (gratis tot een ruim aantal aanvragen)
- Het **Place ID** van uw Google-vestiging

## Installatie

Upload het ZIP-archief via _Extensies > Mijn extensies > Extensie uploaden_, of kopieer de map `DfGoogleReviews` naar `custom/plugins/`. Voer daarna uit:

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

De plugin verschijnt vervolgens onder _Extensies > Mijn extensies_, klaar om geconfigureerd te worden.

## Uw API-sleutel en Place ID verkrijgen

### Google API-sleutel

1. Ga naar `console.cloud.google.com` en maak een project aan (of selecteer een bestaand project).
2. Activeer onder _API's en services_ de **Places API**.
3. Maak onder _Inloggegevens_ een API-sleutel aan en kopieer deze.
4. Aanbevolen: beperk de sleutel tot de Places API en tot uw domein.

### Place ID

Gebruik de _Place ID Finder_ van Google (documentatie Google Maps Platform) om de identificatie van uw vestiging op te halen. Deze ziet eruit als `ChIJ...`.

## Configuratie

Open _Extensies > Mijn extensies > Google-reviewscarrousel > Configureren_. Alle instellingen worden **per verkoopkanaal** beheerd: selecteer bovenaan de pagina het betreffende sales channel voordat u begint.

### Google-verbinding

- **Carrousel activeren**: hoofdschakelaar.
- **Google API-sleutel**: uw sleutel met de Places API geactiveerd.
- **Place ID**: de identificatie van uw vestiging.
- **Taal van de reviews**: taalcode (bijv. `nl`, `de`, `en`) die aan de API wordt doorgegeven voor de teksten en relatieve datums. Laat leeg voor de standaardinstelling van Google.

### Weergave

- **Positie**: _Homepage_ (boven de footer), _Alle pagina's_, of _Handmatig_ (zie het volgende hoofdstuk).
- **Titel**: titel van de carrousel (leeg = standaard vertaalde titel, geleverd in 5 talen).
- **Thema**: Light of Dark.
- **Automatisch scrollen** en **interval** (in milliseconden): pauzeert automatisch bij hover en bij focus.
- **Maximaal aantal reviews**: tot 10 (de Google API levert er maximaal 5).
- **Minimale beoordeling**: toont alleen reviews boven de drempel (bijv. 4 om alleen 4 en 5 sterren te behouden).

### Cache

- **Levensduur van de cache**: van 1 uur tot 7 dagen (24 uur aanbevolen).

## De carrousel tonen

### Automatische modus

Met de positie _Homepage_ of _Alle pagina's_ wordt de carrousel automatisch boven de footer ingevoegd. Aanpassingen aan het thema zijn niet nodig.

De automatische modus verloopt via het blok `base_footer`. Als een aangepast thema dit blok volledig overschrijft zonder `parent()` aan te roepen, gebruik dan de handmatige modus hieronder.

### Handmatige modus (Twig-include)

Kies de positie _Handmatig_ en voeg het component daarna in op de gewenste plek in uw storefront-thema:

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

Dit is ideaal om de reviews op een specifieke CMS-pagina te plaatsen, in een Shopping Experience of op een precieze plek in uw lay-out.

## Consolecommando's

Twee commando's vergemakkelijken het onderhoud:

```
# De API-verbinding testen en de reviews bekijken (cache genegeerd)
bin/console df:google-reviews:test

# De cache van de reviews legen
bin/console df:google-reviews:clear-cache
```

Beide accepteren de optie `--sales-channel-id=...` om de configuratie van een specifiek verkoopkanaal aan te spreken. Het testcommando toont de naam van de vestiging, de algemene beoordeling en de lijst met teruggegeven reviews, handig om de API-sleutel en het Place ID te valideren voordat u live gaat.

## SEO en Schema.org

Bij elke weergave injecteert de plugin volledige JSON-LD-markup: `LocalBusiness` (naam, algemene beoordeling), `AggregateRating` (gemiddelde en totaal aantal reviews) en een `Review`-blok per review. Deze markup kan sterren laten verschijnen in de Google-resultaten (rich snippets). Omdat de inhoud server-side wordt gerenderd, blijven de reviews leesbaar voor zoekmachinerobots en voor gebruikers zonder JavaScript; de carrousel is enkel een progressieve verbetering.

## Prestaties

De CSS (ongeveer 2 KB) en de JavaScript (ongeveer 2 KB, Vanilla JS) worden alleen geladen op pagina's waar de carrousel wordt getoond. Geen externe bibliotheken, geen jQuery. De aanroepen naar de Google Places API worden opgeslagen in de objectcache van Shopware volgens de ingestelde levensduur.

**Graceful degradation**: als de Google API tijdelijk niet beschikbaar is, blijven de laatste geldige reviews uit de cache zichtbaar. De storefront raakt nooit stuk door de widget.

## Probleemoplossing

- **De carrousel verschijnt niet**: controleer of de plugin geactiveerd is, of het vakje "Carrousel activeren" aangevinkt is en of de API-sleutel en het Place ID ingevuld zijn. Voer `bin/console df:google-reviews:test` uit om te diagnosticeren.
- **API-fout**: controleer of de Places API daadwerkelijk geactiveerd is in Google Cloud en of de sleutel niet te streng beperkt is. Raadpleeg `var/log` voor details.
- **De reviews worden niet bijgewerkt**: leeg de cache met `bin/console df:google-reviews:clear-cache` (de Google API levert sowieso alleen de 5 meest recente reviews).
- **Automatische modus onzichtbaar op een custom thema**: schakel over naar de handmatige modus en voeg de Twig-include toe.

## Verwijderen

Deactiveer en verwijder de plugin via _Extensies > Mijn extensies_, of met:

```
bin/console plugin:uninstall DfGoogleReviews
```

Als u bij het verwijderen kiest om de gegevens te wissen, wordt de volledige configuratie (sleutels `DfGoogleReviews.config.*`) automatisch opgeruimd.