# Karuzela Opinii Google dla Shopware 6: instalacja, konfiguracja i użytkowanie
> Wtyczka Karuzela Opinii Google wyświetla opinie Google o Twojej firmie w formie responsywnej karuzeli w storefroncie Shopware 6. Automatycznie generuje znaczniki Schema.org (LocalBusiness + AggregateRating + Review), buforuje opinie w…
- Strona:
- Język: pl
- Zaktualizowano: 2026-07-29
- Inne języki: [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), [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)
- Indeks:
Wtyczka **Karuzela Opinii Google** wyświetla opinie Google o Twojej firmie w formie responsywnej karuzeli w storefroncie Shopware 6. Automatycznie generuje znaczniki Schema.org (LocalBusiness + AggregateRating + Review), buforuje opinie w cache i oferuje dwa wbudowane motywy. Nie wymaga builda administracji: instaluje się na dowolnym hostingu, również współdzielonym.
## Wymagania
- Shopware 6.5.x, 6.6.x lub 6.7.x
- PHP 8.1 lub nowszy
- Klucz API Google Cloud z aktywowanym **API Places** (bezpłatny do dużego wolumenu zapytań)
- **Place ID** Twojej firmy w Google
## Instalacja
Wgraj archiwum ZIP przez _Rozszerzenia > Moje rozszerzenia > Prześlij rozszerzenie_ lub skopiuj katalog `DfGoogleReviews` do `custom/plugins/`. Następnie wykonaj:
```
bin/console plugin:refresh
bin/console plugin:install --activate DfGoogleReviews
bin/console cache:clear
```
Wtyczka pojawi się w _Rozszerzenia > Moje rozszerzenia_, gotowa do konfiguracji.
## Uzyskanie klucza API i Place ID
### Klucz API Google
1. Wejdź na `console.cloud.google.com` i utwórz (lub wybierz) projekt.
2. W sekcji _Interfejsy API i usługi_ aktywuj **API Places**.
3. W sekcji _Dane logowania_ utwórz klucz API i skopiuj go.
4. Zalecane: ogranicz klucz do API Places i do swojej domeny.
### Place ID
Użyj narzędzia _Place ID Finder_ od Google (dokumentacja Google Maps Platform), aby pobrać identyfikator swojej firmy. Ma on postać `ChIJ...`.
## Konfiguracja
Otwórz _Rozszerzenia > Moje rozszerzenia > Karuzela Opinii Google > Konfiguruj_. Wszystkie ustawienia są zarządzane **per kanał sprzedaży**: przed konfiguracją wybierz właściwy kanał sprzedaży u góry strony.
### Połączenie z Google
- **Włącz karuzelę**: główny przełącznik.
- **Klucz API Google**: Twój klucz z aktywowanym API Places.
- **Place ID**: identyfikator Twojej firmy.
- **Język opinii**: kod języka (np. `pl`, `de`, `en`) przekazywany do API dla tekstów i dat względnych. Pozostaw puste, aby użyć domyślnego ustawienia Google.
### Wyświetlanie
- **Pozycja**: _Strona główna_ (nad stopką), _Wszystkie strony_ lub _Ręcznie_ (zobacz następną sekcję).
- **Tytuł**: tytuł karuzeli (puste = domyślny przetłumaczony tytuł, dostępny w 5 językach).
- **Motyw**: Light lub Dark.
- **Automatyczne przewijanie** i **interwał** (w milisekundach): automatyczna pauza przy najechaniu kursorem i przy fokusie.
- **Maksymalna liczba opinii**: do 10 (API Google zwraca maksymalnie 5).
- **Minimalna ocena**: wyświetla tylko opinie powyżej progu (np. 4, aby zachować wyłącznie oceny 4 i 5 gwiazdek).
### Cache
- **Czas życia cache**: od 1 godziny do 7 dni (zalecane 24 godziny).
## Wyświetlanie karuzeli
### Tryb automatyczny
Przy pozycji _Strona główna_ lub _Wszystkie strony_ karuzela wstawia się automatycznie nad stopką. Nie są wymagane żadne modyfikacje motywu.
Tryb automatyczny korzysta z bloku `base_footer`. Jeśli niestandardowy motyw całkowicie nadpisuje ten blok bez wywołania `parent()`, użyj trybu ręcznego opisanego poniżej.
### Tryb ręczny (include Twig)
Wybierz pozycję _Ręcznie_, a następnie wstaw komponent w dowolnym miejscu motywu storefront:
```
{% sw_include '@DfGoogleReviews/storefront/component/df-google-reviews.html.twig' %}
```
To idealne rozwiązanie, aby umieścić opinie na konkretnej stronie CMS, w Shopping Experience lub w wybranym miejscu układu strony.
## Komendy konsoli
Dwie komendy ułatwiają utrzymanie:
```
# Test polaczenia z API i podglad opinii (cache pomijany)
bin/console df:google-reviews:test
# Wyczyszczenie cache opinii
bin/console df:google-reviews:clear-cache
```
Obie akceptują opcję `--sales-channel-id=...`, aby wskazać konfigurację konkretnego kanału sprzedaży. Komenda testowa wyświetla nazwę firmy, ogólną ocenę i listę zwróconych opinii, co pozwala zweryfikować klucz API i Place ID przed publikacją.
## SEO i Schema.org
Przy każdym wyświetleniu wtyczka wstrzykuje kompletne znaczniki JSON-LD: `LocalBusiness` (nazwa, ogólna ocena), `AggregateRating` (średnia i łączna liczba opinii) oraz blok `Review` dla każdej opinii. Znaczniki te mogą sprawić, że gwiazdki pojawią się w wynikach Google (rich snippets). Treść jest renderowana po stronie serwera, więc opinie pozostają czytelne dla robotów indeksujących i użytkowników bez JavaScriptu; karuzela stanowi jedynie progresywne ulepszenie.
## Wydajność
CSS (~2 KB) i JavaScript (~2 KB, Vanilla JS) są wstrzykiwane wyłącznie na stronach, na których wyświetla się karuzela. Żadnych bibliotek zewnętrznych, żadnego jQuery. Zapytania do API Google Places są buforowane w cache obiektowym Shopware zgodnie ze skonfigurowanym czasem życia.
**Płynna degradacja**: jeśli API Google jest chwilowo niedostępne, ostatnie prawidłowe opinie z cache są nadal wyświetlane. Widget nigdy nie psuje storefrontu.
## Rozwiązywanie problemów
- **Karuzela się nie wyświetla**: sprawdź, czy wtyczka jest aktywna, czy opcja "Włącz karuzelę" jest zaznaczona oraz czy klucz API i Place ID są uzupełnione. Uruchom `bin/console df:google-reviews:test` w celu diagnozy.
- **Błąd API**: upewnij się, że API Places jest aktywowane w Google Cloud, a klucz nie jest zbyt mocno ograniczony. Szczegóły znajdziesz w `var/log`.
- **Opinie się nie aktualizują**: wyczyść cache komendą `bin/console df:google-reviews:clear-cache` (API Google i tak zwraca tylko 5 najnowszych opinii).
- **Tryb automatyczny niewidoczny na niestandardowym motywie**: przełącz się na tryb ręczny i dodaj include Twig.
## Odinstalowanie
Dezaktywuj, a następnie odinstaluj wtyczkę z poziomu _Rozszerzenia > Moje rozszerzenia_ lub przez:
```
bin/console plugin:uninstall DfGoogleReviews
```
Jeśli przy odinstalowaniu wybierzesz usunięcie danych, cała konfiguracja (klucze `DfGoogleReviews.config.*`) zostanie automatycznie wyczyszczona.