Kowal Hyva Colors — culorile magazinului sub control

Panou și permisiuni

Modulul se deschide prin kowal.store → Modules → Hyva Colors. Configurarea se face în cele trei vizualizări ale sale, nu într-o secțiune separată Stores → Configuration.

Administratorul acordă permisiuni în System → Permissions → User Roles. Pune la dispoziția rolurilor resursele de meniu părinte Kowal corespunzătoare și resursele Hyva Colors:

Importul care conține definiții noi ale catalogului necesită și dreptul de a adăuga elemente. După modificarea rolului, poate fi necesară reconectarea utilizatorului.

Domeniul magazinului

La publicare alegi un singur store view activ. Modulul verifică tema atribuită: profilul actual acceptă exact Hyva/default cu Default Theme 1.5.2–1.5.x. Nu atribui o altă temă doar pentru a ocoli validarea — temele copil necesită pregătirea separată a mapărilor.

Setul este o schiță reutilizabilă. Îl poți publica separat pentru mai multe vizualizări. În această versiune nu există configurație moștenită la nivel default/website/store.

Seturi de sistem și proprii

Definițiile gata pregătite includ șapte palete și un set nativ gol. Copiile lor salvate sunt disponibile în „Seturile mele”. Cel mai comod este să creezi seturi proprii pe baza lor — astfel originalele rămân puncte de referință.

Editor de culori

Editorul împarte catalogul în secțiuni: Global, Header, Buttons, Product cards și Catalog and product page. Denumirile pot rămâne în engleză. Catalogul inițial conține 34 de elemente și 99 de mapări. Un singur element poate avea intrări separate pentru fundal, text, bordură și stări de interacțiune.

Modalități disponibile de setare a valorii:

native nu inserează CSS inherit. Valoarea transparent este o culoare transparentă explicită, nu o revenire la temă. Poți folosi și currentColor. Funcțiile CSS arbitrare, precum rgb() sau var(), nu sunt acceptate în câmpurile de culoare.

Salvează schița înainte de a schimba secțiunea sau pagina editorului. Salvarea nu publică modificările.

Culori comune: tokenuri

În „Paletă — setări avansate (JSON)” sunt stocate culorile denumite. Exemplu de fragment:

{ 'brand': {'mode': 'color', 'value': '#1d4ed8'}, 'on-brand': {'mode': 'color', 'value': '#ffffff'}}

În rândul elementului, alege „Culoare din paletă” și introdu brand. Modificarea tokenului actualizează toate valorile care fac referire la acesta la următoarea publicare. Dacă editezi un set gata pregătit, păstrează celelalte tokenuri existente — înlocuirea întregului JSON cu fragmentul de mai sus poate lăsa referințe nerezolvate. Ciclurile și tokenurile lipsă sunt respinse.

Adăugarea elementelor și secțiunilor

Nu necesită modificarea fișierelor modulului, dar necesită identificarea selectorului CSS corect. Modulul nu are un inspector vizual de elemente.

1. Deschide editorul oricărui set.
2. Extinde „Adaugă element propriu — mod avansat”.
3. Introdu denumirea, de exemplu „Banner promoțional”.
4. Alege o denumire de secțiune existentă sau introdu una nouă, de exemplu „Promoții”.
5. Introdu un selector stabil, de exemplu #promo-banner, care există în magazin.
6. Alege proprietățile, de exemplu background-color, color, border-color.
7. Alege stările, de exemplu normal și hover, apoi adaugă elementul.
8. Deschide secțiunea corespunzătoare, atribuie culorile, salvează și publică setul.

Definiția ajunge în catalogul comun; simpla adăugare a acesteia nu setează culori în toate seturile. Selectorul trebuie să fie cât mai precis posibil. În această versiune nu sunt acceptate listele de selectori, :has() sau declarațiile CSS arbitrare. Adăugarea unui element nu creează HTML-ul acestuia în magazin. Încă nu există editare din panou pentru selectorii existenți și nici arhivarea elementelor.

Configurarea infrastructurii

Publicarea depinde de cron, media cu drept de scriere și cache. Foaia CSS este generată înainte de activare, apoi este servită static. Modulul nu adaugă JavaScript de culoare în storefront-ul obișnuit. Acest lucru nu înseamnă garantarea unui anumit rezultat de performanță — măsurătorile trebuie efectuate în magazinul țintă.

În cazul Varnish, verifică accesul la serverele purge. În cazul CDN și al mai multor noduri, verifică propagarea HTML și disponibilitatea foilor. Detaliile de deployment sunt incluse în instrucțiunea de instalare.

Kowal Hyva Colors — instalare și actualizare

Instrucțiuni pentru versiunea 0.1.6. Executați comenzile în directorul rădăcină Magento, ca utilizator de implementare, în cadrul procedurii standard de deployment a magazinului. Verificați mai întâi instalarea într-un mediu de testare.

Cerințe

Dependențele complete sunt definite în composer.json. Cerințele dependențelor nu reprezintă o declarație că toate combinațiile de versiuni au fost testate. Tema copil este în prezent respinsă de validarea publicării, chiar dacă moștenește din Hyvä.

1. Acces la Composer

