PrestaShop Google Merchant Feed XML

Dokumentacja PrestaShop Google Merchant Feed

1. Wprowadzenie
2. Instalacja i wymagania systemowe
3. Aktywacja modułu
4. Podstawowa konfiguracja feedu
5. Konfiguracja zaawansowana
6. Struktura XML feedu
7. Filtry produktów
8. Integracja z Google Merchant Center
9. Automatyczne odświeżanie (CRON)
10. Bezpieczeństwo i tokeny
11. Logowanie i debugowanie
12. Rozmiary obrazów
13. Rozwiązywanie problemów
14. FAQ

1. Wprowadzenie

• Automatyczne generowanie feedu XML dla Google Merchant Center
• Obsługa wszystkich wymaganych i opcjonalnych pól Google Shopping
• Zaawansowana filtracja produktów (kategorie, producenci, ilość, promocje)
• Obsługa wielu języków i walut sklepu
• Dodatkowe obrazy produktów (do 10 na produkt)
• Automatyczne odświeżanie feedu przez CRON
• Bezpieczny dostęp za pomocą tokenów
• Buforowanie (cache) feedu dla optymalizacji wydajności
• Normalizacja danych – usuwanie HTML, podświetleń i spacji
• Walidacja URL i formatów danych
• Zgodność z PrestaShop 1.7.x, 8.x oraz 9.x
• Pełny system tłumaczeń (polski, angielski, niemiecki, hiszpański, francuski)

2. Instalacja i wymagania systemowe

• PrestaShop 1.7.0.0 lub nowszy (testowane do wersji 9.0)
• PHP 7.4 lub nowszy
• Dostęp do panelu administracyjnego PrestaShop
• Konto Google Merchant Center (darmowe)
• Możliwość zapisywania plików na serwerze
• Dostęp do CRON (opcjonalnie, do automatycznego odświeżania)

1. Pobierz plik ZIP modułu z oficjalnej strony cocos.codes
2. Zaloguj się do panelu administracyjnego PrestaShop
3. Przejdź do: Moduły → Menedżer modułów
4. Kliknij „Wgraj moduł” w prawym górnym rogu
5. Wybierz pobrany plik ZIP i kliknij „Wgraj ten moduł”
6. Po zakończeniu instalacji kliknij „Konfiguruj”
7. Moduł jest gotowy do konfiguracji

3. Aktywacja modułu

1. Przejdź do Moduły → Menedżer modułów
2. Znajdź moduł „CC Google Merchant Feed”
3. Kliknij „Konfiguruj”
4. Wybierz zakładkę „Konfiguracja”
5. Wypełnij podstawowe ustawienia feedu
6. Kliknij „Zapisz i Generuj Feed XML”

4. Podstawowa konfiguracja feedu

1. W konfiguracji modułu wybierz „Język feedu”
2. Wybierz z listy rozwijanej języka dla nazw i opisów produktów
3. Kliknij „Zapisz i Generuj Feed XML”

• Wszystkie produkty z wybranego języka są wczytywane ze sklepu
• Feed XML jest automatycznie generowany i zapisywany
• Plik jest dostępny pod adresem URL widocznym w zakładce „Instrukcje”
• Google Merchant Center może natychmiast pobrać nowy feed

5. Konfiguracja zaawansowana

1. Wpisz nazwę marki/firmy którą chcesz używać dla produktów bez producenta
2. Jeśli zostawisz pole puste, będzie używana nazwa sklepu z ustawień PrestaShop
3. Marka jest wymagana dla produktów bez GTIN

1. Wpisz prefix dla kodu MPN (np. „MPN-” lub „SKU-„)
2. Prefix zostanie dodany do numeru referencji produktu
3. Jeśli produkt ma numer referencji, prefix będzie zastosowany do niego
4. Jeśli brak referencji, prefix zostanie dodany do ID produktu

