Category Wall: wizualna strona kategorii

Category Wall zastępuje natywną listę podkategorii PrestaShop ścianą kafelków ze zdjęciami, licznikami produktów i trzema układami do wyboru. Ten przewodnik obejmuje instalację, konfigurację i zaawansowane użycie modułu.

Instalacja

Moduł instaluje się jak każdy inny moduł PrestaShop, bez zewnętrznych zależności i bez Composera.

1. W panelu administracyjnym otwórz Moduły > Menedżer modułów, następnie kliknij Zainstaluj moduł (przycisk w prawym górnym rogu).
2. Wybierz plik dfcategorywall.zip i uruchom instalację.
3. Po instalacji kliknij Konfiguruj, aby przejść do ustawień.

Jak działa wyświetlanie

Na każdej stronie kategorii moduł automatycznie wyświetla ścianę podkategorii nad listą produktów. Opiera się na hooku displayContentWrapperTop, obecnym w motywie Classic i w większości motywów od niego pochodnych.

Jeśli oglądana kategoria nie ma żadnej aktywnej podkategorii, ściana się nie pojawia: na kategoriach „liściach” moduł pozostaje całkowicie niewidoczny.

Opcje konfiguracji

Wszystkie opcje ustawia się na ekranie konfiguracji modułu.

Układ (layout)

Dostępne są trzy prezentacje:

• Siatka: regularna siatka kafelków o identycznym rozmiarze, idealna dla czystego, uporządkowanego wyglądu.
• Mozaika: dynamiczny układ, w którym pierwsza podkategoria zajmuje powiększony kafelek, przyciągając wzrok do flagowego działu.
• Karuzela: płynne przewijanie poziome, dotykowe na urządzeniach mobilnych i wyposażone w strzałki nawigacyjne na desktopie.

Kolumny

Ustaw liczbę kolumn wyświetlanych na desktopie, od 2 do 6. Wartość dotyczy układów siatki i karuzeli. Wyświetlanie automatycznie dostosowuje się do 3, a następnie 2 kolumn na tablecie i telefonie.

Liczniki produktów

Włącz opcję Pokaż liczniki produktów, aby na każdym kafelku pojawiła się liczba produktów podkategorii w formie odznaki.

• Licz produkty rekurencyjnie: sumuje produkty z całego drzewa potomnego (łącznie z pod-podkategoriami), a nie tylko produkty przypisane bezpośrednio.
• Ukryj puste podkategorie: usuwa ze ściany podkategorie bez żadnego widocznego produktu, aby prezentować wyłącznie realnie zaopatrzone działy.

Opis i tytuł

• Pokaż opis podkategorii: wyświetla krótki fragment pod nazwą każdego kafelka (przycięty do 120 znaków).
• Pokaż tytuł sekcji oraz Tytuł sekcji: konfigurowalny, wielojęzyczny nagłówek wyświetlany nad ścianą (na przykład „Przeglądaj podkategorie”). Pozostaw pole puste, aby ukryć tytuł.

Ukrywanie natywnej listy

Opcja Ukryj natywną listę podkategorii dodaje dyskretną regułę CSS, która ukrywa domyślny blok podkategorii motywu, aby uniknąć duplikacji ze ścianą. Opcja nie ma efektu, jeśli Twój motyw nie wyświetla tego bloku.

Kafelki bez zdjęcia

Gdy podkategoria nie ma zdjęcia okładkowego, moduł automatycznie generuje kafelek zastępczy: stabilny gradient koloru, wyprowadzony z identyfikatora kategorii, z inicjałem jej nazwy. Siatka pozostaje dzięki temu zawsze jednolita, bez pustych pól.

Użycie jako widget

Poza stroną kategorii ścianę można wstawić w dowolnym miejscu szablonu dzięki interfejsowi widgetów PrestaShop.

{widget name='dfcategorywall'}

Aby wskazać konkretną kategorię, przekaż jej identyfikator:

{widget name='dfcategorywall' id_category=12}

Rozwiązywanie problemów

Ściana się nie wyświetla

• Sprawdź, czy oglądana kategoria rzeczywiście ma aktywne podkategorie.
• Upewnij się, że Twój motyw wywołuje hook displayContentWrapperTop. Jeśli nie, użyj wstawiania przez widget opisanego powyżej.

Podkategorie pojawiają się podwójnie

Włącz opcję Ukryj natywną listę podkategorii, aby usunąć oryginalny blok motywu.

Strzałki karuzeli się nie pojawiają

Strzałki są widoczne tylko wtedy, gdy kafelków jest na tyle dużo, że wykraczają poza widoczną szerokość. Na telefonie nawigacja odbywa się wyłącznie palcem (przewijanie dotykowe).