# Zdjęcie po najechaniu i automatyczne etykiety: przewodnik konfiguracji

> Ten przewodnik wyjaśnia, jak zainstalować i skonfigurować moduł Zdjęcie po najechaniu i automatyczne etykiety dla PrestaShop 8 i 9. Moduł wyświetla drugie zdjęcie produktu po najechaniu kursorem na listingach i…

- Strona: <https://www.datafirefly.com/pl/documentation/image-survol-badges-prestashop/>
- Język: pl
- Zaktualizowano: 2026-07-30
- Inne języki: [fr](https://www.datafirefly.com/documentation/image-survol-badges-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/image-survol-badges-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/image-survol-badges-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/image-survol-badges-prestashop/index.md), [it](https://www.datafirefly.com/it/documentation/image-survol-badges-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/image-survol-badges-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/image-survol-badges-prestashop/index.md)
- Indeks: <https://www.datafirefly.com/pl/documentation/llms.txt>

Ten przewodnik wyjaśnia, jak zainstalować i skonfigurować moduł **Zdjęcie po najechaniu i automatyczne etykiety** dla PrestaShop 8 i 9. Moduł wyświetla drugie zdjęcie produktu po najechaniu kursorem na listingach i automatycznie nadaje etykiety Nowość, Promocja i Niski stan według reguł, które sam ustalasz, bez nadpisywania Twojego motywu.

## Instalacja

Instalacja przebiega jak w przypadku każdego modułu PrestaShop:

1. W panelu administracyjnym przejdź do **Moduły > Menedżer modułów**.
2. Kliknij **Wgraj moduł** i wskaż archiwum ZIP modułu.
3. Po zakończeniu instalacji kliknij **Konfiguruj**, aby otworzyć stronę ustawień.

Moduł rejestruje hook `actionFrontControllerSetMedia` i ładuje swoje zasoby (CSS i JavaScript) wyłącznie na stronach listingu oraz na karcie produktu. Żaden plik szablonu nie jest nadpisywany.

## Konfiguracja zdjęcia po najechaniu

Pierwszy blok konfiguracji steruje podmianą zdjęcia po najechaniu:

- **Pokaż drugie zdjęcie po najechaniu**: włącza albo wyłącza efekt. Produkty z tylko jednym zdjęciem są automatycznie pomijane.
- **Efekt przejścia**: _Przenikanie_, _Przenikanie z powiększeniem_ albo _Natychmiastowy_.
- **Pozycja etykiet**: róg, w którym wyświetlają się etykiety (lewy górny, prawy górny, lewy dolny, prawy dolny). To ustawienie jest wspólne dla wszystkich etykiet.

Zdjęcie pokazywane po najechaniu to **drugie zdjęcie produktu** według kolejności ustalonej w zakładce Zdjęcia na karcie produktu. Aby zmienić zdjęcie wyświetlane po najechaniu, wystarczy zmienić kolejność zdjęć produktu.

## Trzy automatyczne etykiety

Każdą etykietę można włączyć niezależnie, z własnym wielojęzycznym opisem, kolorem tła i kolorem tekstu.

### Etykieta „Nowość"

Wyświetla się przez konfigurowalną liczbę dni od daty utworzenia produktu. Wartość domyślna pochodzi z ustawienia PrestaShop `PS_NB_DAYS_NEW_PRODUCT`. Ustaw pożądany okres w polu **Produkt uznawany za nowość przez (dni)**.

### Etykieta „Promocja"

Wyświetla się, gdy produkt jest oznaczony jako „W promocji" albo gdy dla kontekstu odwiedzającego aktywna jest **cena specjalna z obniżką** (sklep, waluta, kraj, grupa klientów i daty obowiązywania). Opcja **Pokaż procent rabatu** zastępuje opis wartością, na przykład `-20 %`, gdy obniżka jest wyrażona procentowo.

### Etykieta „Niski stan"

Wyświetla się, gdy dostępna ilość produktu jest ściśle większa od 0 i mniejsza lub równa **progowi niskiego stanu**, który ustalasz. Ilość jest odczytywana z tabeli `stock_available` z rozwiązaniem wielosklepowym (bieżący sklep ma pierwszeństwo przed grupą sklepów).

## Wielojęzyczne opisy

Opisy Nowość, Promocja i Niski stan są domyślnie dostarczane po francusku, angielsku, hiszpańsku, niemiecku i włosku. Każdy opis jest edytowalny język po języku na stronie konfiguracji: wybierz język w przełączniku pola, a następnie wpisz żądany tekst.

## Wydajność i zgodność

- **Jedno zbiorcze zapytanie AJAX** na stronę pobiera dane wszystkich widocznych produktów (do 120 produktów w partii).
- Zdjęcie po najechaniu ładuje się w trybie **lazy load**, dopiero przy pierwszym najechaniu myszą.
- Skrypt jest napisany w **vanilla JavaScript**, bez zależności od jQuery.
- Moduł wykrywa miniatury produktów w JavaScripcie: jest zgodny z motywem _classic_ i motywami potomnymi oraz automatycznie dostosowuje się po nawigacji fasetowej i paginacji AJAX.
- Na urządzeniach dotykowych podmiana zdjęcia po najechaniu jest automatycznie wyłączana.

## Rozwiązywanie problemów

**Po najechaniu nie pokazuje się drugie zdjęcie.** Sprawdź, czy produkt ma co najmniej dwa zdjęcia w zakładce Zdjęcia na swojej karcie oraz czy opcja zdjęcia po najechaniu jest włączona.

**Etykieta się nie pojawia.** Upewnij się, że etykieta jest włączona, że jej opis nie jest pusty w bieżącym języku i że warunek jest spełniony (produkt niedawno dodany, aktywna cena specjalna albo ilość poniżej progu).

**Nic się nie wyświetla po zastosowaniu filtra.** Moduł dostosowuje się po nawigacji fasetowej; jeśli Twój motyw używa własnego mechanizmu renderowania, wyczyść pamięć podręczną PrestaShop (Ustawienia zaawansowane > Wydajność) po instalacji.