Configurați repository-ul Composer care pune la dispoziție kowal/module-hyva-colors și kowal/base, conform datelor primite de la furnizor. Este necesar și acces autorizat la repository-ul Hyvä. Adresa repository-ului și metoda de autorizare depind de accesul furnizat; această instrucțiune nu presupune disponibilitatea publică a pachetului.

Exemplu de schemă de configurare — înlocuiți adresa cu adresa reală a repository-ului Composer:

composer config repositories.kowal composer 'https://ADRES-REPOZYTORIUM-COMPOSER'

Păstrați datele de autentificare în afara repository-ului proiectului, de exemplu într-un auth.json privat sau în configurația CI. Nu le copiați în documentație.

2. Instalare

După publicarea versiunii 0.1.6 în repository:

composer require kowal/module-hyva-colors:0.1.6 --with-all-dependenciesphp bin/magento module:enable Kowal_Base Kowal_HyvaColorsphp bin/magento setup:upgradephp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy pl_PL en_USphp bin/magento cache:clean config layout block_html full_pagephp bin/magento module:status Kowal_HyvaColorsphp bin/magento kowal:hyva-colors:diagnose

Locale-urile indicate sunt un exemplu — implementați limbile utilizate de magazin și de panou. Integrați generarea DI și a resurselor în procedura standard de deployment, în loc să le rulați în timpul deservirii traficului pe catalogul de producție activ.

Instalarea creează catalogul și seturile inițiale. Nu publică culorile și nu modifică aspectul magazinului. Comanda diagnose verifică pachetul și raportează acoperirea funcțiilor; nu este un test complet al mediului.

3. Cron și fișiere CSS

Modulul utilizează sarcina kowal_hyva_colors_publish din grupul cron default, planificată la fiecare minut. Pe server trebuie să ruleze cron-ul standard Magento. O singură execuție procesează maximum 10 sarcini; publicarea nu trebuie să fie imediată.

Procesarea manuală a cozii pentru diagnosticare:

php bin/magento kowal:hyva-colors:publication:process

Verificați statusul unei sarcini concrete în Istoricul modificărilor — executarea cu succes a comenzii nu înseamnă că fiecare sarcină s-a finalizat cu succes.

Foile de stil sunt salvate în pub/media/kowal/hyva-colors//.css. Asigurați posibilitatea de scriere și citire prin HTTP. În cazul mai multor noduri, media trebuie să fie comune. Pentru aceste fișiere imuabile se pot configura Content-Type: text/css, compresia și Cache-Control: public, max-age=31536000, immutable. Modulul nu setează configurația serverului sau a CDN-ului.

4. Recepția instalării

1. Deschideți kowal.store → Modules → Hyva Colors. Dacă meniul nu este vizibil, verificați Kowal Base și permisiunile rolului.
2. Verificați cele trei pagini: Seturi și publicare, Seturile mele, Istoricul modificărilor.
3. Pe un store view de test, publicați paleta și așteptați finalizarea sarcinii.
4. Verificați antetul, contul, minicoșul, categoria și produsul pe desktop și pe telefon, inclusiv hover/focus.
5. Confirmați disponibilitatea CSS, reîmprospătarea FPC/Varnish și a tuturor nodurilor CDN.
6. Publicați resetarea la tema nativă, apoi verificați restaurarea publicării anterioare.

Actualizare

După publicarea unei noi versiuni:

composer update kowal/module-hyva-colors kowal/base --with-all-dependenciesphp bin/magento setup:upgradephp bin/magento setup:di:compilephp bin/magento setup:static-content:deploy pl_PL en_USphp bin/magento cache:clean config layout block_html full_page

Verificați restricția de versiune în fișierul principal composer.json al magazinului: valoarea exactă 0.1.6 nu va permite comenzii update să aleagă o versiune mai nouă. Modificați-o în mod deliberat, de exemplu prin composer require ...:NOWA-WERSJA --with-all-dependencies.

Actualizarea nu înlocuiește publicarea activă cu o paletă nouă. După modificările de fabrică, selectați din nou setul gata pregătit și publicați-l. Schițele proprii salvate își păstrează valorile proprii.

Probleme la instalare

• Pachetul nu este disponibil: verificați disponibilitatea versiunii, repository-urile și autorizarea Composer.
• Meniul lipsește: verificați activarea Kowal_Base, drepturile rolului și cache-ul configurației; reîmprospătați panoul.
• Conflict de catalog: rulați php bin/magento kowal:hyva-colors:catalog:sync --dry-run. Comparați definițiile modificate înainte de sincronizare; nu suprascrieți manual propriile elemente.
• Eroare Interceptor după o versiune veche: asigurați-vă că Composer a instalat pachetul corectat și reconstruiți codul generat în procesul standard de deployment.
• Culorile nu se modifică: verificați istoricul, cron-ul, tema activă, CSS-ul din media și propagarea cache-ului.

Resetarea culorilor se efectuează în panou. Nu necesită dezinstalarea modulului sau ștergerea tabelelor. Înainte de dezactivarea sau eliminarea modulului, exportați seturile necesare și realizați o copie a bazei de date conform procedurii de mentenanță a magazinului.