Kowal Hyva Colors — culorile magazinului sub control

Panou și permisiuni

Deschizi modulul prin kowal.store → Modules → Hyva Colors. Configurarea se realizează în cele trei view-uri ale acestuia, nu într-o secțiune separată Stores → Configuration.

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

Importul care conține definiții noi de catalog necesită și dreptul de a adăuga elemente. După modificarea rolului, poate fi necesară autentificarea din nou a utilizatorului.

Domeniul magazinului

La publicare alegi un singur view de magazin (store view) activ. Modulul verifică tema atribuită: profilul curent 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 view-uri. În această versiune nu există configurație moștenită la nivel default/website/store.

Seturi de sistem și seturi 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 punct de referință.

Editor de culori

Editorul împarte catalogul în secțiuni: Global, Header, Buttons, Product cards și Catalog and product page. Numele 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 culori 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 el 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 inspector vizual de elemente.

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

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

Configurarea infrastructurii

Publicarea depinde de cron, media cu drept de scriere și cache. Fișierul CSS este generat înainte de activare, apoi servit static. Modulul nu adaugă JavaScript de culoare în storefrontul obișnuit. Acest lucru nu înseamnă garanția 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 fișierelor stylesheet. Detaliile de deployment sunt incluse în instrucțiunea de instalare.

Kowal Hyva Colors — instalare și actualizare

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

Cerințe

Dependențele complete sunt definite de 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

Configurează 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 — înlocuiește adresa cu adresa reală a repository-ului Composer:

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

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

2. Instalare

După punerea la dispoziție a release-ului 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 — deployează limbile folosite de magazin și de panou. Integrează generarea DI și a resurselor în procedura standard de deployment, în loc să le rulezi în timpul gestionării traficului pe catalogul de producție activ.

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

3. Cron și fișiere CSS

Modulul folosește sarcina kowal_hyva_colors_publish în grupul cron default, programată la fiecare minut. Pe server trebuie să ruleze cronul standard Magento. O 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

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

Fișierele stylesheet sunt salvate în pub/media/kowal/hyva-colors//.css. Asigură posibilitatea de scriere și citire prin HTTP. În cazul mai multor noduri, media trebuie să fie partajată. 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 kowal.store → Modules → Hyva Colors. Dacă meniul nu este vizibil, verifică Kowal Base și permisiunile rolului.
2. Verifică cele trei pagini: Seturi și publicare, Seturile mele, Istoricul modificărilor.
3. Pe un store view de test, publică paleta și așteaptă finalizarea sarcinii.
4. Verifică headerul, contul, minicartul, categoria și produsul pe desktop și telefon, inclusiv hover/focus.
5. Confirmă disponibilitatea CSS, reîmprospătarea FPC/Varnish și a tuturor nodurilor CDN.
6. Publică resetarea la tema nativă, apoi verifică restaurarea unei publicări anterioare.

Actualizare

După punerea la dispoziție a unui release nou:

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

Verifică restricția de versiune în fișierul principal composer.json al magazinului: valoarea exactă 0.1.6 nu va permite comenzii update să aleagă un release mai nou. Modific-o în mod conștient, de ex. prin composer require ...:NOWA-WERSJA --with-all-dependencies.

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

Probleme la instalare

• Pachetul nu este disponibil: verifică disponibilitatea release-ului, repository-urile și autorizarea Composer.
• Lipsește meniul: verifică activarea Kowal_Base, drepturile rolului și cache-ul configurației; reîmprospătează panoul.
• Conflict de catalog: rulează php bin/magento kowal:hyva-colors:catalog:sync --dry-run. Compară definițiile modificate înainte de sincronizare; nu suprascrie manual elementele proprii.
• Eroare Interceptor după o versiune veche: asigură-te că Composer a instalat pachetul corectat și reconstruiește codul generat în procesul standard de deployment.
• Culorile nu se schimbă: verifică istoricul, cronul, tema activă, CSS în media și propagarea cache-ului.

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