Kowal Hyva Colors — winkelkleuren onder controle

Paneel en rechten

U opent de module via kowal.store → Modules → Hyva Colors. De configuratie vindt plaats in de drie weergaven van de module, niet in een afzonderlijke sectie Stores → Configuration.

De beheerder kent rechten toe in System → Permissions → User Roles. Geef rollen de juiste bovenliggende Kowal-menuresources en Hyva Colors-resources:

Een import met nieuwe catalogusdefinities vereist ook het recht om elementen toe te voegen. Na een rolwijziging kan opnieuw inloggen door de gebruiker nodig zijn.

Winkelbereik

Bij publicatie kiest u één actieve winkelweergave (store view). De module controleert het toegewezen thema: het huidige profiel ondersteunt exact Hyva/default met Default Theme 1.5.2–1.5.x. Wijs geen ander thema toe alleen om de validatie te omzeilen — child themes hebben afzonderlijke voorbereiding van mappings nodig.

Een set is een herbruikbaar concept. U kunt deze apart voor meerdere weergaven publiceren. In deze versie is er geen configuratie die op default/website/store-niveau wordt overgeërfd.

Systeemsets en eigen sets

Kant-en-klare definities omvatten zeven paletten en een lege native set. Hun opgeslagen kopieën zijn beschikbaar in Mijn sets. Het is het handigst om eigen sets op basis daarvan te maken — zo blijven de originelen een referentiepunt.

Kleureneditor

De editor verdeelt de catalogus in secties: Global, Header, Buttons, Product cards en Catalog and product page. De namen mogen Engels blijven. De initiële catalogus bevat 34 elementen en 99 mappings. Een afzonderlijk element kan aparte vermeldingen hebben voor achtergrond, tekst, rand en interactiestatussen.

Beschikbare manieren om waarden in te stellen:

native voegt geen CSS inherit in. De waarde transparent is een expliciete transparante kleur en geen terugkeer naar het thema. U kunt ook currentColor gebruiken. Willekeurige CSS-functies, zoals rgb() of var(), worden niet geaccepteerd in kleurvelden.

Sla het concept op voordat u van sectie of editorpagina wisselt. Opslaan publiceert geen wijzigingen.

Gedeelde kleuren: tokens

In Palet — geavanceerde instellingen (JSON) worden benoemde kleuren opgeslagen. Voorbeeldfragment:

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

Kies in de elementrij Kleur uit palet en voer brand in. Een wijziging van het token werkt alle waarden bij die ernaar verwijzen bij de volgende publicatie. Als u een kant-en-klare set bewerkt, behoud dan de overige bestaande tokens — het vervangen van de volledige JSON door bovenstaand fragment kan onopgeloste verwijzingen achterlaten. Cycli en ontbrekende tokens worden afgewezen.

Elementen en secties toevoegen

Dit vereist geen wijziging van modulebestanden, maar wel het herkennen van de juiste CSS-selector. De module heeft geen visuele elementinspector.

1. Open de editor van een willekeurige set.
2. Vouw Eigen element toevoegen — geavanceerde modus uit.
3. Voer een naam in, bijv. Promotiebanner.
4. Kies een bestaande sectienaam of voer een nieuwe in, bijv. Promoties.
5. Voer een stabiele selector in, bijv. #promo-banner, die in de winkel bestaat.
6. Kies eigenschappen, bijv. background-color, color, border-color.
7. Kies statussen, bijv. normal en hover, en voeg vervolgens het element toe.
8. Open de juiste sectie, wijs kleuren toe, sla op en publiceer de set.

De definitie komt in de gedeelde catalogus terecht; alleen het toevoegen ervan stelt nog geen kleuren in alle sets in. De selector moet zo nauwkeurig mogelijk zijn. In deze versie worden selectorlijsten, :has() en willekeurige CSS-declaraties niet ondersteund. Het toevoegen van een element maakt de HTML ervan niet aan in de winkel. Er is nog geen paneelbewerking van bestaande selectors en geen archivering van elementen.

Infrastructuurconfiguratie

Publicatie is afhankelijk van cron, beschrijfbare media en cache. Het CSS-bestand wordt vóór activering gegenereerd en vervolgens statisch geserveerd. De module voegt geen kleur-JavaScript toe aan de gewone storefront. Dit betekent geen garantie voor een concreet prestatieresultaat — metingen moeten in de doelwinkel worden uitgevoerd.

Controleer bij Varnish de toegang tot purge-servers. Controleer bij CDN en meerdere nodes de propagatie van HTML en de beschikbaarheid van stylesheets. Implementatiedetails staan in de installatie-instructie.

Kowal Hyva Colors — installatie en update

Instructie voor versie 0.1.6. Voer de opdrachten uit in de hoofdmap van Magento als deploymentgebruiker, binnen de standaard deploymentprocedure van de winkel. Controleer de installatie eerst in een testomgeving.

Vereisten

