Kowal Mega Menu — automatyczne megamenu dla Magento 2
25,00 € 25,00 €
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.
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 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ä.
Sie öffnen das Modul über kowal.store → Modules → Hyva Colors. Die Konfiguration erfolgt in seinen drei Ansichten und nicht in einem separaten Bereich Stores → Configuration.
Der Administrator vergibt Berechtigungen unter System → Permissions → User Roles. Weisen Sie den Rollen die passenden übergeordneten Kowal-Menüressourcen und Hyva Colors-Ressourcen zu:
| Ressource | Verwendung |
|---|---|
| View colors and history | Anzeigen von Sets und Verlauf |
| Edit presets | Erstellen, Speichern, Klonen, Löschen eigener Sets und Zurücksetzen von System-Sets |
| Add custom elements | Hinzufügen von Elementen zum Katalog |
| Import and export presets | Übertragen von Sets per JSON |
| Publish and restore colors | Veröffentlichung, Zurücksetzen des Erscheinungsbilds, Wiederherstellen und erneutes Ausführen von Veröffentlichungen |
Ein Import, der neue Katalogdefinitionen enthält, erfordert zusätzlich die Berechtigung zum Hinzufügen von Elementen. Nach einer Rollenänderung kann eine erneute Anmeldung des Benutzers erforderlich sein.
Bei der Veröffentlichung wählen Sie einen aktiven Store View. Das Modul prüft das zugewiesene Theme: Das aktuelle Profil unterstützt genau Hyva/default mit Default Theme 1.5.2–1.5.x. Weisen Sie kein anderes Theme nur zu, um die Validierung zu umgehen — Child-Themes benötigen eine separate Vorbereitung der Mappings.
Ein Set ist ein wiederverwendbarer Entwurf. Sie können es separat für mehrere Views veröffentlichen. In dieser Version gibt es keine vererbte Konfiguration auf Ebene default/website/store.
Die fertigen Definitionen umfassen sieben Paletten und ein leeres natives Set. Ihre gespeicherten Kopien sind unter „Meine Sets“ verfügbar. Am einfachsten erstellen Sie eigene Sets auf deren Grundlage — so bleiben die Originale als Referenz erhalten.
| Set | Charakter |
|---|---|
| Blau, Grün, Violett, Orange, Graphit | Führender Akzent und passende Farben der unterstützten Elemente |
| Schwarz | Dunkler Header, weißer Inhalt und heller Warenkorb-Zähler; die übrigen Flächen bleiben hell |
| Hell / Weiß | Native Hintergründe, ausgeblendete unterstützte Rahmen und graue Rahmen bei Hover |
| Nativ — ohne Überschreibung | Kein Farb-CSS des Moduls; das Erscheinungsbild ergibt sich aus dem aktiven Theme |
Der Editor unterteilt den Katalog in Abschnitte: Global, Header, Buttons, Product cards sowie Catalog and product page. Die Namen können auf Englisch bleiben. Der Startkatalog enthält 34 Elemente und 99 Mappings. Ein einzelnes Element kann separate Einträge für Hintergrund, Text, Rahmen und Interaktionszustände haben.
Verfügbare Möglichkeiten zum Festlegen von Werten:
| Modus im Admin-Panel | Wirkung |
|---|---|
| Eigene Farbe | Explizite Farbe, z. B. #171717, #ffffff, #11223380 |
| Farbe aus Palette | Verweis auf ein Token, z. B. brand |
| Nativer Stil | Entfernen der Überschreibung der jeweiligen Eigenschaft; es gilt der Theme-Stil |
| Ohne Überschreibung | Kein Wert auf dieser Ebene; in einem einzelnen Entwurf bleibt der Theme-Stil erhalten |
native fügt kein CSS inherit ein. Der Wert transparent ist eine explizite transparente Farbe und keine Rückkehr zum Theme. Sie können auch currentColor verwenden. Beliebige CSS-Funktionen wie rgb() oder var() werden in Farbfeldern nicht akzeptiert.
Speichern Sie den Entwurf, bevor Sie den Abschnitt oder die Editorseite wechseln. Das Speichern veröffentlicht keine Änderungen.
In „Palette — erweiterte Einstellungen (JSON)“ werden benannte Farben gespeichert. Beispiel eines Fragments:
{ 'brand': {'mode': 'color', 'value': '#1d4ed8'}, 'on-brand': {'mode': 'color', 'value': '#ffffff'}}Wählen Sie in der Elementzeile „Farbe aus Palette“ und geben Sie brand ein. Eine Änderung des Tokens aktualisiert bei der nächsten Veröffentlichung alle Werte, die darauf verweisen. Wenn Sie ein fertiges Set bearbeiten, behalten Sie die übrigen vorhandenen Tokens bei — das Ersetzen des gesamten JSON durch das obige Fragment kann ungelöste Verweise hinterlassen. Zyklen und fehlende Tokens werden abgelehnt.
Dies erfordert keine Änderung der Moduldateien, setzt aber voraus, dass der richtige CSS-Selektor ermittelt wird. Das Modul verfügt nicht über einen visuellen Element-Inspector.
#promo-banner, der im Shop existiert.background-color, color, border-color.normal und hover, und fügen Sie anschließend das Element hinzu.Die Definition gelangt in den gemeinsamen Katalog; allein ihr Hinzufügen legt nicht die Farben in allen Sets fest. Der Selektor sollte möglichst präzise sein. In dieser Version werden Selektorlisten, :has() und beliebige CSS-Deklarationen nicht unterstützt. Das Hinzufügen eines Elements erstellt dessen HTML im Shop nicht. Eine Bearbeitung bestehender Selektoren im Admin-Panel und eine Archivierung von Elementen gibt es noch nicht.
Die Veröffentlichung hängt von Cron, beschreibbaren Medien und Cache ab. Das CSS-Stylesheet wird vor der Aktivierung generiert und anschließend statisch ausgeliefert. Das Modul fügt dem normalen Storefront kein farbbezogenes JavaScript hinzu. Das bedeutet keine Garantie für ein konkretes Performance-Ergebnis — Messungen sollten im Zielshop durchgeführt werden.
Bei Varnish prüfen Sie den Zugriff auf die Purge-Server. Bei CDN und mehreren Knoten prüfen Sie die HTML-Propagierung sowie die Verfügbarkeit der Stylesheets. Deployment-Details enthält die Installationsanleitung.
Anleitung für Version 0.1.6. Führen Sie die Befehle im Magento-Stammverzeichnis als Deployment-Benutzer im Rahmen des standardmäßigen Deployment-Prozesses des Shops aus. Prüfen Sie die Installation zuerst in einer Testumgebung.
| Komponente | Anforderung des aktuellen Pakets |
|---|---|
| PHP | 8.3.x, 8.4.x oder 8.5.x; Erweiterungen JSON und zlib |
| Magento Framework | ^103.0.9; Referenzumgebung Magento 2.4.9 |
| Hyvä Theme Module | ~1.5.2 |
| Aktives Veröffentlichungstheme | Genau Hyva/default; Default Theme 1.5.2–1.5.x |
| Kowal Base | ^1.1.7 |
| Dienste | Funktionierender Magento-Cron, beschreibbare Medien und korrekt konfigurierter Cache |
Die vollständigen Abhängigkeiten werden in composer.json festgelegt. Die Anforderungen der Abhängigkeiten stellen keine Erklärung dar, dass alle Versionskombinationen getestet wurden. Ein Child-Theme wird derzeit von der Veröffentlichungsvalidierung abgelehnt, auch wenn es von Hyvä erbt.
Konfigurieren Sie das Composer-Repository, das kowal/module-hyva-colors und kowal/base bereitstellt, gemäß den vom Anbieter erhaltenen Daten. Zusätzlich ist ein berechtigter Zugriff auf das Hyvä-Repository erforderlich. Die Repository-Adresse und die Art der Autorisierung hängen vom bereitgestellten Zugriff ab; diese Anleitung setzt keine öffentliche Verfügbarkeit des Pakets voraus.
Beispielhaftes Konfigurationsschema — ersetzen Sie die Adresse durch die tatsächliche Adresse des Composer-Repositorys:
composer config repositories.kowal composer 'https://ADRES-REPOZYTORIUM-COMPOSER'Speichern Sie Zugangsdaten außerhalb des Projekt-Repositorys, z. B. in einer privaten auth.json oder in der CI-Konfiguration. Kopieren Sie sie nicht in die Dokumentation.
Nachdem Release 0.1.6 im Repository bereitgestellt wurde:
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:diagnoseDie angegebenen Locales sind ein Beispiel — deployen Sie die Sprachen, die vom Shop und vom Admin-Panel verwendet werden. Verbinden Sie die Generierung von DI und Assets mit dem standardmäßigen Deployment-Prozess, anstatt sie während der Bedienung des Traffics im aktiven Produktionsverzeichnis auszuführen.
Die Installation erstellt ein Verzeichnis und Start-Sets. Sie veröffentlicht keine Farben und ändert nicht das Erscheinungsbild des Shops. Der Befehl diagnose prüft das Paketverzeichnis und meldet den Funktionsumfang; er ist kein vollständiger Umgebungstest.
Das Modul verwendet den Task kowal_hyva_colors_publish in der Cron-Gruppe default, der jede Minute geplant wird. Auf dem Server muss der standardmäßige Magento-Cron laufen. Eine Ausführung verarbeitet maximal 10 Aufgaben; die Veröffentlichung muss nicht sofort erfolgen.
Manuelle Verarbeitung der Warteschlange zu Diagnosezwecken:
php bin/magento kowal:hyva-colors:publication:processPrüfen Sie den Status einer konkreten Aufgabe in „Änderungsverlauf“ — die erfolgreiche Ausführung des Befehls bedeutet nicht, dass jede Aufgabe erfolgreich abgeschlossen wurde.
Stylesheets werden unter pub/media/kowal/hyva-colors/ gespeichert. Stellen Sie sicher, dass Schreibzugriff sowie Lesezugriff per HTTP möglich sind. Bei mehreren Knoten müssen die Medien gemeinsam genutzt werden. Für diese unveränderlichen Dateien können Content-Type: text/css, Komprimierung und Cache-Control: public, max-age=31536000, immutable konfiguriert werden. Das Modul richtet keine Server- oder CDN-Konfiguration ein.
Nachdem ein neues Release bereitgestellt wurde:
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_pagePrüfen Sie die Versionsbeschränkung in der Hauptdatei composer.json des Shops: Ein exaktes 0.1.6 erlaubt dem Befehl update nicht, ein neueres Release auszuwählen. Ändern Sie sie bewusst, z. B. mit composer require ...:NOWA-WERSJA --with-all-dependencies.
Die Aktualisierung ersetzt die aktive Veröffentlichung nicht durch eine neue Palette. Wählen Sie nach Änderungen an den Werkseinstellungen das fertige Set erneut aus und veröffentlichen Sie es. Gespeicherte eigene Entwürfe behalten ihre eigenen Werte.
Kowal_Base, Rollenrechte und den Konfigurations-Cache; aktualisieren Sie das Admin-Panel.php bin/magento kowal:hyva-colors:catalog:sync --dry-run aus. Vergleichen Sie geänderte Definitionen vor der Synchronisierung; überschreiben Sie eigene Elemente nicht manuell.Der Farb-Reset wird im Admin-Panel durchgeführt. Er erfordert weder die Deinstallation des Moduls noch das Löschen von Tabellen. Exportieren Sie vor dem Deaktivieren oder Entfernen des Moduls die benötigten Sets und erstellen Sie gemäß dem Wartungsprozess des Shops ein Backup der Datenbank.