Product Label Hyva
v1.2.0
Product Label Hyva
- Updates and support included for 12 months
- License key delivered immediately by email
- 30-day money-back guarantee
- Full documentation included
- Compatible with Hyvä themes
- Composer-ready installation
Productlabels — Hyvä-compatibiliteit
Wimakeit Product Label rendert zijn badges via het standaard productafbeeldingsblok van Magento, waardoor het grootste deel van een Hyvä-winkel al werkt zonder extra module: categorieoverzichten, zoekresultaten, productwidgets, gerelateerde en cross-sell blokken, de vergelijkingslijst, de verlanglijst en de winkelwagenpagina tonen de labels meteen.
Twee plaatsen zijn in Hyvä anders opgebouwd, en daarvoor bestaat deze compatibiliteitslaag. Ze worden gedekt zonder ook maar één Hyvä-template te kopiëren, zodat een Hyvä-upgrade nooit in een merge-conflict verandert.
Voor wie
- Verkopers op Hyvä die labels willen op de galerij van de productpagina en in de
- Integrators die de badges met Tailwind-utilities in hun eigen thema willen herstijlen
- Teams die Hyvä regelmatig bijwerken en geen gekopieerde core-templates willen
mini-winkelwagen, niet alleen in het overzicht
onderhouden
Belangrijkste voordelen
- Galerij van de productpagina gedekt — Hyvä rendert zijn galerijafbeeldingen als
- Geen template-override — omdat die container een gedocumenteerd Hyvä-uitbreidingspunt
- Ondersteuning voor de mini-winkelwagen — de Alpine-drawer van Hyvä leest de
- Optionele badge op elke galerijafbeelding en op de miniaturen — standaard uit, omdat
- Tailwind-bronnen automatisch geregistreerd —
hyva:config:generatevoegt zowel deze - Nette degradatie — de basismodule levert een volledige, framework-vrije stylesheet,
- Geen bedrijfslogica — matching, indexering en weergave blijven volledig in de
- Dezelfde server-side weergave — geen JavaScript toegevoegd, geen layout shift, en
- Nul configuratie — installeren, inschakelen, de Hyvä-configuratie opnieuw genereren,
gewone markup die nooit langs het afbeeldingsblok van Magento komt. Deze module verankert de labellaag in de eigen gallery.additional container van Hyvä, binnen de gepositioneerde wrapper van de galerij, precies waar een badge hoort.
is, wordt er niets gekopieerd. Een kleine Hyvä-release kan de integratie niet breken en er is geen gekopieerde template om opnieuw te synchroniseren.
productafbeelding uit de customer section data in plaats van uit een gerenderd blok, dus de labels reizen met die gegevens mee en herinneren aan de korting op het moment dat de klant het dichtst bij een aankoop is.
het label op de productpagina al boven de getoonde afbeelding zweeft en een miniatuur klein genoeg is dat een badge er eerder rommelig dan nuttig oogt. Inschakelen kopieert het reeds gerenderde label, dus er wordt niets opnieuw berekend.
module als de basismodule toe aan de Tailwind-scan van het thema, zodat de wm-* klassen nooit worden weggehaald en herstijlbaar blijven.
dus deze laag verwijderen laat de labels overal elders correct werken in plaats van de winkel te breken.
basismodule. Dit pakket bevat een layout-instructie, een observer en een stylesheet.
het gedrag van de Full Page Cache blijft ongewijzigd.
de CSS herbouwen. Alle instellingen blijven in de basismodule.
Compatibiliteit
- Magento 2.4.x / gelijkwaardige Mage-OS 2.x en 3.x
- PHP 8.1, 8.2, 8.3, 8.4, 8.5
- Vereist
wimakeit/module-product-label1.0 of hoger - Vereist
hyva-themes/magento2-theme-module1.0 of hoger - Getest met het Hyvä standaardthema 1.5 en Tailwind 4
Installeer deze module via Composer. Zorg ervoor dat uw auth.json is geconfigureerd met uw Wimakeit-inloggegevens.
$ composer require wimakeit/module-product-label-hyva:^1.2.0
$ bin/magento setup:upgrade
$ bin/magento setup:di:compileInstallation notes
The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.
Required dependencies
This module requires wimakeit/module-product-label 1.0 or later and hyva-themes/magento2-theme-module 1.0 or later. Install and configure the base module first: every setting, every label and every condition lives there.
Two extra steps after setup:upgrade
Unlike most modules, this one is not finished once setup:upgrade has run. Hyvä compiles its CSS ahead of time, so the module has to be registered with that build and the build has to be re-run:
bin/magento hyva:config:generate
cd app/design/frontend/<Vendor>/<theme>/web/tailwind
npm run build
The first command appends both Wimakeit_ProductLabelHyva and Wimakeit_ProductLabel to app/etc/hyva-themes.json. The second recompiles the theme stylesheet with the wm-* classes included. Skipping either leaves the labels rendered but unstyled.
What it changes on the storefront
| Surface | Handled by | Default |
|---|---|---|
| Category listing, search, widgets, related, cross-sell, comparison, wishlist, cart page | the base module, no Hyvä-specific code needed | on |
| Product page, main image | this module, via Hyvä's gallery.additional container | on |
| Alpine mini-cart drawer | this module, reading the labels from customer section data | on |
| Every image of the product gallery | this module, copying the label already rendered above | off |
| Product gallery thumbnails | this module, copying the label already rendered above | off |
Configuration
Three settings are added to the base module's section, under Stores → Configuration → WiMakeIT → Product Labels → Hyvä Storefront:
| Setting | Default |
|---|---|
| Show labels in the mini-cart | Yes |
| Repeat the label on every gallery image | No — the product page label already floats over whichever image is showing, so this mainly changes whether the badge scrolls away with each image or stays put |
| Show labels on the gallery thumbnails | No — thumbnails run around 60px, where a badge is easily more clutter than signal |
There is no ACL resource and no cron job. Every other setting lives in the base module.
A note on how the two extras work
Hyvä renders the gallery slides in a plain PHP loop and the mini-cart rows in the browser, and neither offers a per-item extension point. Rather than fork those templates, this module attaches to the nearest documented container and moves or copies markup the base module already rendered.
That means the label text, shapes and colours are still produced once, on the server, by the same renderer as every other surface — nothing is recomputed in the browser. It also means these two surfaces degrade quietly: if a future Hyvä release restructures the drawer or the gallery, the badges stop appearing there instead of breaking the page, and every other surface is unaffected.
Upgrading Hyvä
This module deliberately overrides no Hyvä template. It attaches to gallery.additional, a container Hyvä declares in its own catalog_product_view.xml, so a Hyvä minor or patch release cannot leave a stale forked template behind. After a Hyvä upgrade, re-run hyva:config:generate and the Tailwind build as you would for any other module.
Removing it
Disabling this module leaves labels working everywhere the base module covers on its own. Only the product page gallery and the mini-cart lose their badges, and the wm-* Tailwind classes drop out of the next theme build. Nothing breaks.
- Versie
- v1.2.0
- Ondersteuning
- 12 maanden
- Last updated
- 25 aug. 2026
- Magento
- Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
- PHP
- PHP 8.1 PHP 8.2 PHP 8.3
- Hyvä
- Compatibel
- Pakket
-
wimakeit/module-product-label-hyva
Compatibility checker
Pick your stack to see if this module fits.
Changelog
Categories: Security, Feature, Fix, Perf, Admin, Deps.
[1.2.0] - 2026-08-18
Fix
- Une étiquette posée sur une vignette de listing pouvait faire disparaître la photo du produit.
- Les tailles xs à xl ne se distinguaient presque pas sur les formes pilule et texte seul.
- Les étiquettes ne collaient plus au bord de l'image, sauf les rubans de coin pour lesquels c'est voulu.
Deps
- Réclame désormais le module de base en version 1.2 ou supérieure.
[1.1.0] - 2026-08-17
Feature
- Labels now appear in the Hyvä mini-cart drawer, reinforcing the discount at the moment the shopper is closest to buying. On by default.
- Optional labels on every image of the product gallery, and on the gallery thumbnails. Both are off by default, because the product page badge already floats over whichever image is showing and thumbnails are small enough that a badge is easily more clutter than signal.
- Three new settings under Stores, Configuration, WiMakeIT, Product Labels, Hyvä Storefront.
Fix
- Links inside a repeated label are turned into plain text. Gallery thumbnails and mini-cart thumbnails are themselves links, and a link inside a link is invalid and traps keyboard users.
- The mini-cart badge now sits inside its thumbnail instead of overflowing beside it.
[1.0.0] - 2026-08-17
Feature
- Product page gallery labels on Hyvä, anchored into Hyvä's own
gallery.additionalcontainer rather than through a forked template, so a Hyvä upgrade cannot break the integration. - Mini-cart drawer labels, delivered through customer section data because Hyvä's Alpine drawer never renders a product image block.
- Both this module and the base module are registered with Hyvä's Tailwind compilation, so the
wm-*classes survive the purge and integrators can restyle badges with utilities in their own theme.
Deps
- Requires
wimakeit/module-product-label1.0 or later andhyva-themes/magento2-theme-module1.0 or later. Tested against the Hyvä default theme 1.5 with Tailwind 4.
Een bug gevonden? Laat het ons weten.
Een kort formulier opent in een nieuw tabblad — de modulenaam en uw taal zijn al ingevuld. Beschrijf wat u probeerde, wat misging, en wij komen binnen één werkdag bij u terug.
Een bug melden voor Product Label HyvaHulp nodig?
Ons team helpt u graag met de integratie.