Modyfikacje szablonu Hyva dla Magento2
Opis / Modyfikacje szablonu Hyva dla Magento2
MAGENTO 2 · UKŁAD · KATALOG · KARTY PRODUKTÓW
Dopasuj układ Hyvä do sposobu prezentacji oferty.
Kowal Hyva — modyfikacje szablonu
Zarządzaj szerokością treści, siatką produktów i układem szczegółów produktu z konfiguracji Magento. Pakiet Kowal Hyva porządkuje prezentację katalogu i treści bez tworzenia osobnego motywu potomnego dla obsługiwanych zmian.
Konfiguracja Store View · Układ produktu · Prezentacja katalogu
JAK TO DZIAŁA W PRAKTYCE
01 · Wybierasz zakres ustawień
Dopasowujesz konfigurację do website lub Store View.
02 · Ustawiasz układ i prezentację
Dobierasz szerokości, kolumny, opisy i akcje katalogowe.
03 · Sprawdzasz aktywny motyw
Odświeżasz cache i oceniasz efekt na rzeczywistych stronach sklepu.
Co zyskuje Twój sklep?
Poznaj funkcje, zastosowanie i ustawienia modułu.
Szerokość treści według rodzaju strony
W Stores → Configuration → Kowal → Hyva Layout → Content Width ustaw osobne maksymalne szerokości strony głównej, kategorii, produktu i CMS. Puste wartości zachowują szerokość motywu; możesz podać piksele lub procent.
Opcjonalne Force width on all pages nadaje priorytet szerokości globalnej i obejmuje także inne trasy sklepu. Ustawienia dotyczą głównej treści oraz obsługiwanych kontenerów nagłówka i breadcrumbs; stopka zachowuje własną szerokość.
Siatka kategorii dopasowana do miejsca
Tabela Columns by list width określa liczbę kolumn 1–12 według rzeczywistej szerokości listy po uwzględnieniu bocznych filtrów. Najmniejszy pasujący próg wygrywa; jeden wiersz bez maksimum może określić układ powyżej największego progu.
Pusta tabela zachowuje motyw. Mechanizm obejmuje natywny tryb GRID kategorii, a nie LIST, wyszukiwanie czy rekomendacje. Reguły progowe wymagają obsługi CSS container queries przez przeglądarkę.
Układ szczegółów produktu
Konfiguracja Product Page pozwala wybrać 1, 2 lub 3 kolumny szczegółów od szerokości 1024 px; na mniejszych ekranach pozostaje jedna kolumna. Możesz sterować widocznością etykiet More Information i maksymalną wysokością kart.
Długie karty mają niezależne Pokaż więcej / Pokaż mniej. Pusta wysokość wyświetla pełną treść. Zmiana dotyczy natywnej siatki szczegółów, nie układu galerii i zakupu ani niezależnych sekcji pełnej szerokości.
Czytelne opisy i długie fragmenty kodu
Opis produktu zachowuje filtrowanie atrybutów Magento i otrzymuje natywną typografię Hyvä. Zabezpieczenia układu utrzymują opisy oraz zakładki w granicach sekcji: długi kod blokowy może przewijać się wewnątrz, a kod inline i tekst zawijają się.
Jawne style Page Buildera pozostają w treści. Własne zakładki odpowiadają za swoją typografię; brakujące podziały wierszy trzeba poprawić w źródłowym opisie.
Ceny ilościowe i przyciski akcji
Catalog Display pozwala dodać natywne progi cen ilościowych do kart produktów kategorii, wyszukiwania i sliderów. Produkty bez odpowiednich progów zachowują standardowy wygląd ceny.
Opcja Icons Add To zamienia obsługiwane akcje wishlist, compare i zapytania Kowal na przyciski z ikoną i etykietą. Zachowuje ich działanie; moduł zapytań pozostaje opcjonalny.
Tryb LIST i rozmiary zdjęć
Możesz zachować HTML oraz pełniejszą treść krótkiego opisu w trybie LIST, a także ukryć wyjście ceny o zerowej wartości końcowej w LIST i GRID. Ukrycie ceny dotyczy prezentacji i nie zmienia możliwości zakupu ani zapisanych cen.
Osobne rozmiary miniatur GRID i LIST ustawiasz w pikselach. Mniejsze oryginały nie są powiększane; istniejące marginesy w pliku źródłowym pozostają. Puste wartości zachowują zachowanie motywu.
Wybrane usprawnienia integracji
Pakiet respektuje wyłączenie skrótu PayPal na stronie produktu Hyvä, gdy konfiguracja jawnie zabrania jego wyświetlania. Pozostałe komponenty PayPal mogą działać zgodnie ze swoimi ustawieniami.
Pole logo nagłówka w Design Configuration obsługuje ograniczony, walidowany profil statycznego SVG. Opcjonalna diagnostyka odrzuceń reCAPTCHA podczas rejestracji jest domyślnie wyłączona; nie zastępuje walidacji ani nie gwarantuje naprawy błędu konfiguracji.
Zakres zgodności i wdrożenie
Pakiet kowal/module-hyva wymaga Hyvä. Ustawienia korzystają ze standardowego dziedziczenia Magento Default → Website → Store View; rendering obsługiwanych zmian zachowuje fallback Luma.
Własne karty, nagłówki i komponenty o stałych szerokościach mogą wymagać dopasowania. Po aktualizacji uwzględnij setup:upgrade, kompilację i wdrożenie zasobów w procesie sklepu oraz odśwież cache. Sprawdź wynik na telefonie i komputerze oraz przy rzeczywistych danych katalogu.
Instalacja przez Composer
Pakiet kowal/module-hyva, moduł Kowal_Hyva. Po skonfigurowaniu dostępu do repozytorium Kowal zainstaluj pakiet, włącz moduł, zaktualizuj Magento i wyczyść cache. W produkcji uwzględnij kompilację i wdrożenie treści statycznych zgodnie z procesem sklepu.
Od konfiguracji do efektu
1. Wybierasz zakres ustawień
Dopasowujesz konfigurację do website lub Store View.
2. Ustawiasz układ i prezentację
Dobierasz szerokości, kolumny, opisy i akcje katalogowe.
3. Sprawdzasz aktywny motyw
Odświeżasz cache i oceniasz efekt na rzeczywistych stronach sklepu.
Przykład: katalog produktów technicznych
Ustawiasz szerszą kategorię i liczbę kolumn zależną od dostępnego miejsca na listę. W trybie LIST zachowujesz formatowany krótki opis, a przy produktach ze zdefiniowanymi progami dodajesz ceny ilościowe. Na stronie produktu dobierasz układ szczegółów i wysokość kart.
Dopasuj prezentację Hyvä do swojego katalogu.
Chcesz dopasować moduł do swojego sklepu? Zapytaj o wdrożenie Kowal Hyva — modyfikacje szablonu i omów konfigurację lub potrzebne rozszerzenia.
Więcej informacji
| Motyw Hyvä | Zgodny z motywem Hyvä |
|---|---|
| Zgodność z szablonem | Hyvä, Luma / Blank, KOWAL |
Instrukcja Instalacji modułu
Przed rozpoczęciem
Moduł wymaga PHP 8.1+ oraz wcześniej zainstalowanego i aktywnego motywu Hyvä z pakietem hyva-themes/magento2-theme-module. Licencję i instalację Hyvä zapewnij osobno. Pakiet Kowal_Hyva rozszerza istniejący motyw; nie wymaga edycji plików vendor ani osobnego motywu potomnego.
Polecenia wykonaj w katalogu głównym Magento. Wersja PHP musi być zgodna z używaną wersją Magento. Dane dostępowe do repozytorium — e-mail klienta i token licencyjny — otrzymasz po zakupie. Są również dostępne w panelu klienta na kowal.store.
Dodaj repozytorium Composer
composer config repositories.kowal composer https://repo.kowal.storeSkonfiguruj dane dostępowe
Zastąp poniższe wartości adresem e-mail swojego konta i otrzymanym tokenem.
composer config http-basic.repo.kowal.store "TWOJ_EMAIL_KLIENTA" "TWOJ_TOKEN"Zainstaluj pakiet
composer require kowal/module-hyvaWłącz moduł
php bin/magento module:enable Kowal_HyvaZaktualizuj Magento
php bin/magento setup:upgradeDokończ wdrożenie
W trybie production wykonaj kompilację i wdrożenie plików statycznych zgodnie z procedurą sklepu. W przykładzie użyto języków pl_PL i en_US — zastąp je językami swojej instalacji.
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy pl_PL en_USPo instalacji lub zmianie konfiguracji wyczyść pamięć podręczną:
php bin/magento cache:clean config layout block_html full_pageOtwórz konfigurację Hyvä
Przejdź do Stores → Configuration → Kowal → Hyva Layout. Wybierz Default, Website lub Store View zgodnie z zakresem zmiany. Aby ustawić wartość lokalną, wyłącz dziedziczenie przy danym polu.
Ustaw opis produktu
W sekcji Product Page wybierz liczbę kolumn opisu: 1, 2 lub 3. Podział działa od szerokości 1024 px. Ustaw etykiety rozwijania i zwijania oraz maksymalną wysokość opisu; domyślnie jest to 500 px. Puste pole wysokości pokazuje całość.
Ustaw szerokości stron
W sekcji Content Width ustaw osobno szerokość strony głównej, kategorii, produktu i CMS. Podaj dodatnią wartość w pikselach, np. 1440 lub 1440px, albo procent od 1% do 100%. Puste pole pozostawia ustawienia motywu.
Force width on all pages wymusza jedną szerokość i zastępuje wartości dla poszczególnych typów stron. Opcja jest domyślnie wyłączona. Zmiana obejmuje zawartość strony i odpowiednie wewnętrzne kontenery nagłówka, wyszukiwarki oraz okruszków; nie obejmuje stopki.
Dostosuj siatkę i prezentację produktów
W Category Product Grid ustaw liczbę kolumn zależnie od szerokości samej listy produktów. Możliwe jest od 1 do 12 kolumn. Pusta tabela pozostawia układ motywu. Ustawienia dotyczą siatki kategorii, a nie trybu listy ani wyników wyszukiwania.
W Catalog Display skonfiguruj ceny progowe, wariant ikon lub przycisków, zachowanie HTML krótkiego opisu w trybie LIST, ukrywanie cen zerowych oraz rozmiary zdjęć GRID/LIST. Rozmiar zdjęcia może wynosić od 1 do 2000; puste pole pozostawia wartość motywu.
Zapisz i zweryfikuj widok sklepu
Zapisz konfigurację i wyczyść cache. Sprawdź stronę produktu, kategorię oraz ustawione szerokości na komputerze i telefonie. Zmiany opisane w konfiguracji nie wymagają przebudowy Tailwind.
php bin/magento cache:clean config block_html full_pageJeśli używasz logo SVG, wgraj je w Content → Design → Configuration → Edit → Header → Logo Image. Moduł przyjmuje statyczne SVG o rozmiarze do 2 MB.
