Installation & Konfiguration

DasGoogle in Shopware 6 einrichten

Installation

Variante A – ZIP-Upload (empfohlen)

  1. Aktuelles SvenDasGoogle-x.y.z.zip aus den GitHub-Releases herunterladen.
  2. Im Admin-Panel unter Erweiterungen > Meine Erweiterungen > Erweiterung hochladen.
  3. Plugin installieren und aktivieren.

Variante B – Composer / Git (Entwickler)

cd custom/plugins/
git clone https://github.com/zvenson/dasGoogle.git SvenDasGoogle
cd ../..
bin/console plugin:refresh
bin/console plugin:install --activate SvenDasGoogle
bin/console cache:clear

Variante C – ZIP lokal bauen

git clone https://github.com/zvenson/dasGoogle.git SvenDasGoogle
zip -r SvenDasGoogle.zip SvenDasGoogle \
    -x "SvenDasGoogle/.git/*" "SvenDasGoogle/.github/*" "SvenDasGoogle/*.code-workspace"

Google API einrichten

  1. Bei console.cloud.google.com anmelden und ein neues Projekt anlegen.
  2. Unter APIs & Dienste → Bibliothek die Places API aktivieren.
  3. Unter APIs & Dienste → Anmeldedaten einen API-Schlüssel erstellen.
  4. Optional: Den Schlüssel auf die Places API beschränken und nach HTTP-Referrer-Einschränkungen filtern (für Sicherheit).
✓
Kosten: Google stellt jeden Monat 200 USD Gratis-Guthaben bereit. Typische Shop-Nutzung mit 6-Stunden-Cache kostet rund 0,07 USD/Monat — bleibt also locker im Freikontingent.

Place-ID ermitteln

Die Place-ID ist der eindeutige Identifier Ihres Google-Business-Eintrags. So finden Sie sie:

  1. Den Place ID Finder öffnen.
  2. Geschäftsname oder Adresse in das Suchfeld eingeben.
  3. Den korrekten Eintrag auf der Karte anklicken — die Place-ID erscheint im Popup.

Eine Place-ID sieht typischerweise so aus:

ChIJE2a6n2mRsUcxvHfwz7_dYzw

Plugin-Konfiguration

Unter Erweiterungen > Meine Erweiterungen > DasGoogle > Konfigurieren stehen folgende Einstellungen bereit:

EinstellungBeschreibungStandard
API-Key Google Cloud API-Schlüssel mit aktivierter Places API. —
Place-ID Identifier des Google-Business-Eintrags. —
Widget aktivieren Schaltet das Floating-Widget im Storefront ein/aus. true
Widget-Position Horizontal: links / rechts · Vertikal: oben / mittig / unten. rechts unten
Hintergrundfarbe Farbwähler für die Widget-Hintergrundfarbe. —
Cache-Dauer Wie lange API-Antworten zwischengespeichert werden, in Stunden. 6
Bewertungs-URL (optional) Leer lassen, um die URL automatisch aus der Place-ID zu bilden. Nur überschreiben, wenn auf eine andere Bewertungsseite verlinkt werden soll. Siehe Bewertungseinladung per Mail. leer

Floating Widget

Sobald API-Key und Place-ID gesetzt sind und das Widget aktiv ist, erscheint es automatisch auf jeder Storefront-Seite. Die Position lässt sich frei wählen:

Beim Klick auf das Widget öffnet sich eine Detailansicht mit den letzten Bewertungen.

CMS-Element

Das Plugin registriert ein neues CMS-Element „Google Bewertungen“, das Sie im Designer für Erlebniswelten in beliebige Sektionen ziehen können:

  1. Im Admin unter Inhalte > Erlebniswelten eine Erlebniswelt öffnen.
  2. Im Block-Bereich nach Google Bewertungen suchen.
  3. Per Drag & Drop in eine Sektion ziehen.
  4. Speichern — das Karussell zeigt die neuesten Reviews.
ⓘ
API-Limit: Die Google Places API liefert pro Anfrage maximal 5 Bewertungen. Beide Anzeigen (Widget & Karussell) nutzen denselben Cache und denselben Datensatz.

Cache

Jede API-Antwort wird für die konfigurierte Dauer (Standard 6 Stunden) zwischengespeichert. Vorteile:

Wer den Cache manuell leeren will, kann den Shopware-Cache komplett zurücksetzen:

bin/console cache:clear
⚠
Tipp: Die 6-Stunden-Voreinstellung ist ein guter Kompromiss. Für Shops mit konstantem Bewertungsstrom kann auch 1 Stunde sinnvoll sein — bleiben Sie aber unter 30 Minuten, drohen Mehrkosten.
← Übersicht Weiter: Bewertungseinladung per Mail →