De volledige afhankelijkheden worden bepaald door composer.json. Vereisten voor afhankelijkheden zijn geen verklaring dat alle versiecombinaties zijn getest. Een child theme wordt momenteel door de publicatievalidatie afgewezen, zelfs wanneer het van Hyvä erft.

1. Toegang tot Composer

Configureer de Composer-repository die kowal/module-hyva-colors en kowal/base beschikbaar stelt, volgens de gegevens die u van de leverancier hebt ontvangen. Bevoegde toegang tot de Hyvä-repository is ook nodig. Het repositoryadres en de autorisatiemethode zijn afhankelijk van de geleverde toegang; deze instructie gaat niet uit van publieke beschikbaarheid van het pakket.

Voorbeeld van een configuratieschema — vervang het adres door het werkelijke Composer-repositoryadres:

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

Bewaar inloggegevens buiten de projectrepository, bijvoorbeeld in een privé auth.json of CI-configuratie. Kopieer ze niet naar documentatie.

2. Installatie

Nadat release 0.1.6 in de repository beschikbaar is gesteld:

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

De opgegeven locales zijn een voorbeeld — deploy de talen die door de winkel en het paneel worden gebruikt. Combineer het genereren van DI en assets met de standaard deploymentprocedure, in plaats van deze uit te voeren terwijl verkeer op de actieve productiecatalogus wordt afgehandeld.

De installatie maakt de catalogus en startsets aan. Ze publiceert geen kleuren en wijzigt het uiterlijk van de winkel niet. De opdracht diagnose controleert de pakketdirectory en rapporteert het functiebereik; dit is geen volledige omgevingstest.

3. Cron en CSS-bestanden

De module gebruikt de taak kowal_hyva_colors_publish in de cron-groep default, gepland elke minuut. Op de server moet de standaard Magento-cron actief zijn. Eén uitvoering verwerkt maximaal 10 taken; publicatie hoeft niet onmiddellijk te zijn.

Handmatige verwerking van de wachtrij voor diagnose:

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

Controleer de status van een specifieke taak in Wijzigingshistorie — een succesvolle uitvoering van de opdracht betekent niet dat elke taak met succes is voltooid.

Stylesheets worden opgeslagen in pub/media/kowal/hyva-colors//.css. Zorg voor schrijfrechten en HTTP-leestoegang. Bij meerdere nodes moeten media gedeeld zijn. Voor deze onveranderlijke bestanden kunnen Content-Type: text/css, compressie en Cache-Control: public, max-age=31536000, immutable worden geconfigureerd. De module stelt geen server- of CDN-configuratie in.

4. Acceptatie van de installatie

1. Open kowal.store → Modules → Hyva Colors. Als het menu niet zichtbaar is, controleer dan Kowal Base en de rolrechten.
2. Controleer de drie pagina's: Sets en publicatie, Mijn sets, Wijzigingshistorie.
3. Publiceer op een test-store view een palet en wacht tot de taak is voltooid.
4. Controleer header, account, minicart, categorie en product op desktop en telefoon, inclusief hover/focus.
5. Bevestig de beschikbaarheid van CSS, het verversen van FPC/Varnish en alle CDN-nodes.
6. Publiceer een reset naar het native thema en controleer vervolgens het herstellen van een eerdere publicatie.

Update

Nadat een nieuwe release beschikbaar is gesteld:

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

Controleer de versiebeperking in de hoofd-composer.json van de winkel: exact 0.1.6 laat de opdracht update geen nieuwere release kiezen. Wijzig dit bewust, bijvoorbeeld via composer require ...:NOWA-WERSJA --with-all-dependencies.

Een update vervangt de actieve publicatie niet door een nieuw palet. Kies na fabriekswijzigingen opnieuw een kant-en-klare set en publiceer deze. Opgeslagen eigen concepten behouden hun eigen waarden.

Problemen bij installatie

• Pakket is niet beschikbaar: controleer de beschikbaarheid van de release, repositories en Composer-autorisatie.
• Menu ontbreekt: controleer de activering van Kowal_Base, rolrechten en configuratiecache; ververs het paneel.
• Catalogusconflict: voer php bin/magento kowal:hyva-colors:catalog:sync --dry-run uit. Vergelijk gewijzigde definities vóór synchronisatie; overschrijf eigen elementen niet handmatig.
• Interceptor-fout na oude versie: zorg dat Composer het gecorrigeerde pakket heeft geïnstalleerd en bouw de gegenereerde code opnieuw op binnen het standaard deploymentproces.
• Kleuren veranderen niet: controleer historie, cron, actief thema, CSS in media en cachepropagatie.

Het resetten van kleuren gebeurt in het paneel. Het vereist geen deïnstallatie van de module of het verwijderen van tabellen. Exporteer vóór het uitschakelen of verwijderen van de module de benodigde sets en maak een databaseback-up volgens de onderhoudsprocedure van de winkel.