• Limit produktów – domyślnie 0 (bez limitu). Zmień na liczbę np. 1000 jeśli feed jest zbyt duży
• Maksymalna liczba dodatkowych obrazów – domyślnie 10. Zmniejsz aby zmniejszyć rozmiar feedu

6. Struktura XML feedu

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:g="http://base.google.com/ns/1.0">
  <channel>
    <title>Nazwa Sklepu</title>
    <link>http://example.com</link>
    <description>Feed produktów dla Google Merchant Center</description>
    <item>
      <g:id>123</g:id>
      <g:title>Nazwa produktu</g:title>
      <g:description>Opis produktu</g:description>
      <!-- pozostałe pola -->
    </item>
  </channel>
</rss>

<item>
  <g:id>123</g:id>
  <g:title>Niebieski T-shirt rozmiar L</g:title>
  <g:description>Wysokiej jakości bawełniany t-shirt w kolorze niebieskim, rozmiar L</g:description>
  <g:link>http://example.com/produkt/niebieski-t-shirt</g:link>
  <g:image_link>http://example.com/images/tshirt-blue-large.jpg</g:image_link>
  <g:additional_image_link>http://example.com/images/tshirt-blue-1.jpg</g:additional_image_link>
  <g:price>99.99 PLN</g:price>
  <g:sale_price>79.99 PLN</g:sale_price>
  <g:availability>in stock</g:availability>
  <g:condition>new</g:condition>
  <g:gtin>5901234123457</g:gtin>
  <g:brand>Fashion Brand</g:brand>
  <g:mpn>MPN-123</g:mpn>
</item>

7. Filtry produktów

1. W sekcji „Kategorie” zobaczysz listę wszystkich kategorii ze sklepu
2. Zaznacz checkboxy przy kategoriach które chcesz eksportować
3. Aby wybrać wiele kategorii przytrzymaj CTRL (Cmd na Mac) i klikaj na kategorie
4. Zostaw niezaznaczone jeśli chcesz eksportować wszystkie kategorie

1. W sekcji „Producenci” zobaczysz listę wszystkich producentów/marek
2. Zaznacz checkboxy przy producentach których produkty chcesz eksportować
3. Aby wybrać wielu producentów przytrzymaj CTRL (Cmd na Mac) i klikaj
4. Zostaw niezaznaczone jeśli chcesz eksportować wszystkich producentów

1. Wpisz minimalną ilość produktów na magazynie
2. Produkty z mniejszą ilością będą pomijane w feedzie
3. Wpisz 0 aby nie filtrować po ilości (domyślnie)
4. Przydatne aby eksportować tylko produkty dostępne

1. Zaznacz opcję „Tylko produkty z promocją” jeśli chcesz eksportować tylko promocje
2. Odznacz jeśli chcesz eksportować wszystkie produkty niezależnie od promocji
3. Moduł automatycznie dodaje pole sale_price dla produktów z rabatami

8. Integracja z Google Merchant Center

1. W panelu administracyjnego PrestaShop przejdź do Moduły → Menedżer modułów
2. Kliknij „Konfiguruj” przy module CC Google Merchant Feed
3. Przejdź do zakładki „Instrukcje”
4. W sekcji „Link do feedu XML” zobaczysz pełny URL do feedu
5. Kliknij przycisk „Kopiuj” aby skopiować URL do schowka

1. Zaloguj się do Google Merchant Center
2. Przejdź do sekcji „Produkty” → „Kanały”
3. Kliknij „Nowy kanał”
4. Wybierz „Shopping ads” lub odpowiedni typ kanału
5. Wpisz nazwę kanału (np. „Feed XML PrestaShop”)
6. W sekcji „Produkty” wybierz „URL feedu”
7. Wklej skopiowany URL do feedu
8. Kliknij „Dalej” i dokończ konfigurację kanału

