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
Product Labels — Hyvä Compatibility
Wimakeit Product Label renders its badges through Magento's own product image block, which means most of a Hyvä storefront already works without any extra module: category listings, search results, product widgets, related and cross-sell blocks, the comparison list, the wishlist and the cart page all display labels out of the box.
Two surfaces are built differently in Hyvä, and that is what this compatibility layer exists for. It adds them without forking a single Hyvä template, so a Hyvä upgrade never turns into a merge conflict.
Who it's for
- Merchants running a Hyvä storefront who want labels on the product page gallery and in
- Integrators who want to restyle the badges with Tailwind utilities in their own theme
- Teams that upgrade Hyvä regularly and refuse to carry forked core templates
the mini-cart, not only in the listing
Key benefits
- Product page gallery covered — Hyvä renders its gallery images as plain markup that
- No template override — because that container is a documented Hyvä extension point,
- Mini-cart drawer support — Hyvä's Alpine drawer reads its product image from
- Optional badge on every gallery image and thumbnail — off by default, because the
- Tailwind sources registered automatically — running
hyva:config:generateadds both - Graceful degradation — the base module ships a complete, framework-free stylesheet,
- No business logic — everything about matching, indexing and rendering stays in the
- Same server-side rendering — no JavaScript is added, no layout shift is introduced,
- Zero configuration — install, enable, regenerate the Hyvä config, rebuild the CSS.
never reaches Magento's image block. This module anchors the label overlay into Hyvä's own gallery.additional container instead, which sits inside the gallery's positioned wrapper exactly where a badge belongs.
nothing is forked. A Hyvä minor release cannot break the integration, and there is no copied template to re-sync.
customer section data rather than from a rendered block, so the labels travel with that payload and reinforce the discount at the moment the shopper is closest to buying.
product page label already floats over whichever image is showing and thumbnails are small enough that a badge is easily more clutter than signal. Turning either on copies the label already rendered above, so nothing is computed twice.
this module and the base module to the theme's Tailwind scan, so the wm-* classes are never purged and can be restyled with utilities.
so removing this layer leaves the labels rendering correctly everywhere else rather than breaking the storefront.
base module. This package holds a layout instruction, an observer and a stylesheet.
and the Full Page Cache behaviour is unchanged.
Every setting stays in the base module.
Compatibility
- Magento 2.4.x / Mage-OS 2.x and 3.x equivalents
- PHP 8.1, 8.2, 8.3, 8.4, 8.5
- Requires
wimakeit/module-product-label1.0 or later - Requires
hyva-themes/magento2-theme-module1.0 or later - Tested against the Hyvä default theme 1.5 with Tailwind 4
Install this module via Composer. Make sure your auth.json is configured with your Wimakeit credentials.
$ 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.
- Version
- v1.2.0
- Support
- 12 months
- Last updated
- Aug 25, 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ä
- Compatible
- Package
-
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.
Found a bug? Tell us about it.
A short form opens in a new tab — the module name and your language are already filled in. Share what you tried, what went wrong, and we will get back to you within one business day.
Report a bug for Product Label HyvaNeed help?
Our team is available to assist with integration.