# DF Fitment Finder: wyszukiwanie po pojeździe i dopasowanie produktów
> 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…
- Strona:
- Język: pl
- Zaktualizowano: 2026-11-04
- Inne języki: [fr](https://www.datafirefly.com/documentation/dffitmentfinder/index.md), [en](https://www.datafirefly.com/en/documentation/dffitmentfinder/index.md), [es](https://www.datafirefly.com/es/documentation/dffitmentfinder/index.md), [de](https://www.datafirefly.com/de/documentation/dffitmentfinder/index.md), [it](https://www.datafirefly.com/it/documentation/dffitmentfinder/index.md), [pt](https://www.datafirefly.com/pt/documentation/dffitmentfinder/index.md), [nl](https://www.datafirefly.com/nl/documentation/dffitmentfinder/index.md)
- Indeks:
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
1. Przejdź do **Moduły > Menedżer modułów** i kliknij **Załaduj moduł**.
2. Upuść plik `dffitmentfinder-2.0.0.zip`. W sklepie z wersją 1.x PrestaShop automatycznie przeprowadzi aktualizację.
3. 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.
Panel: kluczowe liczby, pierwsze kroki i stan stron SEO dla marek i modeli
## 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).
Ustawienia wyświetlania: etykiety, poziomy roku i wersji, ikona, położenie wyszukiwarki
## 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.
Karta pojazdu: wyszukiwanie i przypisywanie pasujących produktów z notatką
### 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.
Import CSV: podgląd przed zapisem z kontrolą indeksów i lat
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.
Raport importu CSV: utworzone pojazdy, powiązania produktów i wiersze do sprawdzenia
### 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).
Lista marek: pojazdy, pasujące produkty, URL i stan indeksowania każdej strony
Modele marki z latami, liczbą produktów i akcjami: publikacja, noindex, zmiana nazwy
## 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**.
Włączenie stron SEO i przetłumaczony prefiks URL w każdym języku
### 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.
Teksty domyślne ze zmiennymi {brand}, {model}, {count} i podglądem fragmentu Google
### 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.
Edycja strony modelu: URL, meta title, meta description, H1 i wstęp dla każdego języka z podglądem Google
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.
Strona SEO z listą marek i liczbą pasujących produktów
Strona docelowa SEO marki: modele, wstęp i pasujące produkty
Strona docelowa SEO modelu: filtry roku lub wersji i lista produktów motywu
Strona docelowa modelu na telefonie
### 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.
Strona produktu: oznaczenie „pasuje” do zapisanego pojazdu odwiedzającego
Strona produktu: oznaczenie „nie pasuje” i sprawdzanie innego pojazdu
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.
Tabela pasujących pojazdów na stronie produktu z linkami do stron marki i modelu
### 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.
„Mój garaż”: zapisane pojazdy klienta i bieżący pojazd
## 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.