DF Fitment Finder: wyszukiwanie po pojeździe i dopasowanie produktów
Instalacja, konfiguracja, import bazy pojazdów i publikacja stron SEO dla każdej marki i każdego modelu w sklepie PrestaShop.
DF Fitment Finder dodaje do sklepu PrestaShop wyszukiwanie po kompatybilności: klient wybiera swój pojazd (lub urządzenie), a katalog pokazuje mu wyłącznie produkty, które do niego pasują. Wersja 2.0.0 zamienia ponadto każdą markę i każdy model z Twojej bazy w indeksowalną stronę SEO. Ta dokumentacja obejmuje instalację, konfigurację, bazę pojazdów, strony SEO i ścieżkę klienta.
Nowości w wersji 2.0.0
- Strony SEO dla każdej marki i każdego modelu (opcja): przetłumaczone adresy URL, takie jak
/pl/kompatybilnosc/peugeot/208, meta tytuł, meta opis, H1 i wstęp w każdym języku, canonical, hreflang, sitemap, przekierowania 301. - Przebudowany panel administracyjny: pulpit z listą pierwszych kroków, zarządzanie markami i modelami, import CSV z podglądem i raportem błędów.
- Karta produktu: plakietka „pasuje / nie pasuje” z kompaktowym selektorem do sprawdzenia innego pojazdu, filtrowalna tabela kompatybilności z linkami do stron SEO.
- PrestaShop od 1.7.8 do 9, 8 języków, poprawki bezpieczeństwa i niezawodności.
Instalacja i aktualizacja
- Przejdź do Moduły > Menedżer modułów i kliknij Załaduj moduł.
- Upuść plik
dffitmentfinder-2.0.0.zip. W sklepie z wersją 1.x PrestaShop automatycznie przeprowadzi aktualizację. - Kliknij Konfiguruj, aby otworzyć pulpit.
Aktualizacja zachowuje wszystkie dane: pojazdy, powiązania produktów, garaże klientów i ustawienia. Dodaje tabele stron SEO, szybszy indeks powiązań produktów i nowe ustawienia, a także usuwa fantomowy pojazd „make / model”, który wersja 1.x mogła utworzyć, gdy plik CSV zaczynał się od znaku BOM.
Zgodność z PrestaShop od 1.7.8 do 9.x, PHP od 7.1 do 8.5, motywami Classic i Hummingbird oraz ich motywami potomnymi, w sklepie pojedynczym i w trybie multistore. Bez nadpisywania rdzenia, bez zależności.
Pulpit
Strona konfiguracji otwiera się na pulpicie: liczba marek, modeli, pojazdów, produktów z dopasowaniem, powiązań kompatybilności i pojazdów zapisanych w garażach. Lista Pierwsze kroki prowadzi przez cztery etapy (dodanie pojazdów, przypisanie produktów, wyświetlenie selektora, publikacja stron SEO), a blok Do sprawdzenia ostrzega o pojazdach bez żadnego produktu lub o wyłączonych przyjaznych adresach URL.

Ustawienia wyświetlania
Zakładka Ustawienia wyświetlania steruje selektorem i kartą produktu:
- Etykiety czterech poziomów, dla każdego języka: Marka / Model / Rok / Wersja dla części samochodowych, Producent / Seria / Symbol dla kartridży.
- Poziomy roku i wersji: wyłącz je w katalogach bez roczników modeli lub silników. Klient zawsze może wyszukiwać na podstawie samej marki i modelu.
- Ikona: samochód, motocykl, ciężarówka, garaż, drukarka, telefon, klucz, chip, własny obraz PNG, JPG lub SVG (skrypty i zawartość zewnętrzna są odrzucane) albo brak ikony.
- Układ na komputerze: poziomy lub pionowy. Na urządzeniach mobilnych pola selektora są zawsze ułożone pionowo.
- Wyświetlaj selektor w: siedem haków motywu, Twoje własne haki wyświetlania oraz widżet
{widget name='dffitmentfinder'}w dowolnym miejscu szablonów. - Filtruj strony kategorii według wybranego pojazdu: strony kategorii, producentów i dostawców pokazują tylko pasujące produkty, dopóki pojazd jest wybrany.
- Tabela kompatybilności i plakietka „Czy pasuje do mojego pojazdu?” na stronach produktów.
- Ukryj produkty niedostępne w magazynie na listach dopasowania (produkty, które można zamówić przy braku na stanie, pozostają widoczne) oraz Produktów na stronę (0 = tak samo jak na stronach kategorii).

