Rozwiązywanie problemów
Ta strona zbiera problemy, które widzimy najczęściej. Jeśli Twój badge źle się zachowuje, przejdź najpierw przez pasującą sekcję.
Badge nie pojawia się na storefroncie
Dział zatytułowany „Badge nie pojawia się na storefroncie”Sprawdź, w kolejności:
- Plugin jest włączony — Ustawienia → Pluginy → Badge produktowe → Ogólne → Włącz plugin.
- Badge jest aktywny — badge nie został dezaktywowany.
- Przynajmniej jedno rozmieszczenie jest skonfigurowane (strona szczegółowa LUB listing). Badge z obydwoma rozmieszczeniami ustawionymi na Ukryte nigdy się nie renderuje.
- Okno active-from / active-to obejmuje aktualny czas.
- Ograniczenie kanału sprzedaży obejmuje aktualny storefront (lub jest puste).
- Reguły wszystkie pasują dla aktualnego kontekstu klienta / koszyka. Testuj najpierw bez dołączonych reguł, żeby wyizolować problem.
- Przypisanie — dla badge Standard, produkt musi być w przypisaniu (bezpośrednio, przez kategorię, producenta lub strumień).
- Cache — wyczyść cache HTTP Shopware (
bin/console cache:clear).
Dla typów automatycznych zweryfikuj też warunek bazowy:
- Rabat — czy produkt ma
cena katalogowa > cena sprzedaży? - Nowość — czy data premiery (lub utworzenia, jeśli fallback jest włączony) jest w skonfigurowanym oknie?
- Brak na stanie — czy efektywny stan magazynowy jest ≤ 0 pod wybranym trybem sprawdzania?
- Bestseller — czy boolean “Bestseller” w Shopware jest prawdziwy na produkcie?
Menu “Badge produktowe” nie pojawia się po instalacji
Dział zatytułowany „Menu “Badge produktowe” nie pojawia się po instalacji”- Potwierdź że plugin jest aktywowany pod Rozszerzenia → Moje rozszerzenia.
- Wyczyść cache admina:
bin/console cache:clear. - Twardo przeładuj admina (Ctrl+Shift+R) żeby przeglądarka pobrała nowy bundle.
- Jeśli sam budujesz administrację, uruchom build administracji ponownie.
- Sprawdź że Twoja rola użytkownika ma dostęp do nowych kluczy ACL.
Dwa badge walczą o ten sam slot
Dział zatytułowany „Dwa badge walczą o ten sam slot”Użyj priorytetu — niższy numer wygrywa. Zwiększ odstęp priorytetu między badge’ami, żeby precedencja była jednoznaczna.
Jeśli oba badge wciąż się renderują, sprawdź wartość Max liczba badge dla kontekstu strony. Ustawienie Max liczba badge na 1 czyni slot pojedynczo-zwycięskim — renderuje się tylko badge o najwyższym priorytecie.
Stylizacja nie działa
Dział zatytułowany „Stylizacja nie działa”Najczęstsza przyczyna to kolejność dziedziczenia — wartość na bardziej specyficznym poziomie nadpisuje to co ustawiłeś gdzie indziej. Przejdź przez:
- Czy sam badge nadpisuje pole? Wyczyść je na badge’u, żeby fallbackowało.
- Czy domyślne slotu różnią się od globalnych domyślnych? Porównaj oba.
- Czy domyślne rozmieszczenia przejmują (istotne tylko dla rozmieszczeń innych niż nakładka)?
Zobacz Przegląd stylizacji dla pełnego łańcucha rozwiązywania.
Wstążka narożna przepełnia zdjęcie
Dział zatytułowany „Wstążka narożna przepełnia zdjęcie”Zwiększ Max offset narożny na slocie lub skróć tekst badge’a — zwykle 1 do 3 słów daje najlepszy kształt wstążki. Zobacz Wstążki narożne.
Etykiety “Nowość” / “Bestseller” / “Rabat” Shopware wciąż się pokazują
Dział zatytułowany „Etykiety “Nowość” / “Bestseller” / “Rabat” Shopware wciąż się pokazują”Skonfigurowałeś badge pluginu tego samego typu, ale zwykłe etykiety Shopware wciąż się renderują obok. Przełącz Ukryj domyślne badge Shopware w konfiguracji globalnej żeby je stłumić. Zobacz Ukryj domyślne badge Shopware.
Badge “Nowość” nigdy się nie pojawia
Dział zatytułowany „Badge “Nowość” nigdy się nie pojawia”- Upewnij się że produkt ma ustawioną datę premiery, lub
- Włącz fallback dla badge “Nowość” w konfiguracji globalnej, żeby plugin fallbackował na datę utworzenia.
Zobacz Badge Nowość.
Badge pojawia się na wariancie ale nie na jego rodzicu (lub odwrotnie)
Dział zatytułowany „Badge pojawia się na wariancie ale nie na jego rodzicu (lub odwrotnie)”Dla typu Brak na stanie jest to kontrolowane przez Tryb sprawdzania stanu magazynowego. Przełącz tryb (tylko produkt / uwzględnij rodzica) osobno dla stron szczegółowych i listingów. Zobacz Badge Brak na stanie.
Dla innych typów badge śledzą standardowe renderowanie produktu/wariantu Shopware — upewnij się że przypisanie obejmuje właściwą encję.
Storefront wciąż pokazuje starą stylizację badge’a po zmianie
Dział zatytułowany „Storefront wciąż pokazuje starą stylizację badge’a po zmianie”Shopware agresywnie cache’uje HTML storefrontu. Po edycji badge’a:
- Wyczyść cache HTTP:
bin/console cache:clear. - Jeśli używasz reverse proxy (Varnish / Cloudflare), wyczyść go też.
- Twardo przeładuj stronę storefrontu (Ctrl+Shift+R).
Layouty CMS nie pokazują badge
Dział zatytułowany „Layouty CMS nie pokazują badge”Badge renderują się w elementach CMS tylko gdy layout używa jednego z czterech wspieranych elementów (galeria obrazów, boks zakupowy, boks produktu, slider produktów). Niestandardowy Twig, który omija te elementy, nie dostaje integracji badge — zobacz Integracja CMS.
Gdzie szukać najpierw
Dział zatytułowany „Gdzie szukać najpierw”- Ustawienia → Pluginy → Badge produktowe → Ogólne — sprawdź Włącz plugin i Ukryj domyślne badge Shopware.
- Formularz badge’a → zakładka Widoczność — sprawdź kanały sprzedaży, reguły, daty.
- Formularz badge’a → zakładki Przypisanie — dla badge Standard, zweryfikuj że produkt jest faktycznie uwzględniony.
- Podgląd na żywo — przełącz panel Podgląd, żeby potwierdzić że badge wygląda jak oczekujesz.