# Poradniki zakupowe PrestaShop 8 i 9: dokumentacja > Wprowadzenie Moduł tworzy strony poradników zakupowych na podstawie Twojego katalogu. Każdy poradnik odpowiada na pytanie klienta, na przykład „Jaki robot sprzątający wybrać do mieszkania ze zwierzętami?”. Wybierasz porównywane produkty i… - Strona: - Język: pl - Zaktualizowano: 2026-09-24 - Inne języki: [fr](https://www.datafirefly.com/documentation/buying-guide-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/buying-guide-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/buying-guide-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/buying-guide-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/buying-guide-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/buying-guide-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/buying-guide-prestashop/index.md) - Indeks: ## Wprowadzenie Moduł tworzy strony poradników zakupowych na podstawie Twojego katalogu. Każdy poradnik odpowiada na pytanie klienta, na przykład „Jaki robot sprzątający wybrać do mieszkania ze zwierzętami?”. Wybierasz porównywane produkty i kryteria, moduł oblicza dla każdego produktu wynik na 100 punktów, wskazuje trzy wybory i generuje ranking, tabelę porównawczą, statystyki i FAQ. Ranking jest przeliczany, gdy zmienia się katalog. ## Instalacja 1. W **Moduły > Menedżer modułów** kliknij **Załaduj moduł** i wybierz `dfbuyingguide-1.1.0.zip`. 2. Instalacja tworzy zakładkę **Katalog > Poradniki zakupowe**, tabele modułu i folder `img/dfbuyingguide/` na obrazy okładek. 3. Przycisk **Konfiguruj** modułu otwiera bezpośrednio tę zakładkę. Od wersji 1.0.0 wystarczy wgrać plik ZIP 1.1.0: skrypt aktualizacji dodaje kolumny i tabele statystyk, nie zmieniając Twoich poradników. ## Ustawienia ogólne Panel **Ustawienia** pod listą poradników zawiera: - **Prefiks URL**: domyślnie `guides`. Poradniki są dostępne pod `/guides/url-poradnika`, a strona zbiorcza pod `/guides`. - **Maksymalny wiek rankingu**: domyślnie 12 godzin. Po tym czasie ranking jest przeliczany przy następnej wizycie, nawet bez zmian w katalogu, co uwzględnia zaplanowane promocje. - **Produkty analizowane na poradnik**: domyślnie 300. Najpierw analizowane są najlepiej sprzedające się produkty z zakresu. Zwiększ dla dużych kategorii, maksymalnie do 5000. - **Pokaż odznakę poradnika na stronach produktów**: produkty z wyróżnieniem lub miejscem w pierwszej trójce pokazują link do poradnika. - **Pokaż poradniki na stronach kategorii**: blok na dole kategorii wymienia poradniki, których zakres obejmuje daną kategorię. - **Mierz ruch i sprzedaż**: włącza statystyki i ciasteczko przypisania `dfbg_attr` (patrz niżej). ## Tworzenie poradnika Kliknij **Dodaj poradnik zakupowy**. Główne pola: - **Tytuł**: sformułuj go jako pytanie klienta. Poradnik jest publikowany tylko w językach, w których ma tytuł. - **Przyjazny URL**: generowany z tytułu, jeśli pozostanie pusty. - **Obraz okładki**: wyświetlany na górze poradnika, na stronie poradników i przy udostępnianiu. Format poziomy, co najmniej 1200 px szerokości. Jest zmniejszany do maksymalnie 1600 px szerokości. - **Autor** i **Funkcja autora**: wyświetlane pod tytułem i dodawane do danych strukturalnych. - **Wstęp**: dla kogo jest poradnik i co liczy się przy tym zastosowaniu. - **Porównane produkty**: kategorie zakresu. Brak zaznaczonej kategorii oznacza cały katalog. Opcja **Uwzględnij podkategorie** jest domyślnie włączona. - **Cena minimalna** i **Cena maksymalna**: 0 oznacza brak limitu. Liczy się cena widoczna dla odwiedzających, w walucie domyślnej. Przydatne w poradnikach typu „najlepsze modele do 300 zł”. - **Tylko produkty dostępne w magazynie**: pomija produkty niedostępne, gdy zarządzanie magazynem jest włączone. - **Produkty w rankingu**: od 1 do 20, domyślnie 5. Wyróżnienia są zawsze wyświetlane, nawet poza tym rankingiem. - **Próg wyróżnienia dla małego budżetu**: domyślnie 50% (patrz „Trzy wybory”). - **Pozwól odwiedzającym dostosować ranking**, **Pokaż tabelę porównawczą**, **Pokaż FAQ**. - **Dodatkowe pytania**: jedno pytanie na linię w formacie `Pytanie | Odpowiedź`. Są dodawane po pytaniach generowanych. - **Podsumowanie**, **Meta tytuł** i **Meta opis**: tytuł i początek wstępu służą jako wartości domyślne. - **Opublikowany**: nieopublikowany poradnik można podejrzeć z panelu. Kliknij **Zapisz i zostań**: pod formularzem pojawią się panele kryteriów, aktualnego rankingu, ruchu i historii. ## Kryteria Bez kryteriów produkty są układane według sprzedaży. Kliknij **Dodaj kryterium** i wybierz typ. ### Typy kryteriów - **Cecha: preferowane wartości**: przyznajesz od 0 do 100 punktów każdej wartości cechy, na przykład Materiał: stal nierdzewna 100, aluminium 70, plastik 30. Po pierwszym zapisie formularz pokazuje wszystkie wartości cechy z suwakiem i przyciskami do wypełnienia wszystkich wartości naraz. Produkt z kilkoma wartościami zachowuje najlepszą. - **Cecha: wartość liczbowa**: moduł odczytuje liczbę z wartości („90 min”, „1200 W”, „2,5 kg”) i porównuje produkty. W polu **Preferowane wartości** wybierz, czy lepsza jest wyższa czy niższa. **Wartość minimalna** i **Wartość maksymalna** wykluczają produkty spoza zakresu lub bez wartości. **Jednostka** jest dodawana do liczb w statystykach. - **Cena (im niżej, tym lepiej)**. - **Sprzedaż (popularność)**: na podstawie sprzedanych ilości. - **Nowe produkty**: na podstawie daty dodania produktu. ### Waga, wymaganie i teksty - **Waga**: od 0 do 10. Waga 0 pokazuje kryterium w tabeli porównawczej, ale nie uwzględnia go w wyniku. - **Wymagane** (kryteria cech): produkty bez tej cechy lub z wartością ocenioną na 0 punktów są wykluczane z poradnika. - **Etykieta wyświetlana odwiedzającym**: jeśli pozostanie pusta, używana jest nazwa cechy. - **Porada zakupowa**: wyjaśnia, dlaczego kryterium jest ważne. Pojawia się w sekcji „Jak wybrać” nad statystykami katalogu. Strzałki na liście kryteriów zmieniają ich kolejność w tabeli porównawczej i w sekcji „Jak wybrać”. ## Obliczanie wyniku Dla każdego kryterium wartości produktów są sprowadzane do skali od 0 do 100: w kryteriach liczbowych, cenie, sprzedaży i nowości najlepszy produkt z zakresu otrzymuje 100, a najsłabszy 0, a w kryteriach wartości obowiązują przyznane przez Ciebie punkty. Wynik ogólny to średnia wyników ważona wagami kryteriów. Ceny są porównywane w walucie domyślnej. Panel **Aktualny ranking** pokazuje 20 pierwszych produktów z wynikiem ogólnym, ceną, wyróżnieniem i kolumną wyniku dla każdego kryterium. Użyj go, aby dopracować wagi przed publikacją. ## Trzy wybory - **Najlepszy ogólnie**: produkt na pierwszym miejscu. - **Najlepszy stosunek jakości do ceny**: spośród produktów tańszych od najlepszego ogólnie, których wynik wynosi co najmniej 60% jego wyniku, ten z najlepszym stosunkiem wyniku do ceny. - **Najlepszy przy małym budżecie**: najtańszy produkt, który osiąga ustawiony w **Próg wyróżnienia dla małego budżetu** procent wyniku najlepszego ogólnie, jeśli jest tańszy od dwóch pozostałych wyborów. Wybór pojawia się tylko wtedy, gdy któryś produkt spełnia warunek. Mocne strony produktu to kryteria z wynikiem 70 lub więcej (maksymalnie 3), punkty do rozważenia to te z wynikiem 30 lub mniej (maksymalnie 2). ## Aktualizacja rankingów Zmiana produktu, ceny specjalnej, wartości cechy lub kategorii oznacza rankingi do przeliczenia. Zmiana stanu magazynowego oznacza tylko poradniki z opcją „Tylko produkty dostępne w magazynie”. Przeliczenie następuje: - przy następnej wizycie w poradniku; - przez zadanie cron, jeśli je zaplanujesz; - przyciskiem **Przelicz teraz** w poradniku lub **Przelicz teraz wszystkie rankingi** na liście. ### Zadanie cron URL cron jest wyświetlany nad listą poradników. Wywołuj go co godzinę, aby odwiedzający nigdy nie czekali na przeliczenie. Dodaj `&force=1`, aby przeliczyć wszystkie poradniki. Przycisk **Nowy token** zastępuje token, a stary URL przestaje działać. Przykład: ``` 0 * * * * curl -s "https://twoj-sklep.pl/index.php?fc=module&module=dfbuyingguide&controller=cron&token=TWOJ_TOKEN" > /dev/null ``` ### Wyświetlana data i historia Data „Ranking zaktualizowano” widoczna dla odwiedzających zmienia się tylko wtedy, gdy zmieniają się czołowe miejsca lub wybory. Panel **Historia rekomendacji** wymienia te zmiany z 5 pierwszymi produktami dla każdej daty. Hooki modułu nie są wykonywane dla pracownika, którego profil nie ma uprawnienia „Wyświetl” do modułu. Jeśli Twój zespół edytuje katalog z takiego profilu, zadanie cron i maksymalny wiek rankingów działają jako zabezpieczenie. ## Strona poradnika Kolejno: tytuł, autor, liczba porównanych produktów i data aktualizacji, obraz okładki, wstęp, spis treści, wybory, ranking, tabela porównawcza, sekcja „Jak wybrać”, podsumowanie, FAQ, notka o metodzie i powiązane poradniki (opublikowane poradniki ze wspólną kategorią). ### Dostosowanie rankingu Gdy opcja jest włączona, a poradnik ma co najmniej 2 kryteria z wagą, panel nad rankingiem oferuje suwak ważności dla każdego kryterium i suwak maksymalnego budżetu. Ranking jest przeliczany w przeglądarce spośród 20 najlepszych produktów, bez przeładowania, a link przywraca ranking poradnika. Bez JavaScriptu panel pozostaje ukryty. Wyszukiwarki zawsze widzą ranking poradnika. ### Dodaj do koszyka Produkty, które można dodać do koszyka bezpośrednio, bez wyboru kombinacji, mają przycisk **Dodaj do koszyka** korzystający z mechanizmu koszyka motywu. Pozostałe mają przycisk **Zobacz produkt**. W trybie katalogu przycisk koszyka nie jest wyświetlany. ### Podgląd nieopublikowanego poradnika Przycisk **Podgląd poradnika** otwiera stronę z paskiem podglądu. Link zawiera token przypisany do poradnika, strona ma ustawione `noindex`, a statystyki nie są liczone. ### Zmiana kolorów Kolory są zdefiniowane zmiennymi CSS, które motyw może nadpisać: `--dfbg-accent`, `--dfbg-accent-soft`, `--dfbg-muted`, `--dfbg-line`, `--dfbg-surface`, `--dfbg-low` i `--dfbg-radius`. Czcionki pochodzą z motywu. ## Miejsca wyświetlania i SEO - **Strona zbiorcza poradników**: `/guides`, z obrazem okładki lub produktem z pierwszego miejsca każdego poradnika. - **Strony kategorii**: hook `displayFooterCategory`. - **Strony produktów**: hook `displayProductAdditionalInfo`, odznaka wyboru lub „Miejsce X” z linkiem do poradnika. - **Dowolne miejsce**: `{hook h='displayDfBuyingGuides' id_category=12}` w szablonie motywu. Bez `id_category` wyświetlane są wszystkie poradniki. - **Mapa strony**: jeśli zainstalowany jest natywny moduł gsitemap, strona zbiorcza i poradniki są dodawane z datą ostatniej zmiany rekomendacji. - **Dane strukturalne**: Article (z autorem i obrazem), ItemList rankingu i FAQPage. Znaczniki Open Graph są dodawane w sekcji head. - **Wielojęzyczność**: canonical, hreflang do każdego języka, w którym poradnik ma tytuł, oraz przekierowanie 301, gdy URL zostanie otwarty w innym języku. ## Ruch i sprzedaż Lista poradników pokazuje wyświetlenia i przychód z ostatnich 30 dni oraz cztery wskaźniki ogólne na górze. Każdy poradnik ma panel **Ruch i sprzedaż** za 30 dni i od początku: - **Wyświetlenia**: jedno na odwiedzającego, poradnik i dzień, bez robotów. - **Kliknięcia produktów** i współczynnik kliknięć w stosunku do wyświetleń. - **Kliknięcia Dodaj do koszyka** z rankingu. - **Odwiedzający, którzy dostosowali ranking**. - **Zamówienia** i współczynnik konwersji w stosunku do wyświetleń. - **Przychód netto**: kwota netto produktów pochodzących z poradnika, przeliczona na walutę domyślną. ### Przypisanie sprzedaży Gdy odwiedzający kliknie produkt w poradniku, własne ciasteczko `dfbg_attr` zapamiętuje produkt i poradnik na 30 dni. Gdy produkt trafia do koszyka, przypisanie jest kopiowane do koszyka. Przy zatwierdzeniu zamówienia, także przez webhook płatności, zamówienie i kwota netto tego produktu są przypisywane do poradnika. Liczone są tylko zatwierdzone zamówienia (status opłacone lub równoważny). Ciasteczko `dfbg_attr` jest ustawiane po kliknięciu bez udziału Twojego menedżera zgód. Uwzględnij je w polityce cookies albo wyłącz opcję **Mierz ruch i sprzedaż**. ## Duplikowanie poradnika Akcja **Duplikuj** na liście kopiuje poradnik z kryteriami, punktami wartości, sklepami i obrazem. Kopia jest tworzona jako nieopublikowana, z URL z sufiksem, i otwiera się od razu do edycji. ## Multisklep Każdy poradnik jest przypisany do sklepów wybranych w jego formularzu. Rankingi, historia i statystyki są liczone osobno dla każdego sklepu. ## Rozwiązywanie problemów - **„Obecnie żaden produkt nie pasuje do tego poradnika”**: sprawdź kategorie, przedział cenowy, opcję dostępności oraz kryteria wymagane lub z progami. - **Brakuje oczekiwanego produktu**: musi być aktywny, widoczny w katalogu i znajdować się wśród analizowanych produktów. Zwiększ „Produkty analizowane na poradnik” dla dużych kategorii. - **Poradnik zwraca błąd 404**: nie jest opublikowany, nie ma tytułu w tym języku lub nie jest przypisany do tego sklepu. - **Ranking nie uwzględnia zmiany**: kliknij „Przelicz teraz” i zaplanuj zadanie cron. - **Obraz okładki jest odrzucany**: sprawdź, czy folder `img/dfbuyingguide/` ma prawa zapisu.