ospo / theme-frontend-hyva
Kind-Theme des Hyvä Default Themes mit eigenem Tailwind-Bau, damit Blog, Widgets und andere Hyvä-Module gestaltet sind
Package info
codeberg.org/OSPO/magento2-theme-frontend-hyva
Type:magento2-theme
pkg:composer/ospo/theme-frontend-hyva
Requires
- php: ~8.3.0||~8.4.0
- hyva-themes/magento2-default-theme: ^1.5.3
- magento/framework: *
Requires (Dev)
None
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
Kind-Theme des Hyvä Default Themes für Mage-OS und Magento Open Source, mit eigenem Tailwind-Bau.
Entstanden im OSPO-Projekt. Das Hyvä-Theme liefert ein fertig gebautes styles.css mit, in dem nur die Tailwind-Klassen des Themes selbst stehen. Module, die ihre Stile als Tailwind-Quelle mitbringen, sind damit nicht oder nur teilweise gestaltet. Das betrifft zum Beispiel mage-os/module-blog-hyva (der Blog erscheint ungestaltet) und mage-os/module-widgetkit. Dieses Theme baut das CSS neu und nimmt dabei alle Module aus app/etc/hyva-themes.json mit.
- Aussehen: Das Theme überschreibt keine Vorlagen. Der Shop sieht aus wie mit dem Hyvä Default Theme.
- Eigene Anpassungen: liegen in
web/tailwind/ospo/. Bisherblog.css: Der Blog nutzt Schrift und Textfarben des Shops statt der eigenen Serifenschrift des Blog-Moduls. - Ohne Bau: Solange
web/css/styles.cssin diesem Theme fehlt, nimmt Magento das CSS des Eltern-Themes. Der Shop funktioniert dann wie vorher, Blog und Widgets bleiben ungestaltet.
Installation
composer require ospo/theme-frontend-hyva
bin/magento setup:upgrade
Danach das CSS bauen (siehe unten), die statischen Dateien ausliefern und das Theme „OSPO Hyvä“ unter Inhalt -> Gestaltung -> Konfiguration wählen.
CSS bauen
Nötig nach der Installation, nach jedem neuen Hyvä-Modul und nach jedem Update von Hyvä oder diesem Theme, jeweils vor setup:static-content:deploy. Gebraucht wird Node ab Version 20.
bin/magento hyva:config:generate
cd vendor/ospo/theme-frontend-hyva/web/tailwind
npm ci
npm run build
Ohne Node auf dem Server geht es in einem Container, vom Magento-Verzeichnis aus:
docker run --rm -u "$(id -u):$(id -g)" -e HOME=/tmp -v "$PWD":/app \
-w /app/vendor/ospo/theme-frontend-hyva/web/tailwind node:22-bookworm-slim \
sh -c "npm ci && npm run build"
Das Ergebnis steht in web/css/styles.css. Weil die Datei im Paketverzeichnis liegt, überschreibt eine Neuinstallation des Pakets sie. Der Bau gehört deshalb fest in den Ablauf jedes Updates.
Eigenes Theme darauf aufbauen
- In
theme.xmldes eigenen ThemesOspo/hyvaals Eltern-Theme eintragen. - Nicht in diesem Paket ändern, Änderungen gehen beim nächsten Update verloren.
- Für eigene Tailwind-Klassen braucht das eigene Theme einen eigenen Ordner
web/tailwind(Kopie aus diesem Paket). In dessenhyva.config.jsongehören untertailwind.includebeide Eltern-Themes:vendor/hyva-themes/magento2-default-themeundvendor/ospo/theme-frontend-hyva. - Hat das eigene Theme kein eigenes
web/css/styles.css, nimmt Magento das gebaute CSS dieses Themes.
Herkunft der Dateien
web/tailwind ist eine Kopie aus hyva-themes/magento2-default-theme 1.5.3 (OSL-3.0 / AFL-3.0), ergänzt um hyva.config.json mit dem Eltern-Theme, den Ordner ospo/ und eine Zeile am Ende von tailwind-source.css. Nach einem Hyvä-Update prüfen, ob sich der Ordner im Hyvä-Theme geändert hat, und die Kopie nachziehen.
Lizenz: OSL-3.0, wie Magento Open Source, Mage-OS und das Hyvä Default Theme.