Google-Bewertungen-Karussell für Shopware 6 — Installation, Konfiguration und Nutzung

Das Plugin Google-Bewertungen-Karussell zeigt die Google-Bewertungen Ihres Unternehmens als responsives Karussell im Shopware-6-Storefront an. Es generiert automatisch Schema.org-Markup (LocalBusiness + AggregateRating + Review), cacht die Bewertungen und bringt zwei integrierte Themes mit. Es ist kein Administration-Build erforderlich: Es lässt sich auf jedem Hosting installieren, auch auf Shared Hosting.

Voraussetzungen

• Shopware 6.5.x, 6.6.x oder 6.7.x
• PHP 8.1 oder höher
• Ein Google-Cloud-API-Schlüssel mit aktivierter Places API (kostenlos bis zu einem großen Anfragevolumen)
• Die Place ID Ihres Google-Unternehmens

Installation

Laden Sie das ZIP-Archiv über Erweiterungen > Meine Erweiterungen > Erweiterung hochladen hoch oder kopieren Sie den Ordner DfGoogleReviews nach custom/plugins/. Führen Sie dann aus:

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

Das Plugin erscheint anschließend unter Erweiterungen > Meine Erweiterungen, bereit zur Konfiguration.

API-Schlüssel und Place ID beschaffen

Google-API-Schlüssel

1. Gehen Sie zu console.cloud.google.com und erstellen (oder wählen) Sie ein Projekt.
2. Aktivieren Sie unter APIs und Dienste die Places API.
3. Erstellen Sie unter Anmeldedaten einen API-Schlüssel und kopieren Sie ihn.
4. Empfohlen: Beschränken Sie den Schlüssel auf die Places API und Ihre Domain.

Place ID

Verwenden Sie den Place ID Finder von Google (Dokumentation der Google Maps Platform), um die Kennung Ihres Unternehmens abzurufen. Sie sieht aus wie ChIJ....

Konfiguration

Öffnen Sie Erweiterungen > Meine Erweiterungen > Google-Bewertungen-Karussell > Konfigurieren. Alle Einstellungen werden pro Verkaufskanal verwaltet: Wählen Sie oben auf der Seite den betreffenden Sales Channel aus, bevor Sie konfigurieren.

Google-Verbindung

• Bewertungs-Karussell aktivieren: Hauptschalter.
• Google-API-Schlüssel: Ihr Schlüssel mit aktivierter Places API.
• Place ID: die Kennung Ihres Unternehmens.
• Sprache der Bewertungen: Sprachcode (z. B. fr, de, en), der an die API für Bewertungstexte und relative Daten übergeben wird. Leer lassen für den Google-Standard.

Anzeige

• Position: Startseite (über dem Footer), Alle Seiten oder Manuell (siehe nächster Abschnitt).
• Titel: Titel des Karussells (leer = übersetzter Standardtitel, in 5 Sprachen enthalten).
• Theme: Light oder Dark.
• Autoplay und Intervall (in Millisekunden): automatische Pause bei Hover und Fokus.
• Maximale Anzahl Bewertungen: bis zu 10 (die Google-API liefert maximal 5).
• Mindestbewertung: zeigt nur Bewertungen oberhalb des Schwellenwerts an (z. B. 4, um nur 4- und 5-Sterne-Bewertungen zu behalten).

Cache

• Cache-Lebensdauer: von 1 Stunde bis 7 Tage (24 Stunden empfohlen).

Das Karussell anzeigen

Automatischer Modus

Mit der Position Startseite oder Alle Seiten wird das Karussell automatisch über dem Footer eingefügt. Es ist keine Theme-Änderung erforderlich.

Manueller Modus (Twig-Include)

Wählen Sie die Position Manuell und binden Sie die Komponente an beliebiger Stelle in Ihrem Storefront-Theme ein:

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

Ideal, um die Bewertungen auf einer bestimmten CMS-Seite, innerhalb einer Shopping Experience oder an einer präzisen Stelle Ihres Layouts zu platzieren.

Konsolenbefehle

Zwei Befehle erleichtern die Wartung:

# API-Verbindung testen und Bewertungen in der Vorschau anzeigen (Cache umgangen)
bin/console df:google-reviews:test

# Bewertungs-Cache leeren
bin/console df:google-reviews:clear-cache

Beide akzeptieren die Option --sales-channel-id=..., um die Konfiguration eines bestimmten Verkaufskanals anzusprechen. Der Testbefehl zeigt den Unternehmensnamen, die Gesamtbewertung und die Liste der zurückgegebenen Bewertungen an — praktisch, um API-Schlüssel und Place ID vor der Veröffentlichung zu prüfen.

SEO und Schema.org

Bei jeder Anzeige fügt das Plugin ein vollständiges JSON-LD-Markup ein: LocalBusiness (Name, Gesamtbewertung), AggregateRating (Durchschnitt und Gesamtzahl der Bewertungen) sowie einen Review-Block pro Bewertung. Dieses Markup kann Sterne in den Google-Ergebnissen erscheinen lassen (Rich Snippets). Da der Inhalt serverseitig gerendert wird, bleiben die Bewertungen für Crawler und Nutzer ohne JavaScript lesbar; das Karussell ist lediglich eine progressive Verbesserung.

Performance

Das CSS (~2 KB) und das JavaScript (~2 KB, Vanilla JS) werden nur auf Seiten eingebunden, auf denen das Karussell angezeigt wird. Keine Drittanbieter-Bibliothek, kein jQuery. Die Aufrufe der Google Places API werden gemäß der konfigurierten Dauer im Shopware-Objekt-Cache gespeichert.

Fehlerbehebung

• Das Karussell erscheint nicht: Prüfen Sie, ob das Plugin aktiviert ist, ob das Kästchen „Bewertungs-Karussell aktivieren“ angehakt ist und ob API-Schlüssel und Place ID eingetragen sind. Führen Sie bin/console df:google-reviews:test zur Diagnose aus.
• API-Fehler: Stellen Sie sicher, dass die Places API in Google Cloud aktiviert ist und der Schlüssel nicht zu stark eingeschränkt ist. Prüfen Sie var/log für Details.
• Bewertungen werden nicht aktualisiert: Leeren Sie den Cache mit bin/console df:google-reviews:clear-cache (die Google-API liefert ohnehin nur die 5 neuesten Bewertungen).
• Automatischer Modus auf einem individuellen Theme unsichtbar: Wechseln Sie in den manuellen Modus und fügen Sie das Twig-Include hinzu.

Deinstallation

Deaktivieren und deinstallieren Sie das Plugin über Erweiterungen > Meine Erweiterungen oder per:

bin/console plugin:uninstall DfGoogleReviews

Wenn Sie bei der Deinstallation die Datenlöschung wählen, wird die gesamte Konfiguration (DfGoogleReviews.config.*-Schlüssel) automatisch bereinigt.