Baza pojazdów
Wprowadzanie ręczne
Przejdź do Katalog > Kompatybilność pojazdów i kliknij Dodaj pojazd. Marka i model są wymagane; lata (od 1900 do 2100) i wersja są opcjonalne, a zduplikowany pojazd zostaje odrzucony. Kliknij Zapisz i zostań: pojawi się panel Pasujące produkty. Wpisz co najmniej dwa znaki nazwy lub indeksu produktu, wybierz go myszą lub strzałkami i dodaj opcjonalną notatkę, na przykład „tylko przednia oś”. Lista umożliwia zbiorcze włączanie, wyłączanie i usuwanie.

Import CSV z podglądem
Zakładka Import / eksport analizuje plik, zanim cokolwiek zostanie zapisane: liczba wierszy, nowe i istniejące pojazdy, znalezione powiązania produktów i wiersze z ostrzeżeniami, a także podgląd pierwszych wierszy ze statusem każdego z nich (nieznany indeks, nieprawidłowy rok, brak marki lub modelu).
make;model;year_from;year_to;variant;references;note;active
Peugeot;208;2019;2023;1.2 PureTech 100;BRK-208-F|OIL-PT12;Front axle;1
Peugeot;208;2012;2019;;BRK-208-F;;1
- Separator „;” „,” lub tabulator oraz kodowanie UTF-8 lub Windows-1252 (Excel) są wykrywane automatycznie; z wierszem nagłówka kolumny mogą być w dowolnej kolejności.
- references: indeksy produktów lub kombinacji oddzielone znakiem „|”.
- Lata, variant, references, note i active są opcjonalne. Istniejące pojazdy są ponownie wykorzystywane: dwukrotny import tego samego pliku nie tworzy duplikatów.
- Opcja Zastąp powiązania produktów dla pojazdów z pliku: powiązania tych pojazdów, których nie ma w pliku, zostaną usunięte.

Po imporcie raport pokazuje utworzone i zaktualizowane pojazdy, utworzone i usunięte powiązania oraz wiersze do sprawdzenia. Pełną listę błędów można pobrać jako plik CSV.

Eksport CSV
Eksport pobiera całą bazę w tym samym formacie, łącznie z notatkami i statusem aktywności, dzięki czemu możesz ją edytować w arkuszu kalkulacyjnym i zaimportować ponownie. Indeksy nigdy nie są obcinane, a komórki zaczynające się od = + – @ są zabezpieczone przed formułami arkusza (zabezpieczenie jest usuwane przy imporcie).
Marki i modele
Zakładka Marki i modele grupuje pojazdy według marki, a następnie według modelu, z latami, liczbą pojazdów i produktów, adresem URL strony i jej statusem (indeksowalna, noindex, brak aktywnego pojazdu, nieopublikowana). Z menu każdego wiersza możesz zobaczyć stronę, otworzyć pojazdy, opublikować stronę lub cofnąć jej publikację, wymusić noindex albo zmienić nazwę marki lub modelu we wszystkich pojazdach jednocześnie: stare adresy URL nadal przekierowują (301).


Strony SEO dla marek i modeli
Strony SEO są opcją, domyślnie wyłączoną. Po włączeniu w zakładce Strony SEO moduł publikuje stronę z listą marek, jedną stronę na markę i jedną stronę na parę marka + model, tworzone automatycznie na podstawie bazy pojazdów.
Adresy
Każdy język ma własny prefiks URL (domyślnie compatibilite, compatibility, compatibilidad, kompatibilitaet, compatibilita, kompatybilnosc, compatibiliteit, compatibilidade), po którym następują przyjazne URL marki i modelu: /pl/kompatybilnosc/peugeot/208, /fr/compatibilite/peugeot/208. Zmieniony prefiks lub przyjazny URL nadal odpowiada przekierowaniem 301 na nowy adres. Aby uzyskać czyste adresy, przyjazne adresy URL muszą być włączone w Preferencje > Ruch i SEO.

Teksty domyślne ze zmiennymi
Meta tytuł, meta opis, H1 i wstęp każdej strony pochodzą z tekstów domyślnych, osobnych dla każdego języka i poziomu (strony modeli, strony marek, strona z listą marek). Przyjmują zmienne {brand}, {model}, {count} (liczba pasujących produktów), {years} i {shop}. Podgląd w Google i liczniki znaków aktualizują się podczas pisania.

Edycja strony
Kliknij SEO i teksty przy marce lub modelu, aby nadpisać, dla każdego języka, przyjazny URL, meta tytuł, meta opis, H1 i wstęp (dozwolony prosty HTML). Puste pola nadal korzystają z tekstów domyślnych, pokazanych na szaro. Można też cofnąć publikację strony (zwraca wtedy 404) lub wymusić dla niej noindex.

