# 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…

- Seite: <https://www.datafirefly.com/de/documentation/carrousel-avis-google-shopware/>
- Sprache: de
- Aktualisiert am: 2026-07-07
- Weitere Sprachen: [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), [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), [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)
- Index: <https://www.datafirefly.com/de/documentation/llms.txt>

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.

Der automatische Modus nutzt den Block `base_footer`. Überschreibt ein individuelles Theme diesen Block vollständig, ohne `parent()` aufzurufen, verwenden Sie den manuellen Modus unten.

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

**Gracefülle Degradierung**: Ist die Google-API vorübergehend nicht verfügbar, werden weiterhin die letzten gültigen gecachten Bewertungen angezeigt. Das Storefront wird durch das Widget niemals zerstört.

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