DF Fitment Finder: wyszukiwanie po pojeździe i dopasowanie produktów

DF Fitment Finder dodaje do sklepu PrestaShop wyszukiwanie po dopasowaniu: klient wybiera swój pojazd (lub urządzenie), a katalog pokazuje mu wyłącznie produkty, które do niego pasują. Ta dokumentacja obejmuje instalację, konfigurację, zasilanie bazy pojazdów i prezentację na froncie sklepu.

Instalacja

1. Przejdź do Moduły > Menedżer modułów, a następnie kliknij Wgraj moduł.
2. Wskaż plik dffitmentfinder.zip i uruchom instalację.
3. Kliknij Konfiguruj, aby przejść do ustawień.

Instalacja tworzy trzy tabele (baza pojazdów, dopasowania produktów, garaże klientów), rejestruje potrzebne hooki i dodaje zakładkę Pojazdy w menu Katalog. Żaden plik rdzenia nie jest nadpisywany, żadna zależność Composer nie jest wymagana.

Konfiguracja

Poziomy wyszukiwania

Selektor opiera się na czterech poziomach: Marka, Model, Rok i Silnik. Dwa pierwsze są zawsze aktywne, dwa kolejne włączasz lub wyłączasz zależnie od swojego katalogu.

• Używaj roku: wyłącz przy katalogu, w którym rok nie ma znaczenia (tusze do drukarek, etui do telefonów, części AGD).
• Używaj silnika: wyłącz, jeżeli najniższym poziomem Twojej bazy jest model.

Wyszukiwanie działa już po podaniu marki i modelu: klient nigdy nie jest zmuszony schodzić do najniższego poziomu.

Etykiety poziomów

Każdy poziom ma etykietę edytowalną osobno dla każdego języka. Domyślnie: Marka, Model, Rok, Silnik. Dopasuj je do swojej branży:

• Części samochodowe: Marka / Model / Rok / Silnik
• Tusze do drukarek: Marka / Seria / bez roku / Symbol
• Etui do telefonów: Marka / Model
• AGD: Producent / Linia / Rok / Symbol

Miejsca wyświetlania

• Pokazuj w nagłówku: selektor pojawia się na górze wszystkich stron.
• Pokazuj na stronie głównej: selektor pojawia się w treści strony głównej.
• Widget: umieść selektor w dowolnym miejscu szablonu tagiem Smarty {widget name='dffitmentfinder'}.

Karta produktu

• Sprawdzanie dopasowania: pod ceną wyświetla belkę zieloną (produkt pasuje do bieżącego pojazdu), czerwoną (nie pasuje) lub neutralną (żaden pojazd nie został wybrany).
• Tabela dopasowań: na dole karty wyświetla pełną listę pasujących pojazdów, pogrupowaną według marki i zwijaną.

Liczba wyników na stronie

Liczba produktów wyświetlanych na jednej stronie wyników. Wartość domyślna: 12.

Zasilanie bazy pojazdów

Wprowadzanie ręczne

Przejdź do Katalog > Pojazdy. Przycisk Dodaj otwiera formularz pojazdu:

• Marka i Model: pola obowiązkowe.
• Rok od i Rok do: pola opcjonalne. Pozostawione puste oznaczają pojazd ważny dla wszystkich roczników. Wypełnione wyznaczają zakres: pojazd 2012–2019 pojawi się w selektorze przy każdym roczniku z tego zakresu.
• Silnik: pole opcjonalne, to najniższy poziom (na przykład „1.2 PureTech”).
• Aktywny: pojazd nieaktywny znika z selektora, ale zachowuje swoje dopasowania.

Przypisywanie produktów do pojazdu

Po zapisaniu pojazdu na dole jego formularza pojawia się panel Pasujące produkty. Wpisz co najmniej dwa znaki (nazwę lub referencję) w polu wyszukiwania, kliknij wynik, a produkt zostanie przypisany natychmiast. Opcjonalne pole Uwaga pozwala doprecyzować zakres dopasowania: „tylko oś przednia”, „skrzynia manualna”, „od numeru nadwozia 12000″. Ta uwaga wyświetla się w tabeli dopasowań na karcie produktu.

