Kowal Mega Menu dla Magento Luma i Hyva
100,00 zł 100,00 zł
Kolory nagłówka, przycisków, tekstów, ikon i obramowań nie muszą być rozproszone po plikach motywu. Moduł grupuje obsługiwane elementy w sekcjach, dzięki czemu możesz zmieniać ich wygląd i budować powtarzalne zestawy dla swojej marki.
Zacznij od jednej z siedmiu palet: niebieskiej, zielonej, fioletowej, pomarańczowej, grafitowej, czarnej lub jasnej/białej. Możesz opublikować gotowy zestaw, utworzyć własną wersję albo zacząć od pustej konfiguracji. Dostępny jest również powrót do natywnych kolorów aktywnego motywu.
Czarny: ciemny nagłówek z białymi tekstami i ikonami, jasny licznik koszyka oraz łagodniejsze szare obramowania. To elegancki akcent kolorystyczny, a nie pełny tryb ciemny całej witryny.
Jasny / Biały: zachowuje natywne tła, dzięki czemu szare otoczenie może kontrastować z białymi kartami produktów. Obsługiwane ramki są przezroczyste w spoczynku i szare po najechaniu.
Dla właścicieli sklepów, administratorów i agencji, które chcą przygotowywać własne zestawy kolorystyczne oraz ponownie wykorzystywać je w zgodnych wdrożeniach Hyvä.
Moduł otwierasz przez kowal.store → Modules → Hyva Colors. Konfiguracja odbywa się w jego trzech widokach, a nie w osobnej sekcji Stores → Configuration.
Administrator nadaje uprawnienia w System → Permissions → User Roles. Udostępnij rolom odpowiednie nadrzędne zasoby menu Kowal i zasoby Hyva Colors:
| Zasób | Zastosowanie |
|---|---|
| View colors and history | Przeglądanie zestawów i historii |
| Edit presets | Tworzenie, zapis, klonowanie, usuwanie własnych i reset systemowych zestawów |
| Add custom elements | Dodawanie elementów do katalogu |
| Import and export presets | Przenoszenie zestawów przez JSON |
| Publish and restore colors | Publikacja, reset wyglądu, przywracanie i ponawianie publikacji |
Import zawierający nowe definicje katalogu wymaga również prawa dodawania elementów. Po zmianie roli może być potrzebne ponowne zalogowanie użytkownika.
Przy publikacji wybierasz jeden aktywny widok sklepu (store view). Moduł sprawdza przypisany motyw: obecny profil obsługuje dokładnie Hyva/default z Default Theme 1.5.2–1.5.x. Nie przypisuj innego motywu tylko po to, aby ominąć walidację — motywy potomne potrzebują osobnego przygotowania mapowań.
Zestaw jest szkicem wielokrotnego użytku. Możesz publikować go osobno dla kilku widoków. W tej wersji nie ma konfiguracji dziedziczonej na poziomie default/website/store.
Gotowe definicje obejmują siedem palet i pusty zestaw natywny. Ich zapisane kopie są dostępne w „Moje zestawy”. Najwygodniej tworzyć własne zestawy na ich podstawie — dzięki temu oryginały pozostają punktem odniesienia.
| Zestaw | Charakter |
|---|---|
| Niebieski, Zielony, Fioletowy, Pomarańczowy, Grafitowy | Akcent wiodący i dopasowane kolory obsługiwanych elementów |
| Czarny | Ciemny nagłówek, biała zawartość i jasny licznik koszyka; pozostałe powierzchnie pozostają jasne |
| Jasny / Biały | Natywne tła, ukryte obsługiwane ramki i szare ramki na hover |
| Natywny — bez nadpisania | Brak CSS kolorystycznego modułu; wygląd wynika z aktywnego motywu |
Edytor dzieli katalog na sekcje: Global, Header, Buttons, Product cards oraz Catalog and product page. Nazwy mogą pozostać angielskie. Katalog początkowy zawiera 34 elementy i 99 mapowań. Pojedynczy element może mieć osobne wpisy dla tła, tekstu, ramki i stanów interakcji.
Dostępne sposoby ustawienia wartości:
| Tryb w panelu | Działanie |
|---|---|
| Własny kolor | Jawny kolor, np. #171717, #ffffff, #11223380 |
| Kolor z palety | Odwołanie do tokenu, np. brand |
| Styl natywny | Usunięcie nadpisania danej właściwości; obowiązuje styl motywu |
| Bez nadpisania | Brak wartości na tej warstwie; w pojedynczym szkicu pozostawia styl motywu |
native nie wstawia CSS inherit. Wartość transparent jest jawnym kolorem przezroczystym, a nie powrotem do motywu. Możesz użyć również currentColor. Dowolne funkcje CSS, takie jak rgb() lub var(), nie są przyjmowane w polach kolorów.
Zapisuj szkic przed zmianą sekcji lub strony edytora. Zapis nie publikuje zmian.
W „Paleta — ustawienia zaawansowane (JSON)” przechowywane są nazwane kolory. Przykład fragmentu:
{
"brand": {"mode": "color", "value": "#1d4ed8"},
"on-brand": {"mode": "color", "value": "#ffffff"}
}
W wierszu elementu wybierz „Kolor z palety” i wpisz brand. Zmiana tokenu aktualizuje wszystkie odwołujące się do niego wartości przy następnej publikacji. Jeśli edytujesz gotowy zestaw, zachowaj pozostałe istniejące tokeny — zastąpienie całego JSON powyższym fragmentem może pozostawić nierozwiązane odwołania. Cykle i brakujące tokeny są odrzucane.
Nie wymaga modyfikacji plików modułu, ale wymaga rozpoznania właściwego selektora CSS. Moduł nie ma wizualnego inspektora elementów.
#promo-banner, który istnieje w sklepie.background-color, color, border-color.normal i hover, a następnie dodaj element.Definicja trafia do wspólnego katalogu; samo jej dodanie nie ustawia kolorów we wszystkich zestawach. Selektor powinien być możliwie precyzyjny. W tej wersji nie są obsługiwane listy selektorów, :has() ani dowolne deklaracje CSS. Dodanie elementu nie tworzy jego HTML w sklepie. Nie ma jeszcze panelowej edycji istniejących selektorów i archiwizacji elementów.
Publikacja zależy od crona, zapisywalnych mediów i cache. Arkusz CSS jest generowany przed aktywacją, a następnie serwowany statycznie. Moduł nie dodaje JavaScriptu kolorystycznego do zwykłego storefrontu. Nie oznacza to gwarancji konkretnego wyniku wydajności — pomiary należy wykonać w docelowym sklepie.
Przy Varnish sprawdź dostęp do serwerów purge. Przy CDN i wielu węzłach sprawdź propagację HTML oraz dostępność arkuszy. Szczegóły wdrożeniowe zawiera instrukcja instalacji.
Instrukcja dla wersji 0.1.6. Polecenia wykonuj w katalogu głównym Magento jako użytkownik wdrożeniowy, w ramach standardowej procedury deploymentu sklepu. Najpierw sprawdź instalację na środowisku testowym.
| Składnik | Wymaganie obecnej paczki |
|---|---|
| PHP | 8.3.x, 8.4.x lub 8.5.x; rozszerzenia JSON i zlib |
| Magento Framework | ^103.0.9; środowisko referencyjne Magento 2.4.9 |
| Hyvä Theme Module | ~1.5.2 |
| Aktywny motyw publikacji | Dokładnie Hyva/default; Default Theme 1.5.2–1.5.x |
| Kowal Base | ^1.1.7 |
| Usługi | Działający cron Magento, zapisywalne media i poprawnie skonfigurowany cache |
Pełne zależności określa composer.json. Wymagania zależności nie są deklaracją przetestowania wszystkich kombinacji wersji. Motyw potomny jest obecnie odrzucany przez walidację publikacji, nawet gdy dziedziczy z Hyvä.
Skonfiguruj repozytorium Composer udostępniające kowal/module-hyva-colors oraz kowal/base, zgodnie z danymi otrzymanymi od dostawcy. Potrzebny jest również uprawniony dostęp do repozytorium Hyvä. Adres repozytorium i sposób autoryzacji zależą od dostarczonego dostępu; ta instrukcja nie zakłada publicznej dostępności paczki.
Przykładowy schemat konfiguracji — zastąp adres rzeczywistym adresem repozytorium Composer:
composer config repositories.kowal composer 'https://ADRES-REPOZYTORIUM-COMPOSER'
Dane uwierzytelniające przechowuj poza repozytorium projektu, np. w prywatnym auth.json lub konfiguracji CI. Nie kopiuj ich do dokumentacji.
Po udostępnieniu wydania 0.1.6 w repozytorium:
composer require kowal/module-hyva-colors:0.1.6 --with-all-dependencies
php bin/magento module:enable Kowal_Base Kowal_HyvaColors
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy pl_PL en_US
php bin/magento cache:clean config layout block_html full_page
php bin/magento module:status Kowal_HyvaColors
php bin/magento kowal:hyva-colors:diagnose
Podane locale są przykładem — wdrażaj języki używane przez sklep i panel. Generowanie DI i zasobów połącz ze standardową procedurą wdrożeniową, zamiast uruchamiać je podczas obsługi ruchu na aktywnym katalogu produkcyjnym.
Instalacja tworzy katalog i zestawy początkowe. Nie publikuje kolorów i nie zmienia wyglądu sklepu. Komenda diagnose sprawdza katalog paczki i raportuje zakres funkcji; nie jest pełnym testem środowiska.
Moduł korzysta z zadania kowal_hyva_colors_publish w grupie cron default, planowanego co minutę. Na serwerze musi działać standardowy cron Magento. Jedno wykonanie obsługuje maksymalnie 10 zadań; publikacja nie musi być natychmiastowa.
Ręczne przetworzenie kolejki do diagnostyki:
php bin/magento kowal:hyva-colors:publication:process
Sprawdź status konkretnego zadania w „Historia zmian” — pomyślne wykonanie komendy nie oznacza, że każde zadanie zakończyło się sukcesem.
Arkusze są zapisywane w pub/media/kowal/hyva-colors/<store-id>/<hash>.css. Zapewnij możliwość zapisu oraz odczytu przez HTTP. Przy wielu węzłach media muszą być wspólne. Dla tych niezmiennych plików można skonfigurować Content-Type: text/css, kompresję i Cache-Control: public, max-age=31536000, immutable. Moduł nie ustawia konfiguracji serwera ani CDN.
Po udostępnieniu nowego wydania:
composer update kowal/module-hyva-colors kowal/base --with-all-dependencies
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy pl_PL en_US
php bin/magento cache:clean config layout block_html full_page
Sprawdź ograniczenie wersji w głównym composer.json sklepu: dokładne 0.1.6 nie pozwoli poleceniu update wybrać nowszego wydania. Zmień je świadomie, np. przez composer require ...:NOWA-WERSJA --with-all-dependencies.
Aktualizacja nie zastępuje aktywnej publikacji nową paletą. Po zmianach fabrycznych wybierz ponownie gotowy zestaw i opublikuj go. Zapisane własne szkice zachowują własne wartości.
Kowal_Base, prawa roli i cache konfiguracji; odśwież panel.php bin/magento kowal:hyva-colors:catalog:sync --dry-run. Porównaj zmienione definicje przed synchronizacją; nie nadpisuj ręcznie własnych elementów.Reset kolorów wykonuje się w panelu. Nie wymaga odinstalowania modułu ani kasowania tabel. Przed wyłączeniem lub usunięciem modułu wyeksportuj potrzebne zestawy i wykonaj kopię bazy zgodnie z procedurą utrzymania sklepu.