1. Po dodaniu feedu Google automatycznie go pobierze i zwaliduje
2. Przejdź do „Produkty” → „Diagnostyka”
3. Sprawdź czy feed został pomyślnie zaindeksowany
4. Jeśli są błędy, moduł pokaże które produkty mają problemy

1. Google Merchant Center automatycznie pobiera feed czasami
2. Aby wymusić natychmiastową aktualizację, kliknij ikonę odświeżania obok kanału
3. Lub skonfiguruj automatyczne odświeżanie przez CRON (opisane poniżej)

9. Automatyczne odświeżanie (CRON)

• Narzędzie do automatycznego wykonywania zadań na serwerze
• Pozwala na zaplanowanie regularnych działań (co 6 godzin, co dzień, itp.)
• Idealny do odświeżania feedu Google Merchant Center
• Wymaga dostępu do panelu hosting/serwera

1. W konfiguracji modułu zaznacz opcję „Automatyczne odświeżanie”
2. Jeśli odznaczysz, feed będzie cachowany przez określoną liczbę godzin
3. Pozostaw zaznaczoną opcję aby regenerować feed przy każdym wywołaniu

0 */6 * * * curl -s "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 */6 * * * – uruchamia zadanie co 6 godzin o pełnej godzinie
• curl -s – pobiera URL w trybie cichym (bez komunikatów)
• http://example.com – zamień na adres twojego sklepu
• WYGENEROWANY_TOKEN – token bezpieczeństwa z konfiguracji modułu
• > /dev/null 2>&1 – ukrywa komunikaty i błędy

0 */6 * * * wget -q -O - "http://example.com/modules/cc_ps_google_merchant/feed.xml?token=WYGENEROWANY_TOKEN" > /dev/null 2>&1

• 0 * * * * – co godzinę
• 0 */6 * * * – co 6 godzin (rekomendowane)
• 0 0 * * * – codziennie o północy
• 0 */12 * * * – co 12 godzin

10. Bezpieczeństwo i tokeny

• Unikalny kod losowo generowany przy instalacji modułu
• Wymagany przy każdym wywołaniu feedu przez CRON
• Uniemożliwia komuś niepowołanemu odświeżanie feedu
• Zmienia się przy każdej regeneracji

1. W panelu administracyjnego PrestaShop przejdź do Moduły → Menedżer modułów
2. Kliknij „Konfiguruj” przy CC Google Merchant Feed
3. Przejdź do zakładki „Instrukcje”
4. W sekcji „Automatyczna regeneracja (CRON)” zobaczysz token
5. Token jest długim ciągiem znaków alfanumerycznych

http://example.com/modules/cc_ps_google_merchant/feed.xml
http://example.com/modules/cc_ps_google_merchant/feed.xml?token=abc123def456ghi789jkl

1. W zakładce „Instrukcje” kliknij przycisk „Wygeneruj nowy token bezpieczeństwa”
2. Pojawi się okno potwierdzenia – kliknij OK
3. Nowy token zostanie wygenerowany i wyświetlony
4. Stary token przestanie działać natychmiast
5. Jeśli używasz CRON, musisz zaktualizować komendę ze starym tokenem

11. Logowanie i debugowanie

1. Otwórz adres URL feedu w przeglądarce internetowej
2. Powinieneś zobaczyć surowy kod XML z produktami
3. Kliknij prawym przyciskiem myszy i wybierz „Pokaż źródło strony”
4. Sprawdź czy struktura XML jest prawidłowa
5. Sprawdź czy są wszystkie wymagane pola dla każdego produktu

1. Przejdź do XML Validator
2. Skopiuj zawartość feedu i wklej do walidatora
3. Walidator pokaże czy XML ma prawidłową składnię
4. Jeśli są błędy, zwróć uwagę na numer linii gdzie jest problem

1. Przejdź do Google Merchant Center
2. Otwórz kanał z feedem
3. Przejdź do „Diagnostyka”
4. Sprawdź „Błędy” i „Ostrzeżenia”
5. Google pokaże które produkty mają problemy i co jest nie tak

