Integracja PrestaShop z Google Merchant Center (Wersja Bezpłatna)

PP-M023F
Integracje i API
  • 1.7.5 + | 8.x | 9.x
  • EN, FR, IT, DE, PL
  • 1.0.0
  • 2026-02-28

Integracja sklepu PrestaShop z Google Merchant Center poprzez generowanie zgodnego feedu XML. Lekka, bezpieczna i gotowa do użycia wersja podstawowa, zoptymalizowana pod kątem wydajności i stabilności środowisk produkcyjnych.

0,00 zł Netto

Usługi dodatkowe:

Instalacja +97,00 zł

469 Pobrań
  • Bezpłatny moduł udostępniony społeczności PrestaShop
  • Możliwość zgłaszania sugestii i błędów – poprawki według dostępności
  • Brak gwarancji i wsparcia w standardzie (bez SLA)
  • Pobranie dostępne po zalogowaniu na konto klienta. Limit pobrań: 99
  • Potrzebujesz modyfikacji lub wsparcia? zapytaj o usługę

Parametry Informacyjne:

  • 1.0.0
  • Wersja Sklepu Wersja PHP
    1.7.5 + 7.1 – 7.4
    8.x 8.1 – 8.3
    9.x 8.1 – 8.5
  • 2026-02-28
  • EN, FR, IT, DE, PL

Kluczowe parametry techniczne

  • Optymalizacja zapytań SQL: Moduł został zaprojektowany tak, aby eliminować problem "n+1 zapytań". Pobieranie danych odbywa się w sposób skonsolidowany, co znacząco odciąża bazę danych przy generowaniu pliku.
  • Mechanizm Cache (12h): Zastosowanie 12-godzinnego cyklu odświeżania pliku XML (z możliwością ręcznego wymuszenia) gwarantuje wysoką dostępność feedu przy minimalnym zużyciu procesora (CPU).
  • Bezpieczeństwo Endpointu: Moduł oferuje opcjonalną autoryzację za pomocą tokena bezpieczeństwa, co uniemożliwia nieautoryzowany dostęp do pełnego katalogu produktów i cen przez podmioty trzecie.
  • Zgodność z Multistore: Pełna izolacja danych dla każdego sklepu w środowisku Multistore – niezależne pliki cache, tokeny oraz parametry konfiguracyjne.

Zakres przekazywanych danych do Google

Moduł automatycznie mapuje i eksportuje kluczowe atrybuty wymagane przez Google Merchant Center:

Atrybut XML Źródło danych w PrestaShop
g:id / title ID produktu oraz nazwa zdefiniowana w panelu.
g:price Cena brutto przeliczona zgodnie z kontekstem sklepu.
g:availability Automatyczna mapowanie stanu magazynowego (in stock / out of stock).
g:gtin / g:brand Eksport kodu EAN-13 oraz nazwy producenta.

Implementacja i Back Office

Zarządzanie modułem odbywa się poprzez dedykowany panel administracyjny, który oferuje:

  • Monitoring pliku XML: Podgląd czasu generowania oraz wieku aktualnego pliku cache.
  • Zarządzanie dostępem: Funkcja generowania i rotacji tokena bezpieczeństwa per-sklep.
  • Weryfikacja reguł: Jasna informacja o kryteriach kwalifikacji produktów (aktywność, widoczność, cena > 0, stan > 0).

Specyfikacja wersji bezpłatnej (Core)

Informacje o licencji i ograniczeniach:

  • Limit wydajnościowy: Optymalizacja dla katalogów do 500 produktów.
  • Zakres eksportu: Produkt bazowy (brak obsługi kombinacji/wariantów w wersji Core).
  • Kontekst: Obsługa jednego języka i waluty dla danego punktu końcowego (URL).
  • Wymagania: Dostęp do zapisu w katalogu var/cache/prod/.

* Przed wdrożeniem modułu na środowisku produkcyjnym zaleca się wykonanie standardowej kopii bezpieczeństwa bazy danych.

Pliki do pobrania:


Instalacja modułu PrestaShop (625.83KB)

Uniwersalna dokumentacja opisująca proces instalacji modułów dla PrestaShop.

Integracja GMC (107.87KB)

Instrukcja obsługi

## [1.0.0] - 2026-02-28

### Added

