Kategorie Na Stronie Głównej

Dokumentacja CC Kategorie Na Stronie Głównej PrestaShop

Kompleksowa dokumentacja dla modułu wyświetlania kategorii na stronie głównej PrestaShop (cc_ps_home_categories) z zaawansowanymi opcjami stylizacji, wieloma trybami wyświetlania i pełną kontrolą nad wyglądem kategorii.

Inhaltsübersicht

1. Einführung
2. Einrichtung
3. Aktivierung der Lizenz
4. Management-Panel
5. Allgemeine Einstellungen
6. Style wyświetlania
7. Konfiguracja obrazów
8. Wybór kategorii
9. Customizacja wyglądu
10. Responsywność
11. Lösung von Problemen
12. FAQ

1. Einleitung

CC PrestaShop Kategorie Główna to zaawansowany moduł umożliwiający eleganckie wyświetlanie kategorii na stronie głównej sklepu. Moduł oferuje szeroką gamę stylów wyświetlania, od klasycznych siatek po nowoczesne slidery, zapewniając pełną kontrolę nad wyglądem i funkcjonalnością.

Hauptfunktionen des Moduls:

• 7 różnych stylów siatki (klasyczna, nowoczesna, minimalistyczna, kolorowa, elegancka, dark mode, light bordered)
• Slider z nawigacją i obsługą gestów dotykowych
• 3 tryby list (pozioma, pionowa, kompaktowa)
• Pełna kontrola nad wyborem kategorii
• Zaawansowane opcje obrazów
• Reaktionsfähiges Design
• System licencyjny COCOS
• Wielojęzyczna obsługa
• Animacje i efekty przejść
• Możliwość umieszczenia w różnych hookach

2. Einbau

Systemanforderungen

• PrestaShop 1.7.0.0 oder höher
• PHP 7.2 oder höher
• MySQL 5.6 oder höher
• Erlaubnis zur Installation von Modulen
• Mindestens 256 MB RAM (512 MB empfohlen)
• Rozszerzenie GD dla przetwarzania obrazów

Einbauverfahren

1. Laden Sie die ZIP-Datei des Moduls aus dem offiziellen Shop herunter cocos.codes
2. Loggen Sie sich in das PrestaShop-Administrationspanel ein
3. Gehen Sie zu: Module > Modulmanager > Neues Modul hinzufügen
4. Klicken Sie auf "Modul hinzufügen" und wählen Sie die heruntergeladene ZIP-Datei aus.
5. Wenn die Installation abgeschlossen ist, klicken Sie auf "Konfigurieren".
6. Moduł automatycznie zarejestruje się w hooku displayHome

3. die Aktivierung der Lizenz

Bevor die volle Funktionalität des Moduls genutzt werden kann, ist es notwendig, die Lizenz zu aktivieren:

1. Nach der Installation fahren Sie mit der Modulkonfiguration fort
2. Wählen Sie die Registerkarte "Lizenz".
3. Geben Sie den nach dem Kauf erhaltenen Lizenzschlüssel ein
4. Klicken Sie auf "Lizenz aktivieren".
5. System sprawdzi ważność licencji na serwerach COCOS
6. Nach erfolgreicher Aktivierung erhalten Sie eine Bestätigungsmeldung

4 Management-Panel

Panel zarządzania modułem składa się z kilku zakładek umożliwiających pełną konfigurację:

Hauptregisterkarten:

• Einstellungen – główna konfiguracja modułu (dostępna tylko z ważną licencją)
• Dokumentation – link do pełnej dokumentacji online
• Unterstützung – link do strony wsparcia technicznego COCOS
• Plug-ins – lista dostępnych rozszerzeń COCOS
• Lizenz - Modul Lizenzmanagement

System automatycznie przekierowuje na zakładkę licencji jeśli klucz nie jest aktywny, zapewniając intuicyjny proces konfiguracji.

5. Allgemeine Einstellungen

Im Bereich der allgemeinen Einstellungen finden Sie die grundlegenden Optionen, die den Betrieb des Moduls steuern:

Einstellung	Beschreibung	Standardwert
Einschalten des Moduls	Globalne włączenie/wyłączenie wyświetlania	Auf
Pokaż tytuł sekcji	Wyświetlanie nagłówka nad kategoriami	Auf
Tytuł sekcji	Wielojęzyczny tekst nagłówka	„Nasze Kategorie”
Limit kategorii	Maksymalna liczba kategorii (1-50)	6

Funktionsweise des Hauptschalters

• Auf – kategorie są widoczne na stronie głównej zgodnie z konfiguracją
• Aus – moduł nie wyświetla żadnych kategorii

6. Style wyświetlania

Moduł oferuje 11 różnych stylów wyświetlania kategorii, podzielonych na 3 główne grupy:

Style siatki (Grid)

Styl	Beschreibung	Empfohlene Verwendung
grid_classic	Klasyczne karty z ramkami i cieniami	Uniwersalne sklepy
grid_modern	Gradient tła z overlay na obrazach	Nowoczesne marki
grid_minimal	Czyste, minimalistyczne karty	Sklepy premium
grid_colorful	Kolorowe ramki z animacjami	Sklepy dla dzieci/młodzieży
grid_elegant	Eleganckie karty ze złotymi akcentami	Luksusowe marki
grid_dark	Ciemny motyw z efektami świetlnymi	Gaming/elektronika
grid_light_bordered	Jasne karty z wyraźnymi ramkami	Sklepy korporacyjne

Style listy (List)

Styl	Beschreibung	Empfohlene Verwendung
list_horizontal	Poziome karty z obrazkiem z lewej	Strony kategorii głównych
list_vertical	Pionowe karty w kolumnach	Wąskie sekcje
list_compact	Kompaktowa lista z małymi obrazkami	Sidebar, stopka

Style slidera (Slider)

• slider_classic – Elegancki slider z nawigacją i overlay na hover

7. Konfiguracja obrazów

Moduł oferuje pełną kontrolę nad wyświetlaniem obrazów kategorii:

Rozmiary kontenerów

Größe	Wysokość	Zalecane dla
small	150px	Kompaktowe układy
medium	250px	Standardowe wyświetlanie
large	350px	Efektowne prezentacje

Typy obrazów
System automatycznie wykrywa dostępne typy obrazów zdefiniowane w PrestaShop dla kategorii:

• category_default – standardowy typ dla kategorii

Fallback obrazów
Jeśli kategoria nie ma przypisanego obrazu, system automatycznie wyświetla domyślny obraz zastępczy no-image-category.jpg.

8. Wybór kategorii

Moduł oferuje dwa tryby wyboru kategorii do wyświetlenia:

Tryb automatyczny
System automatycznie wybiera kategorie główne według ich pozycji:

• Pomija kategorię root (ID: 1)
• Pomija kategorię główną sklepu
• Sortuje według pozycji w drzewie kategorii
• Wybiera tylko aktywne kategorie
• Respektuje ustawiony limit

Tryb ręczny
Administrator może ręcznie wybrać konkretne kategorie:

• Lista ID kategorii oddzielonych przecinkami
• Przykład: 2,5,8,12
• System sprawdza czy kategorie istnieją i są aktywne
• Porządek wyświetlania według kolejności w liście
• Automatyczne pomijanie nieistniejących kategorii

Walidacja kategorii
Niezależnie od trybu system sprawdza:

• Czy kategoria istnieje w bazie danych
• Ist die Kategorie aktiv
• Czy kategoria ma nazwę w aktualnym języku
• Czy użytkownik ma uprawnienia do jej wyświetlenia

9. Dostosowanie wyglądu

Kontrola nad treścią

Opcja	Funkcja	Domyślnie
Pokaż nazwy kategorii	Wyświetlanie tytułów kategorii	Włączone
Pokaż opisy kategorii	Wyświetlanie opisów (skrócone)	Włączone
Liczba kolumn	Podział siatki (1-6 kolumn)	3