• Jeśli feed się nie generuje, sprawdź logi błędów PHP na serwerze
• Szukaj błędów dotyczących modułu cc_ps_google_merchant
• Sprawdź czy serwer ma uprawnienia do zapisu w katalogu modułu
• Sprawdź czy PHP ma zainstalowaną rozszerzenie SimpleXML

12. Rozmiary obrazów

1. W konfiguracji modułu przejdź do „Rozmiar obrazów”
2. Wybierz preferowany rozmiar z listy rozwijanej
3. Kliknij „Zapisz i Generuj Feed XML”

• Minimalny wymiar: 100 x 100 pikseli
• Zalecany wymiar: 800 x 800 pikseli lub większy
• Maksymalny rozmiar pliku: brak ograniczenia, ale Google pobiera tylko pierwsze 10MB
• Formaty: JPG, PNG, GIF, BMP, TIFF, ICO, CUR, SVG, WEBP

• Moduł może dodawać do 10 dodatkowych zdjęć do każdego produktu
• Zwiększa szanse że produkt pojawi się w wyszukiwarce Google Images
• Można wyłączyć opcję aby zmniejszyć rozmiar feedu
• Opcja „Maksymalna liczba dodatkowych obrazów” pozwala na kontrolę ilości

13. Rozwiązywanie problemów

1. Sprawdź czy moduł jest aktywny w Menedżerze modułów
2. Sprawdź czy serwer ma uprawnienia do zapisu w katalogu /modules/cc_ps_google_merchant/
3. Zaloguj się do panelu administracyjnego i spróbuj kliknąć „Zapisz i Generuj Feed XML”
4. Sprawdź logi błędów serwera (error.log PHP)
5. Upewnij się że PHP ma rozszerzenie SimpleXML zainstalowane
6. Spróbuj wyłączyć moduł i włączyć go ponownie

1. Sprawdź czy produkty są aktywne w PrestaShop
2. Sprawdź czy produkty mają przypisaną kategorię
3. Jeśli używasz filtrów, sprawdź czy produkty spełniają warunki filtru
4. Sprawdź minimalną ilość na stanie – produkty poza stanie mogą być pomijane
5. Otwórz feed XML w przeglądarce i wyszukaj produkty ręcznie (CTRL+F)

1. Przejdź do Google Merchant Center i otwórz kartę „Diagnostyka”
2. Przeczytaj dokładny komunikat błędu
3. Sprawdź które pola brakują – Google wymagają określonych pól
4. Moduł automatycznie pomija produkty z brakującymi wymaganymi danymi
5. Upewnij się że produkty mają: tytuł, opis, link, zdjęcie, cenę, dostępność, GTIN lub markę

1. Sprawdź czy cena w PrestaShop jest prawidłowo ustawiona
2. Sprawdź czy waluta sklepu jest poprawnie skonfigurowana
3. Jeśli są rabaty, moduł powinien wybrać cenę z rabatem
4. Sprawdź czy podatek VAT jest prawidłowo zastosowany (cena powinna być z VAT)

1. Sprawdź czy opcja „Dodatkowe obrazy” jest włączona w konfiguracji
2. Upewnij się że produkty mają dodatkowe zdjęcia przypisane w PrestaShop
3. Sprawdź czy maksymalna liczba dodatkowych obrazów nie jest ustawiona na 0
4. Otwórz feed XML i sprawdź czy są elementy g:additional_image_link

1. Sprawdź czy zadanie CRON jest prawidłowo dodane w panelu hostingu
2. Sprawdź czy URL w komendzie CRON jest prawidłowy
3. Sprawdź czy token w URL jest aktualny (czasami zmienia się przy aktualizacjach)
4. Spróbuj ręcznie wejść na URL z przeglądarki aby sprawdzić czy działa
5. Sprawdź logi CRON w panelu hostingu – mogą zawierać informacje o błędach

14. FAQ