- Initial release of the `ppproductfeed` module (MVP edition) for PrestaShop 1.7.6+.
- Public XML feed endpoint available at `module/ppproductfeed/feed`.
- Google Shopping feed generator built on `DOMDocument` with correct `g:` namespace handling.
- Layered architecture: `ProductRepository` (data retrieval), `GoogleShoppingMapper` (field mapping), `FeedGenerator` (XML rendering).
- Back office configuration panel with a ready-to-use feed URL field and one-click copy button.
- Integration with PrestaPremium components: `PPAdminTabInstaller` and `PPUpdater`.
- 12-hour file-based XML cache with atomic write (`rename()`) to prevent partial reads.
- Optional per-shop security token (`PPPRODUCTFEED_TOKEN`) validated via `hash_equals()`.

### Changed

- Hook `displayBackOfficeHeader` registered during module installation.
- Back office asset loading (`views/css/admin.css`) restricted to the module configuration page only.

### Feed Scope (MVP)

- Only products that are active and visible in the catalogue (`both`, `catalog`) are included.
- Products with `quantity <= 0` or `price <= 0` are excluded automatically.
- Maximum of `500` records per feed request (MVP performance limit).
- Mapped Google Shopping fields: `id`, `title`, `description`, `link`, `image_link`, `availability`, `price`, `condition`, `brand`, `gtin`, `mpn`.
- `g:condition` read from the product attribute (`new` / `used` / `refurbished`); values outside this set fall back to `new`.
- Product variants (combinations) are **not exported** — base product only (`id_product_attribute = 0`).
- Feed generated for one language and one currency per request (active shop context).

FAQs

  • Czy moduły są kompatybilne z moją wersją PrestaShop?

    Każdy moduł w naszym sklepie zawiera informację o kompatybilności z dana wersjami PrestaShop. Prosimy o dokładne sprawdzenie tych danych przed zakupem. Jeśli nie masz pewności, skontaktuj się z nami.

  • Jakie dane produktu trafiają do feedu Google Merchant Center?

    Feed XML przekazuje między innymi identyfikator i nazwę produktu, cenę brutto, dostępność, kod EAN-13 oraz nazwę producenta. Dane są mapowane z PrestaShop do wymaganych pól Google Merchant Center. Dzięki temu moduł tworzy podstawowy plik produktowy bez ręcznego przygotowywania każdego wpisu XML.

  • Jak często odświeżany jest plik XML?

    Moduł wykorzystuje 12-godzinny cykl odświeżania cache pliku XML, co zmniejsza zużycie procesora przy regularnym udostępnianiu feedu. W razie potrzeby administrator może wymusić odświeżenie ręcznie. Takie podejście łączy dostępność aktualnego pliku z ograniczeniem obciążenia serwera podczas jego generowania i kolejnych pobrań przez Google.

  • Czy dostęp do feedu XML można zabezpieczyć?

    Tak. Moduł oferuje opcjonalną autoryzację tokenem bezpieczeństwa dla endpointu feedu. Token ogranicza nieautoryzowany dostęp do pełnego katalogu produktów i cen przez osoby trzecie. W panelu można generować oraz rotować token osobno dla danego sklepu, co ułatwia kontrolę nad publicznym adresem feedu.

  • Jak moduł ogranicza obciążenie bazy podczas generowania feedu?

    Pobieranie danych zostało zaprojektowane jako skonsolidowane zapytania SQL, aby eliminować problem wielu dodatkowych zapytań dla kolejnych pozycji katalogu. Według opisu ogranicza to obciążenie bazy przy generowaniu pliku XML. Dodatkowo wykorzystanie cache zmniejsza potrzebę częstego ponownego tworzenia tego samego pliku przy regularnej publikacji.

  • Jakie warunki musi spełniać produkt, aby trafił do feedu?

    W panelu modułu widoczna jest informacja o podstawowych kryteriach kwalifikacji: produkt powinien być aktywny i widoczny, mieć cenę większą od zera oraz dodatni stan magazynowy. Ułatwia to sprawdzenie, dlaczego wybrana pozycja nie pojawia się w generowanym feedzie XML oraz które dane trzeba poprawić.

Potrzebujesz dodatkowych funkcji lub indywidualnych rozwiązań dla Twojego sklepu?

  • Modyfikacja modułu zgodnie z Twoimi wymaganiami.
  • Rozbudowa o nowe funkcje zwiększające możliwości Twojego sklepu.
  • Tworzenie dedykowanych modułów dostosowanych do specyficznych potrzeb.
  • Integracja zewnętrznych systemów i dodatkowych narzędzi.
  • Optymalizacja i ulepszenia dla lepszej wydajności i wygody użytkowania.

Masz pomysł, jak ulepszyć to oprogramowanie? Zgłoś swoje sugestie dotyczące optymalizacji, nowych funkcji lub znalezionych błędów – chętnie je przeanalizujemy!