Free cookie consent management tool by TermsFeedAktualizacja preferencji plików cookie

Kowal Hyva Colors — kolory sklepu pod kontrolą

246,00 zł 200,00 zł
Instalacja COMPOSER
M2-HYVA-COLORS
Nie przegap: 20

Tracisz możliwość zdobycia 20 punktów lojalnościowych za ten produkt. Dołącz teraz

  • 2.4.9
  • 2.4.8
  • 2.4.7
  • 2.4.6
  • 2.4.5
  • 2.4.4
  • 2.4.3
  • 2.4.2
  • 2.4.1
  • 2.4.0
Aktualna wersja modułu v0.1.8
  • Hyva Theme Redy Hyva Theme Redy

Jeden panel, wiele możliwości

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.

Najważniejsze korzyści

  • Spójny wygląd marki. Zarządzaj kolorami obsługiwanych elementów z jednego miejsca, również dla wybranych stanów interakcji.
  • Szybsze przygotowanie kolejnych sklepów. Klonuj zestawy i przenoś zapisane konfiguracje przez eksport oraz import JSON wraz z katalogiem elementów.
  • Osobny wygląd widoków sklepu. Wybierz, którego store view dotyczy publikacja.
  • Kontrola nad zmianami. Edytuj szkic, a następnie świadomie opublikuj go. Sam zapis nie zmienia sklepu.
  • Powrót do wcześniejszego wyglądu. Historia publikacji pozwala przywrócić wcześniejszą zakończoną wersję.
  • Rozbudowa z panelu. Dodawaj własne elementy i sekcje bez modyfikowania plików modułu. Ten tryb wymaga znajomości selektorów CSS.
  • Statyczny CSS na storefrontcie. Arkusz powstaje podczas publikacji. Zmiana kolorów nie wymaga dodatkowego JavaScriptu modułu na stronie sklepu.

Dwie palety o szczególnym charakterze

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 kogo?

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

Opinie

Napisz własną recenzję
Napisz opinię o produkcie:Kowal Hyva Colors — kolory sklepu pod kontrolą
Twoja ocena

Konfiguracja Integracji

Panel i uprawnienia

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.

Zakres sklepu

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.

Zestawy systemowe i własne

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 kolorów

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.

Wspólne kolory: tokeny

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.

Dodawanie elementów i sekcji

Nie wymaga modyfikacji plików modułu, ale wymaga rozpoznania właściwego selektora CSS. Moduł nie ma wizualnego inspektora elementów.

  1. Otwórz edytor dowolnego zestawu.
  2. Rozwiń „Dodaj własny element — tryb zaawansowany”.
  3. Wpisz nazwę, np. „Baner promocyjny”.
  4. Wybierz istniejącą nazwę sekcji lub wpisz nową, np. „Promocje”.
  5. Wprowadź stabilny selektor, np. #promo-banner, który istnieje w sklepie.
  6. Wybierz właściwości, np. background-colorcolorborder-color.
  7. Wybierz stany, np. normal i hover, a następnie dodaj element.
  8. Otwórz odpowiednią sekcję, przypisz kolory, zapisz i opublikuj zestaw.

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.

Konfiguracja infrastruktury

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 Instalacji modułu

Kowal Hyva Colors — instalacja i aktualizacja

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.

Wymagania

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

1. Dostęp do Composer

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.

2. Instalacja

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.

3. Cron i pliki CSS

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.

4. Odbiór instalacji

  1. Otwórz kowal.store → Modules → Hyva Colors. Jeśli menu jest niewidoczne, sprawdź Kowal Base i uprawnienia roli.
  2. Sprawdź trzy strony: „Zestawy i publikacja”, „Moje zestawy”, „Historia zmian”.
  3. Na testowym store view opublikuj paletę i zaczekaj na zakończenie zadania.
  4. Sprawdź nagłówek, konto, minikoszyk, kategorię i produkt na desktopie i telefonie, również hover/focus.
  5. Potwierdź dostępność CSS, odświeżenie FPC/Varnish i wszystkich węzłów CDN.
  6. Opublikuj reset do natywnego motywu, a następnie sprawdź przywracanie wcześniejszej publikacji.

Aktualizacja

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.

Problemy przy instalacji

  • Pakiet nie jest dostępny: sprawdź dostępność wydania, repozytoria i autoryzację Composer.
  • Brak menu: sprawdź aktywację Kowal_Base, prawa roli i cache konfiguracji; odśwież panel.
  • Konflikt katalogu: uruchom php bin/magento kowal:hyva-colors:catalog:sync --dry-run. Porównaj zmienione definicje przed synchronizacją; nie nadpisuj ręcznie własnych elementów.
  • Błąd Interceptor po starej wersji: upewnij się, że Composer zainstalował poprawioną paczkę i przebuduj wygenerowany kod w standardowym procesie deploymentu.
  • Kolory się nie zmieniają: sprawdź historię, cron, aktywny motyw, CSS w media i propagację cache.

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.

AI Product Support
Produkty