Product Label Hyva
v1.2.0
Product Label Hyva
- Mises à jour et support inclus pendant 12 mois
- Clé de licence livrée immédiatement par email
- Garantie satisfait ou remboursé 30 jours
- Documentation complète incluse
- Compatible avec les thèmes Hyvä
- Installation prête pour Composer
Labels produit — compatibilité Hyvä
Wimakeit Product Label rend ses badges via le bloc image produit natif de Magento, ce qui signifie que l'essentiel d'une boutique Hyvä fonctionne déjà sans module supplémentaire : listes de catégorie, résultats de recherche, widgets produit, blocs de produits associés et de ventes croisées, comparateur, liste d'envies et page panier affichent les labels sans configuration.
Deux surfaces sont construites différemment dans Hyvä, et c'est la raison d'être de cette couche de compatibilité. Elle les couvre sans dupliquer un seul template Hyvä, donc une montée de version Hyvä ne se transforme jamais en conflit de fusion.
À qui ça s'adresse
- Marchands sur Hyvä qui veulent les labels sur la galerie de la page produit et dans le
- Intégrateurs qui souhaitent restyler les badges avec des utilitaires Tailwind dans leur
- Équipes qui mettent Hyvä à jour régulièrement et refusent de maintenir des templates
mini-panier, pas seulement dans la liste
propre thème
cœur dupliqués
Bénéfices clés
- Galerie de la page produit couverte — Hyvä rend ses images de galerie dans un
- Aucun override de template — ce conteneur étant un point d'extension documenté de
- Prise en charge du mini-panier — le tiroir Alpine de Hyvä lit l'image produit depuis
- Badge optionnel sur chaque image de la galerie et sur les vignettes — désactivé par
- Sources Tailwind enregistrées automatiquement — l'exécution de
- Dégradation propre — le module de base fournit une feuille de style complète et sans
- Aucune logique métier — la correspondance, l'indexation et le rendu restent
- Même rendu côté serveur — aucun JavaScript ajouté, aucun décalage de mise en page
- Zéro configuration — installer, activer, régénérer la configuration Hyvä,
balisage qui ne passe jamais par le bloc image de Magento. Ce module ancre le calque de labels dans le conteneur gallery.additional de Hyvä, situé à l'intérieur du wrapper positionné de la galerie, exactement là où un badge doit apparaître.
Hyvä, rien n'est dupliqué. Une version mineure de Hyvä ne peut pas casser l'intégration, et il n'y a aucun template copié à resynchroniser.
les données de section client et non depuis un bloc rendu : les labels voyagent avec ces données et rappellent la remise au moment où le client est le plus près d'acheter.
défaut, car le label de la page produit flotte déjà au-dessus de l'image affichée et une vignette est assez petite pour qu'un badge y soit plus encombrant qu'utile. Activer l'un ou l'autre recopie le label déjà rendu, donc rien n'est recalculé.
hyva:config:generate ajoute ce module et le module de base au scan Tailwind du thème, donc les classes wm-* ne sont jamais purgées et restent restylables.
framework : retirer cette couche laisse les labels s'afficher correctement partout ailleurs plutôt que de casser la boutique.
intégralement dans le module de base. Ce paquet contient une instruction de layout, un observer et une feuille de style.
introduit, comportement du Full Page Cache inchangé.
recompiler le CSS. Tous les réglages restent dans le module de base.
Compatibilité
- Magento 2.4.x / équivalents Mage-OS 2.x et 3.x
- PHP 8.1, 8.2, 8.3, 8.4, 8.5
- Nécessite
wimakeit/module-product-label1.0 ou supérieur - Nécessite
hyva-themes/magento2-theme-module1.0 ou supérieur - Testé avec le thème Hyvä par défaut 1.5 et Tailwind 4
Installez ce module via Composer. Assurez-vous que votre auth.json est configuré avec vos identifiants Wimakeit.
$ 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 mois
- Dernière mise à jour
- 25 août 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
Vérifier la compatibilité
Indiquez votre stack pour vérifier la compatibilité du module.
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.
Vous avez trouvé un bug ? Faites-nous-en part.
Un court formulaire s'ouvre dans un nouvel onglet — le nom du module et votre langue sont déjà pré-remplis. Décrivez ce que vous avez tenté, ce qui n'a pas fonctionné, et nous vous répondrons sous un jour ouvré.
Signaler un bug pour Product Label HyvaBesoin d'aide ?
Notre équipe est disponible pour vous accompagner dans l'intégration.