Responsywne zachowanie
System automatycznie dostosowuje liczbę kolumn:

• Desktop – pełna liczba kolumn
• Tablet – maksymalnie 2-3 kolumny
• Mobile – zawsze 1 kolumna

Efekty i animacje

• Fade-in podczas ładowania strony
• Hover effects na kartach
• Smooth transitions
• Scroll reveal animations
• Loading states dla obrazów

Responsywność slidera
Slider automatycznie:

• Dostosowuje liczbę widocznych elementów
• Obsługuje gestyswipe na urządzeniach dotykowych
• Pokazuje/ukrywa nawigację w zależności od potrzeb
• Zachowuje proporcje na różnych ekranach

10. Responsywność

Moduł jest w pełni responsywny i automatycznie dostosowuje się do różnych rozmiarów ekranów:

Breakpointy

Urządzenie	Szerokość	Kolumny	Zachowanie
Desktop	> 768px	Pełna konfiguracja	Standardowe wyświetlanie
Tablet	481-768px	Maksymalnie 2-3	Uproszony layout
Mobile	< 480px	1	Pionowy układ

Optymalizacje mobilne

• Automatyczne zmniejszenie padding i margin
• Responsive typography
• Touch-friendly navigation
• Zoptymalizowane rozmiary obrazów
• Uproszczone animacje

Style mobilne dla poszczególnych trybów

• Lista pozioma – przekształca się w pionową
• Lista kompaktowa – elementy układają się jeden pod drugim
• Slider – zmniejsza szerokość elementów i odstępy

11 Fehlersuche

Kategorie nie wyświetlają się na stronie głównej

1. Prüfen Sie, ob das Modul in den allgemeinen Einstellungen aktiviert ist
2. Sicherstellen, dass die Lizenz aktiv ist
3. Sprawdź czy wybrane kategorie są aktywne w PrestaShop
4. PrestaShop und Browser-Cache löschen
5. Sprawdź czy hook displayHome jest obsługiwany przez szablon

Style CSS nie są ładowane

1. Sprawdź czy plik views/css/front.css istnieje
2. Upewnij się, że jesteś na stronie głównej (kontroler: IndexController)
3. Prüfung auf Konflikte mit anderen Modulen
4. Wyłącz Cache CSS w ustawieniach PrestaShop
5. Sprawdź uprawnienia do odczytu plików modułu

Slider nie działa poprawnie

1. Prüfen Sie die Browser-Konsole auf JavaScript-Fehler
2. Upewnij się, że plik views/js/front.js jest ładowany
3. Sprawdź czy nie ma konfliktów z jQuery
4. Wyłącz inne moduły slider na czas testów
5. Sprawdź czy elementy mają poprawną strukturę HTML

Obrazy nie są wyświetlane

1. Sprawdź czy kategorie mają przypisane obrazy
2. Upewnij się, że wybrany typ obrazu istnieje w systemie
3. Sprawdź uprawnienia do katalogu img/c/
4. Sprawdź czy plik no-image-category.jpg istnieje
5. Wyczyść pamięć podręczną obrazów

Błędy licencji

1. Sprawdź czy klucz licencyjny jest poprawny
2. Upewnij się, że domena jest zgodna z licencją
3. Sprawdź połączenie z serwerami COCOS
4. Wyczyść pamięć podręczną modułu
5. Skontaktuj się z supportem w przypadku problemów z aktywacją

12. FAQ

Czy mogę używać kilku stylów jednocześnie?
Nie, moduł pozwala na wybór tylko jednego stylu wyświetlania na raz. Możesz jednak łatwo zmienić styl w ustawieniach.

Jak dodać własny styl wyświetlania?
Nowe style wymagają modyfikacji plików CSS i PHP. Zalecamy skopiowanie istniejącego stylu i dostosowanie go do swoich potrzeb.

Czy mogę wyświetlać podkategorie?
Obecnie moduł obsługuje tylko kategorie główne. Wyświetlanie podkategorii wymaga modyfikacji kodu źródłowego.

