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.

Table of contents

1. Introduction
2. Installation
3. License activation
4. Management panel
5. General settings
6. Style wyświetlania
7. Konfiguracja obrazów
8. Wybór kategorii
9. Customizacja wyglądu
10. Responsywność
11. Troubleshooting
12. FAQ

1. introduction

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ą.

Main functions of the module:

• 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
• Responsive design
• System licencyjny COCOS
• Wielojęzyczna obsługa
• Animacje i efekty przejść
• Możliwość umieszczenia w różnych hookach

2 Installation

System requirements

• PrestaShop 1.7.0.0 or later
• PHP 7.2 or later
• MySQL 5.6 or later
• Permission to install modules
• Minimum 256 MB RAM (512 MB recommended)
• Rozszerzenie GD dla przetwarzania obrazów

Installation process

1. Download the ZIP file of the module from the official store cocos.codes
2. Log in to your PrestaShop admin panel
3. Go to: Modules > Module Manager > Add New Module
4. Click "Add Module" and select the downloaded ZIP file
5. When the installation is complete, click "Configure"
6. Moduł automatycznie zarejestruje się w hooku displayHome

3. license activation

It is necessary to activate the license before using the full functionality of the module:

1. After installation, go to configure the module
2. Select the "License" tab
3. Enter the license key you received after purchase
4. Click "Activate License"
5. System sprawdzi ważność licencji na serwerach COCOS
6. After successful activation, you will see a confirmation message

4. management panel

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

Main tabs:

• Settings – główna konfiguracja modułu (dostępna tylko z ważną licencją)
• Documentation – link do pełnej dokumentacji online
• Support – link do strony wsparcia technicznego COCOS
• Plugins – lista dostępnych rozszerzeń COCOS
• License - module license management

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

5. general settings

In the general settings section you will find the basic options that control the operation of the module:

Setup	Description	Default value
Enable the module	Globalne włączenie/wyłączenie wyświetlania	Enabled
Pokaż tytuł sekcji	Wyświetlanie nagłówka nad kategoriami	Enabled
Tytuł sekcji	Wielojęzyczny tekst nagłówka	„Nasze Kategorie”
Limit kategorii	Maksymalna liczba kategorii (1-50)	6

Functionality of the main switch

• Enabled – kategorie są widoczne na stronie głównej zgodnie z konfiguracją
• Turned off – 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	Description	Recommended use
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	Description	Recommended use
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

Size	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
• Is the category active
• 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 Troubleshooting

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

1. Check if the module is enabled in the general settings
2. Make sure the license is active
3. Sprawdź czy wybrane kategorie są aktywne w PrestaShop
4. Clear PrestaShop and browser cache
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. Check for conflicts with other modules
4. Wyłącz Cache CSS w ustawieniach PrestaShop
5. Sprawdź uprawnienia do odczytu plików modułu

Slider nie działa poprawnie

1. Check your browser console for JavaScript errors
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 FAQS.

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.