Napisz unikalny wstęp dla najważniejszych marek i modeli: unikalna treść lepiej służy tym stronom niż same szablony.
Co pokazują strony
Strona z listą marek wymienia marki wraz z liczbą pasujących produktów. Strona marki pokazuje jej modele, a następnie wszystkie pasujące produkty. Strona modelu oferuje filtry według roku lub wersji oraz listę produktów, z sortowaniem, paginacją i miniaturami produktów Twojego motywu (Classic, Hummingbird i ich motywy potomne). Przycisk „To mój pojazd” wybiera pojazd dla odwiedzającego.




Zasady indeksowania
- Canonical na każdej stronie (z numerem strony), hreflang do wszystkich języków oraz x-default, ścieżka nawigacji.
- noindex: automatyczny dla stron bez produktów (opcja), wymuszony dla danej strony, opcja globalna, a także dla wariantów sortowanych lub filtrowanych (filtr roku lub wersji).
- Dane strukturalne BreadcrumbList i ItemList, dostarczane przez motyw lub przez moduł w przypadku motywów, które ich nie mają.
- Sitemap: strony indeksowalne są dodawane do modułu Google sitemap (gsitemap) przy każdym generowaniu; bez niego moduł oferuje własną sitemap XML z alternatywnymi wersjami hreflang, do zgłoszenia w Search Console.
- Linki wewnętrzne: lista marek → marki → modele, tabela kompatybilności na stronach produktów, link „Zobacz stronę” przy zapamiętanym pojeździe, link z wyników wyszukiwania.
- Wydajność: liczby produktów są przechowywane w pamięci podręcznej i przeliczane po każdej zmianie danych o dopasowaniu lub po upływie konfigurowalnego czasu.
Strona wyników wyszukiwania selektora zachowuje swoje parametry URL (make, model, year, id_vehicle): istniejące linki z menu i stron CMS nadal działają. Ma ustawiony noindex, ponieważ stronami indeksowalnymi są strony SEO.
Ścieżka klienta
Wybór pojazdu
Klient wybiera markę, potem model, a następnie opcjonalnie rok i wersję. Każda lista wypełnia się na podstawie poprzedniej, bez przeładowania strony, co jest ogłaszane czytnikom ekranu. Pokaż części otwiera pasujące produkty, Zapisz w moim garażu zapamiętuje pojazd. Wybrany pojazd pozostaje zapamiętany, wstępnie wypełniony w selektorze i wyświetlany z linkiem do swojej strony, dopóki klient go nie zmieni lub nie wyczyści.
Na karcie produktu
Plakietka odpowiada od razu: pasuje na zielono, nie pasuje na czerwono z linkiem do pasujących części albo zachęta do wybrania pojazdu. Sprawdź inny pojazd otwiera kompaktowy selektor bezpośrednio w plakietce.


Poniżej tabela kompatybilności wymienia wszystkie pasujące pojazdy pogrupowane według marki, z polem filtrowania przy długich listach, wyróżnionym pojazdem klienta i linkami do stron marek i modeli.

Mój garaż
Strona Mój garaż, dostępna również z konta klienta (Classic i Hummingbird), wymienia zapisane pojazdy: pasujące produkty, ustawienie jako bieżący, usunięcie. Garaże gości są przypisywane do konta klienta przy logowaniu i przy zakładaniu konta.

Najczęstsze pytania
Czy mogę tworzyć indeksowalne strony dla marek i modeli?
Tak, od wersji 2.0.0, dzięki opcji stron SEO: jedna strona na markę i na parę marka + model, z przetłumaczonym adresem URL, meta tagami, H1 i wstępem w każdym języku, canonical, hreflang, danymi strukturalnymi i sitemap. Pozycje w wynikach zależą od wielu czynników: moduł zapewnia czyste, indeksowalne strony, ale nie może zagwarantować pozycji.
Czy moje istniejące linki do strony wyników nadal działają?
Tak. Strona wyszukiwania zachowuje parametry make, model, year i id_vehicle, a także dawny parametr paginacji p.
Czy mogę używać modułu bez pojazdów?
Tak. Wyłącz poziomy roku i wersji, zmień etykiety, a moduł stanie się selektorem Producent / Seria dla kartridży, etui na telefony, części AGD lub każdego katalogu, w którym kompatybilność decyduje o zakupie.
Co dzieje się z dopasowaniem, gdy usuwam produkt?
Jest usuwane automatycznie, a liczby produktów na stronach SEO są odświeżane.
Czy moduł działa w trybie multistore?
Tak. Produkty są filtrowane dla każdego sklepu, a teksty SEO, przyjazne URL i liczniki są zapisywane osobno dla każdego sklepu i języka.