Import CSV

Przy obszernych bazach zalecaną drogą jest import CSV. Oczekiwany plik ma sześć kolumn:

make;model;year_from;year_to;variant;references

Przykład:

Peugeot;208;2012;2019;1.2 PureTech;BRK-P208-F|FLT-P208
Peugeot;208;2012;2019;1.6 BlueHDi;BRK-P208-F
HP;LaserJet Pro M404;;;;TNR-59A|TNR-59X

• Separator, średnik lub przecinek, jest wykrywany automatycznie.
• Kolumna references zawiera referencje pasujących produktów, rozdzielone pionową kreską.
• Kolumny roczników i silnika mogą pozostać puste.
• Pojazd już obecny w bazie nie zostanie zduplikowany: jego dopasowania są po prostu uzupełniane.
• Po zakończeniu importu raport podaje liczbę utworzonych pojazdów, dodanych dopasowań i wierszy z błędem.

Eksport CSV

Przycisk Eksportuj do CSV na stronie konfiguracji modułu pobiera całą bazę w tym samym formacie. Wygodne, gdy chcesz poprawić dane w arkuszu kalkulacyjnym i zaimportować je z powrotem.

Ścieżka klienta

Wybór pojazdu

Klient wybiera markę, potem model, a następnie (jeżeli poziomy są aktywne) rok i silnik. Każda lista wypełnia się na podstawie poprzedniej, bez przeładowania strony. Przycisk Szukaj otwiera stronę wyników, która wyświetla pasujące produkty z natywnymi miniaturami Twojego szablonu.

Wybrany pojazd jest zapamiętywany i przypominany na wszystkich stronach, dopóki klient go nie zmieni lub nie usunie.

Mój garaż

Przycisk Dodaj do mojego garażu zapisuje bieżący pojazd. Strona Mój garaż, dostępna z konta klienta, wypisuje zapisane pojazdy i pozwala:

• ustawić pojazd jako bieżący pojazd;
• przejść bezpośrednio do produktów pasujących do danego pojazdu;
• usunąć pojazd z garażu.

Garaż działa również dla niezalogowanych odwiedzających: ich pojazdy są zachowywane i automatycznie przypisywane do konta w chwili logowania lub rejestracji.

Na karcie produktu

Jeżeli sprawdzanie dopasowania jest włączone i wybrany jest bieżący pojazd, pod ceną pojawia się belka: zielona, gdy produkt pasuje, czerwona w przeciwnym razie. Gdy żaden pojazd nie jest wybrany, neutralny komunikat zachęca klienta do wskazania pojazdu.

Jeżeli tabela dopasowań jest włączona, karta wyświetla na dole pełną listę pasujących pojazdów, pogrupowaną według marki i zwijaną, wraz z ewentualną uwagą przypisaną do każdego dopasowania.

Najczęstsze pytania

Czy mogę używać modułu bez pojęcia pojazdu?

Tak. Wyłącz poziomy Rok i Silnik, zmień etykiety, a moduł stanie się selektorem Marka / Seria odpowiednim dla tuszy, etui, części AGD i każdego katalogu, w którym dopasowanie warunkuje zakup.

Co dzieje się z dopasowaniem, gdy usuwam produkt?

Jest usuwane automatycznie. Baza nie przechowuje osieroconych wierszy.

Czy selektor spowalnia mój sklep?

Nie. Listy są wypełniane przez AJAX na żądanie, w natywnym JavaScripcie i bez zależności od jQuery: przy pierwszym wyświetleniu ładowana jest wyłącznie lista marek.

Czy moduł działa w trybie wielosklepowym?

Tak. Dopasowania produktów i garaże klientów respektują kontekst sklepu.