Koszyk
Google Business Reviews Pro
Google Business Reviews Pro to moduł PrestaShop do prezentowania zapisanych opinii o firmie z Google Places (New) lub Google Business Profile. Pozwala wybrać źródło, miejsce widżetu, układ i ustawienia dla konkretnego sklepu. Places wymaga klucza API, Place ID i aktywnego rozliczania Google Cloud; zwraca do 5 opinii i może generować opłaty. Przed zakupem: synchronizacja Business Profile w oferowanej paczce 1.0.1 wymaga poprawki błędu dostępu do cache oraz uprawnień Google i konfiguracji OAuth. Zapisane opinie nie potwierdzają udanego ostatniego pobrania, a widżet nie gwarantuje pozycji SEO, cytowań AI ani gwiazdek w wyszukiwarce.
Funkcje, konfiguracja i ograniczenia
- Kod obsługuje Google Places (New) i Google Business Profile oraz tryby Places only, Business Profile only i Hybrid. Front odczytuje lokalnie zapisane dane, nie pobiera opinii podczas odwiedzin. Limit synchronizacji GBP wynosi 1–250; nie jest to nieograniczone archiwum. W paczce 1.0.1 synchronizacja GBP wymaga poprawki opisanej poniżej.
- Hybrid preferuje dostępne zapisane dane GBP. Jeśli ich brakuje według warunków modułu, może użyć zapisanych danych Places. Nie scala obu zestawów ani nie przełącza źródła po każdym błędzie API. Stary cache GBP może nadal mieć pierwszeństwo; brak obu źródeł danych oznacza brak widżetu.
- Przewidziano tryb Places only. Wymaga włączonego Places API (New), klucza API, właściwego Place ID i aktywnego rozliczania Google Cloud. Wywołania mogą być płatne. Places zwraca do 5 opinii, nie pełną historię firmy.
- GBP wymaga zatwierdzonego dostępu projektu do API, uprawnień do profilu i OAuth; sam Client ID i Client Secret nie wystarczają. Firma działająca wyłącznie online nie kwalifikuje się do Profilu Firmy. Ważne dla paczki 1.0.1: serwis synchronizacji wywołuje chronioną metodę getLocationCache(), co przerywa zapis opinii. Przed wdrożeniem GBP potrzebna jest poprawiona paczka i potwierdzenie działania na uprawnionym koncie.
- Kod CRON przewiduje odświeżanie GBP oraz Places, zależnie od konfiguracji. Dla GBP sprawdza interwał; dla Places pomija cache młodszy niż godzina. Harmonogram trzeba skonfigurować na serwerze. Jest też ręczna akcja Sync now. Błąd GBP w paczce 1.0.1 wymaga poprawki; sam harmonogram lub widoczny cache nie dowodzą udanej synchronizacji. Sync now dotyczy GBP; ręczne pobranie Places wykonuje przycisk testu. W paczce 1.0.1 błąd getLocationCache() może przerwać cały CRON przed etapem Places.
- Ustawienia źródeł i widżetu zapisuje się dla wybranego sklepu; konfiguracja i OAuth wymagają pojedynczego kontekstu sklepu. Opinie i cache są rozdzielone po id_shop. Nie wszystkie ustawienia są niezależne: token CRON jest wspólny. Działanie należy sprawdzić dla każdego sklepu.
- Do wyboru jest dziewięć hooków: displayHome, displayFooter, displayFooterBefore, displayFooterAfter, displayProductAdditionalInfo, displayShoppingCart, displayReassurance, displayLeftColumn i displayRightColumn. Widżet pojawi się tylko wtedy, gdy motyw wywołuje wybrany hook, ustawienia dopuszczają stronę i dostępne są zapisane dane.
- Display pages ogranicza widżet według typu kontrolera, np. index, product lub cart; all dopuszcza wszystkie typy stron. Nie jest to wybór konkretnych produktów, kategorii lub adresów. Nadal wymagane są wybrany hook motywu i zapisane dane.
- Dostępne są siatka lub slider, pięć stylów kart i kolor akcentu. Nagłówek, ocena liczbowa, liczba opinii i gwiazdki mają przełączniki dotyczące podsumowania, nie wszystkich ocen na kartach. Limit widżetu wynosi 1–10 kart i nie zwiększa limitu źródła. Zdjęcia, daty, tekst i linki zależą od dostępnych danych oraz stylu.
- Places API (New) zwraca maksymalnie 5 opinii wybranych przez Google według trafności. Nie gwarantuje pięciu najnowszych recenzji. Moduł zapisuje wybrany podzbiór i sortuje zapisane karty według daty, więc nie zachowuje kolejności trafności z API. Całkowita liczba ocen firmy nie jest liczbą pobranych kart.
- Błąd API nie wymusza przełączenia ani usunięcia zapisanych opinii. W Hybrid stare dane GBP mogą nadal mieć pierwszeństwo przed zapisanymi Places. Sprawdź wynik i datę synchronizacji oddzielnie od wyglądu widżetu. Nie ma gwarancji ciągłości przy braku danych lub błędach źródeł.