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 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.

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.

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.