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.

Índice

1. Introducción
2. Instalación
3. Activación de la licencia
4. Panel de gestión
5. Configuración general
6. Style wyświetlania
7. Konfiguracja obrazów
8. Wybór kategorii
9. Customizacja wyglądu
10. Responsywność
11. Resolución de problemas
12. PREGUNTAS FRECUENTES

1. introducción

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

Funciones principales del módulo:

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

2. instalación

Requisitos del sistema

• PrestaShop 1.7.0.0 o posterior
• PHP 7.2 o posterior
• MySQL 5.6 o posterior
• Permiso para instalar módulos
• 256 MB de RAM como mínimo (se recomiendan 512 MB)
• Rozszerzenie GD dla przetwarzania obrazów

Proceso de instalación

1. Descargue el archivo ZIP del módulo de la tienda oficial códigos.cocos
2. Inicie sesión en el panel de administración de PrestaShop
3. Vaya a: Módulos > Gestor de módulos > Añadir nuevo módulo
4. Haga clic en "Añadir módulo" y seleccione el archivo ZIP descargado.
5. Una vez finalizada la instalación, haga clic en "Configurar".
6. Moduł automatycznie zarejestruje się w hooku displayHome

3. activación de la licencia

Antes de poder utilizar todas las funciones del módulo, es necesario activar la licencia:

1. Tras la instalación, proceda a la configuración del módulo
2. Seleccione la pestaña "Licencia
3. Introduzca la clave de licencia recibida tras la compra
4. Haga clic en "Activar licencia".
5. System sprawdzi ważność licencji na serwerach COCOS
6. Tras la activación, aparecerá un mensaje de confirmación.

4 Panel de gestión

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

Pestañas principales:

• Ajustes – główna konfiguracja modułu (dostępna tylko z ważną licencją)
• Documentación – link do pełnej dokumentacji online
• Ayuda – link do strony wsparcia technicznego COCOS
• Plug-ins – lista dostępnych rozszerzeń COCOS
• Licencia - gestión de licencias de módulos

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

5. ajustes generales

En la sección de ajustes generales encontrarás las opciones básicas que controlan el funcionamiento del módulo:

Configuración	Descripción	Valor por defecto
Encender el módulo	Globalne włączenie/wyłączenie wyświetlania	En
Pokaż tytuł sekcji	Wyświetlanie nagłówka nad kategoriami	En
Tytuł sekcji	Wielojęzyczny tekst nagłówka	„Nasze Kategorie”
Limit kategorii	Maksymalna liczba kategorii (1-50)	6

Funcionalidad del interruptor principal

• En – kategorie są widoczne na stronie głównej zgodnie z konfiguracją
• Fuera de – 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	Descripción	Uso recomendado
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	Descripción	Uso recomendado
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

Talla	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
• ¿Está activa la categoría?
• 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 Solución de problemas

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

1. Compruebe si el módulo está activado en los ajustes generales
2. Asegurarse de que la licencia está activa
3. Sprawdź czy wybrane kategorie są aktywne w PrestaShop
4. Borrar la caché de PrestaShop y del navegador
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. Comprobación de conflictos con otros módulos
4. Wyłącz Cache CSS w ustawieniach PrestaShop
5. Sprawdź uprawnienia do odczytu plików modułu

Slider nie działa poprawnie

1. Compruebe si hay errores de JavaScript en la consola del navegador
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. PREGUNTAS FRECUENTES

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.