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 ervan, niet in een aparte sectie Stores → Configuration.

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

Een import die nieuwe catalogusdefinities bevat, vereist ook het recht om elementen toe te voegen. Na een wijziging van de rol kan het nodig zijn dat de gebruiker opnieuw inlogt.

Shopbereik

Bij publicatie kiest u één actieve 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 vereisen een afzonderlijke voorbereiding van mappings.

Een set is een herbruikbaar concept. U kunt deze afzonderlijk voor meerdere weergaven publiceren. In deze versie is er geen geërfde configuratie op default/website/store-niveau.

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 startcatalogus bevat 34 elementen en 99 mappings. Eén element kan afzonderlijke 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 de sectie of pagina van de editor wijzigt. Opslaan publiceert de wijzigingen niet.

Gemeenschappelijke kleuren: tokens

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

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

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

Elementen en secties toevoegen

Dit vereist geen wijziging van modulebestanden, maar wel het bepalen 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 shop 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 gemeenschappelijke catalogus terecht; alleen het toevoegen ervan stelt geen kleuren in alle sets in. De selector moet zo precies mogelijk zijn. In deze versie worden selectorlijsten, :has() en willekeurige CSS-declaraties niet ondersteund. Het toevoegen van een element maakt geen HTML ervan in de shop aan. Er is nog geen bewerking van bestaande selectors en archivering van elementen via het paneel.

Infrastructuurconfiguratie

Publicatie is afhankelijk van cron, schrijfbare media en cache. Het CSS-bestand wordt vóór activering gegenereerd en vervolgens statisch geserveerd. De module voegt geen kleur-JavaScript toe aan de reguliere storefront. Dit betekent geen garantie voor een specifiek prestatieresultaat — metingen moeten in de doelshop 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. De vereisten van afhankelijkheden vormen geen verklaring dat alle versiecombinaties zijn getest. Een child theme wordt momenteel door de publicatievalidatie geweigerd, 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. Ook is geautoriseerde toegang tot de Hyvä-repository nodig. Het repositoryadres en de autorisatiemethode zijn afhankelijk van de geleverde toegang; deze instructie gaat niet uit van publieke beschikbaarheid van het pakket.

Voorbeeldschema voor configuratie — vervang het adres door het werkelijke adres van de Composer-repository:

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

Bewaar authenticatiegegevens buiten de projectrepository, bijvoorbeeld in een privé auth.json of CI-configuratie. Kopieer ze niet naar de 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 tijdens de verwerking van verkeer op een actieve productiecatalogus.

De installatie maakt de catalogus en initiële sets aan. Er worden geen kleuren gepubliceerd en het uiterlijk van de winkel wordt niet gewijzigd. De opdracht diagnose controleert de pakketcatalogus 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 diagnostiek:

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

Controleer de status van een specifieke taak in Wijzigingsgeschiedenis — het succesvol uitvoeren van de opdracht betekent niet dat elke taak succesvol is afgerond.

Stylesheets worden opgeslagen in pub/media/kowal/hyva-colors//.css. Zorg voor schrijfrechten en leesbaarheid via HTTP. Bij meerdere nodes moeten media gedeeld zijn. Voor deze onveranderlijke bestanden kunt u Content-Type: text/css, compressie en Cache-Control: public, max-age=31536000, immutable configureren. 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 drie pagina’s: Sets en publicatie, Mijn sets, Wijzigingsgeschiedenis.
3. Publiceer een palet op een test-store view en wacht tot de taak is voltooid.
4. Controleer de header, het account, de minicart, de categorie en het product op desktop en telefoon, ook 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: een exacte 0.1.6 staat de opdracht update niet toe een nieuwere release te 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.
• Geen menu: controleer de activatie van Kowal_Base, rolrechten en configuratiecache; vernieuw 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 ervoor dat Composer het gecorrigeerde pakket heeft geïnstalleerd en bouw de gegenereerde code opnieuw op binnen het standaard deploymentproces.
• Kleuren veranderen niet: controleer de geschiedenis, cron, het actieve thema, CSS in media en cachepropagatie.

Het resetten van kleuren gebeurt in het paneel. Hiervoor is het niet nodig de module te verwijderen of tabellen te wissen. Exporteer vóór het uitschakelen of verwijderen van de module de benodigde sets en maak een databaseback-up volgens de onderhoudsprocedure van de winkel.