Jak zmienić pozycję modułu na stronie?
Moduł jest automatycznie umieszczony w hooku displayHome na pierwszej pozycji. Możesz zmienić kolejność w menu Pozycja w panelu modułów.

Czy moduł działa z cache’owaniem?
Tak, moduł jest kompatybilny z systemami cache PrestaShop i nie wymaga specjalnej konfiguracji.

Jak przetłumaczyć tytuł sekcji?
Pole „Tytuł sekcji” obsługuje wszystkie aktywne języki w sklepie. Przełącz język w panelu administracyjnym i wprowadź tłumaczenie.

Czy mogę ukryć opisy kategorii dla niektórych stylów?
Opcja „Pokaż opisy kategorii” działa globalnie dla wszystkich stylów. Niektóre style (jak grid_modern) wyświetlają opisy w overlay.

Dlaczego slider pokazuje strzałki nawigacji gdy nie są potrzebne?
JavaScript automatycznie ukrywa strzałki gdy wszystkie elementy mieszczą się w widoku. Sprawdź czy elementy mają poprawne wymiary.

Jak działa lazy loading obrazów?
Obrazy są ładowane automatycznie gdy stają się widoczne w viewport. To oszczędza przepustowość i przyspiesza ładowanie strony.

Czy mogę zmienić animacje hover?
Animacje są zdefiniowane w CSS dla każdego stylu. Możesz je modyfikować edytując plik front.css.

Dlaczego niektóre kategorie nie są wyświetlane?
System pomija nieaktywne kategorie, kategorie bez nazwy oraz te do których użytkownik nie ma uprawnień.

Jak zmienić domyślny obraz kategorii?
Zastąp plik views/img/no-image-category.jpg własnym obrazem o tych samych wymiarach.

Czy moduł obsługuje RTL (right-to-left)?
Moduł używa standardowych klas Bootstrap które obsługują RTL. Może być potrzebne dostosowanie niektórych stylów.

Jak wyłączyć animacje?
Możesz usunąć lub zakomentować animacje CSS w pliku front.css lub dodać animation: none; do odpowiednich selektorów.

Czy mogę zmienić liczebowość opisów kategorii?
Opisy są automatycznie skracane do 80-120 znaków w zależności od stylu. Możesz zmienić to w pliku template home_categories.tpl.

Dlaczego moduł nie działa po aktualizacji PrestaShop?
Sprawdź kompatybilność wersji w pliku modułu. Możliwe że potrzebna jest aktualizacja modułu do najnowszej wersji.

Jak zoptymalizować wydajność dla dużej liczby kategorii?
Użyj trybu ręcznego wyboru kategorii i ogranicz liczbę do maksymalnie 12 elementów. Włącz lazy loading i cache obrazów.

Czy mogę używać modułu na stronach kategorii?
Moduł jest przeznaczony dla strony głównej. Umieszczenie na innych stronach wymaga modyfikacji hookew w kodzie źródłowym.

Jak sprawdzić które hooki są dostępne w moim szablonie?
Użyj modułu „Hook displayer” lub sprawdź pliki template w katalogu szablonu. Nie wszystkie szablony obsługują wszystkie hooki.

Dlaczego style dark mode nie wyświetlają się poprawnie?
Style dark wymagają specjalnego wrappera. Sprawdź czy szablon nie nadpisuje kolorów tła i czy nie ma konfliktów z innymi stylami.

Jak eksportować konfigurację modułu?
Konfiguracja jest przechowywana w tabeli ps_configuration z prefiksem CC_PS_HC_. Możesz wyeksportować te rekordy przez phpMyAdmin.

Jeśli prowadzisz sklep na PrestaShop i chcesz poprawić prezentację kategorii na stronie głównej, zalecamy skorzystanie z modułu CC PrestaShop Kategorie Na Stronie Głównej, który zapewni profesjonalny wygląd i pełną kontrolę nad sposobem wyświetlania kategorii produktów.