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 des matières

1. Introduction
2. Installation
3. Activation de la licence
4. Panel de gestion
5. Paramètres généraux
6. Style wyświetlania
7. Konfiguracja obrazów
8. Wybór kategorii
9. Customizacja wyglądu
10. Responsywność
11. Résolution de problèmes
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ą.

Fonctions du module principal :

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

2. installation

Exigences du système

• PrestaShop 1.7.0.0 ou plus récent
• PHP 7.2 ou version ultérieure
• MySQL 5.6 ou plus récent
• Permission d'installer des modules
• 256 Mo de RAM au minimum (512 Mo recommandés)
• Rozszerzenie GD dla przetwarzania obrazów

Processus d'installation

1. Télécharger le fichier ZIP du module depuis la boutique officielle cocos.codes
2. Se connecter au panneau d'administration de PrestaShop
3. Allez dans : Modules > Gestionnaire de modules > Ajouter un nouveau module
4. Cliquez sur "Ajouter un module" et sélectionnez le fichier ZIP téléchargé.
5. Une fois l'installation terminée, cliquez sur "Configurer"
6. Moduł automatycznie zarejestruje się w hooku displayHome

3. Activation de la licence

Avant de pouvoir utiliser toutes les fonctionnalités du module, il est nécessaire d'activer la licence :

1. Après l'installation, procéder à la configuration du module
2. Sélectionnez l'onglet "Licence
3. Saisir la clé de licence reçue après l'achat
4. Cliquez sur "Activer la licence"
5. System sprawdzi ważność licencji na serwerach COCOS
6. Une fois l'activation réussie, un message de confirmation s'affiche

4 Panneau de gestion

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

Principaux onglets :

• Paramètres – główna konfiguracja modułu (dostępna tylko z ważną licencją)
• Documentation – link do pełnej dokumentacji online
• Soutien – link do strony wsparcia technicznego COCOS
• Plug-ins – lista dostępnych rozszerzeń COCOS
• Licence - gestion des licences de modules

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

5. paramètres généraux

Dans la section des paramètres généraux, vous trouverez les options de base qui contrôlent le fonctionnement du module :

Paramètres	Description	Valeur par défaut
Mise sous tension du module	Globalne włączenie/wyłączenie wyświetlania	Sur
Pokaż tytuł sekcji	Wyświetlanie nagłówka nad kategoriami	Sur
Tytuł sekcji	Wielojęzyczny tekst nagłówka	„Nasze Kategorie”
Limit kategorii	Maksymalna liczba kategorii (1-50)	6

Fonctionnement de l'interrupteur principal

• Sur – kategorie są widoczne na stronie głównej zgodnie z konfiguracją
• Arrêt – 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	Utilisation recommandée
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	Utilisation recommandée
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

Taille	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
• La catégorie est-elle 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 Dépannage

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

1. Vérifier si le module est activé dans les paramètres généraux
2. S'assurer que la licence est active
3. Sprawdź czy wybrane kategorie są aktywne w PrestaShop
4. Effacer le cache de PrestaShop et du navigateur
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. Vérifier s'il y a des conflits avec d'autres modules
4. Wyłącz Cache CSS w ustawieniach PrestaShop
5. Sprawdź uprawnienia do odczytu plików modułu

Slider nie działa poprawnie

1. Vérifier si la console du navigateur contient des erreurs JavaScript
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. LA 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.