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 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.

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).

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.