Tax Switch Hyva

Gratuit
v1.1.8 Abonnement annuel Mis à jour le 5 juin 2026

Tax Switch Hyva

Édition Hyvä native de Tax Switch : bascule HT ↔ TTC instantanée, composant Alpine.js optimisé, zéro dépendance Luma, parfaitement intégrée à la stack Hyvä/Tailwind.
Gratuit Compatible Hyvä Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
Gratuit
Essayer la démo en ligne
  • Mises à jour et support inclus pendant 12 mois
  • Documentation complète incluse
  • Compatible avec les thèmes Hyvä
  • Installation prête pour Composer

Tax Switch — Hyvä

Le module compagnon Hyvä de wimakeit/module-tax-switch. Si vous faites tourner le module Tax Switch sur un storefront Hyvä, installez aussi celui-ci : il remplace les templates Luma (RequireJS + jQuery) par des composants Alpine.js et des price labels en vanilla JS, tout en réutilisant la même configuration admin, le même cookie et le même ViewModel.

Vous installez ce module en complément du module Tax Switch principal — jamais à sa place. Le module principal possède la configuration, la couche plugin et l'intégration FPC ; celui-ci possède le rendu compatible Hyvä.

À qui ça s'adresse

  • Boutiques sous Hyvä Themes qui ont besoin d'un switcher de display mode taxe (HT/TTC) sans réintroduire RequireJS dans leur bundle
  • Setups multi-frontend où Luma et Hyvä cohabitent et ont besoin d'un comportement tax-switch cohérent
  • Projets Hyvä qui veulent l'ensemble des features Tax Switch (visibility rules, styling, price labels, quatre styles d'affichage) sans écrire leurs propres composants Alpine.js

Bénéfices clés

  • Composants Alpine.js, pas de jQuery — les styles radio, toggle, segmented et dropdown sont réimplémentés avec x-data pour s'intégrer naturellement dans un bundle Hyvä.
  • Price labels en vanilla JS — labels HT/TTC auto-sizés à côté des prix, sans dépendance à RequireJS ou mage/cookies.
  • Réutilise la configuration du module principal — tous les réglages admin (visibility, styling, labels, customer groups, devices) vivent dans le module Tax Switch principal. Rien de neuf à apprendre ou configurer ici.
  • Retire les blocs Luma — supprime automatiquement les blocs originaux basés sur RequireJS depuis le layout, pour que les thèmes Hyvä ne les chargent pas par erreur.
  • Hook par variables CSS — surchargez les défauts depuis le CSS de votre thème Hyvä via un set propre de variables --wmi-tax-* (gap, bg, radius, font-size, border, couleurs actives).

Compatibilité

  • Magento 2.4.x / équivalent Mage-OS
  • PHP 8.1, 8.2, 8.3
  • Nécessite wimakeit/module-tax-switch 1.0 ou supérieur (ce module est un addon frontend, pas une logique de tax-switching autonome)
  • Nécessite le module de base Hyvä Themes officiel (hyva-themes/magento2-theme-module 1.0+)
  • Un thème de storefront basé sur Hyvä

Installez ce module via Composer. Assurez-vous que votre auth.json est configuré avec vos identifiants Wimakeit.

Terminal
$ composer require wimakeit/module-tax-switch-hyva:^1.1.8
$ bin/magento setup:upgrade
$ bin/magento setup:di:compile

Installation notes

The standard composer require + setup:upgrade + setup:di:compile flow applies. The points below cover what's specific to this module.

Required Wimakeit dependency

This module is a frontend addon for Hyvä. It cannot work on its own — you must install the main Tax Switch module alongside it:

PackageMinimumRole
wimakeit/module-tax-switch1.0owns the admin config, the plugin layer, the FPC integration and the ViewModel
wimakeit/module-tax-switch-hyvathis modulereplaces the Luma templates with Hyvä-compatible Alpine.js / vanilla-JS components

Required third-party dependency

PackageMinimum
hyva-themes/magento2-theme-module1.0

Your storefront must run on a Hyvä-based theme. If your store is on Luma, install only the main wimakeit/module-tax-switch and skip this one.

Configuration

There is no admin configuration specific to this module. All settings — enable/disable, default display mode, available modes, display style, visibility, customer groups, device targeting, price labels, styling (CSS variables) — live in the main module under Stores → Configuration → Wimakeit → Tax Switcher.

What this module changes

LayerLuma (main module)Hyvä (this module)
JS frameworkRequireJS + jQueryAlpine.js + vanilla JS
Initialisationdata-mage-initx-data / inline scripts
Cookie handlingmage/cookiesnative document.cookie
Template namespaceWimakeit_TaxSwitch::Wimakeit_TaxSwitchHyva::

The Hyvä module removes the original Luma blocks from the page (so they don't load on a Hyvä storefront) and registers Hyvä-compatible blocks reading the same configuration.

Customisation

To restyle the switcher from your Hyvä theme, override these CSS variables:

:root {
    --wmi-tax-gap: 0.75rem;
    --wmi-tax-bg: transparent;
    --wmi-tax-bg-hover: rgba(0,0,0,.05);
    --wmi-tax-radius: 4px;
    --wmi-tax-font-size: 0.8125rem;
    --wmi-tax-border: #ddd;
    --wmi-tax-active-bg: #333;
    --wmi-tax-active-color: #fff;
}

To override templates, copy them into your Hyvä theme:

app/design/frontend/<Vendor>/<Theme>/Wimakeit_TaxSwitchHyva/templates/
Version
v1.1.8
Licence
Abonnement annuel
Support
12 mois
Dernière mise à jour
5 juin 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-tax-switch-hyva

Vérifier la compatibilité

Indiquez votre stack pour vérifier la compatibilité du module.

Compatibilité 4

Oui. Tax Switch Hyva est testé sur Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce sur la même ligne, et Mage-OS 2.0+ — en PHP 8.1, 8.2 et 8.3. L'onglet « Spécifications » liste les combinaisons testées. Si votre stack y figure, l'installation est garantie. Wimakeit est une agence Magento certifiée Adobe basée à Presles, en Wallonie (entre Charleroi et Namur) — chaque module est validé sur la même matrice que celle livrée à nos clients enterprise en Belgique, France et Pays-Bas.
Oui — complètement. Tax Switch Hyva embarque un frontend natif compatible Hyvä (Tailwind + Alpine.js) et s'intègre avec Hyvä Checkout le cas échéant. Aucun module de compatibilité supplémentaire requis. Chaque module estampillé Hyvä est développé par la même équipe Wimakeit qui réalise les migrations Hyvä pour nos clients en production.
Hyvä Storefront (Tailwind + Alpine.js, rendu serveur) et Hyvä Checkout (React, headless au-dessus de Magento) sont deux packages distincts. Tax Switch Hyva embarque une compatibilité Hyvä Storefront native — son frontend est rendu via les templates Hyvä, sans fallback Luma. L'intégration Hyvä Checkout est livrée quand le module a un touchpoint d'étape checkout (input de paiement custom, case CGV, etc.) ; sinon le module tourne côté serveur sans customisation Hyvä Checkout nécessaire. Voir l'onglet Spécifications pour le scope Hyvä exact de ce module.
Oui. Tax Switch Hyva respecte le scope Magento standard (default / website / store / store_view). Chaque configuration est surchargeable par store view. Les libellés frontend utilisent les fichiers de traduction Magento standard — livrés en français, anglais et néerlandais d'origine. Les devises suivent la configuration Magento standard, sans câblage supplémentaire. Un store Magento Wimakeit type fait tourner un triplet fr_BE / nl_BE / en_GB depuis un seul back-office — Tax Switch Hyva est prêt pour ce setup B2B / international.

Tarification & licence 4

Tax Switch Hyva est offert gratuitement aux clients Wimakeit. La licence couvre 1 domaine production + 1 domaine staging/dev. Support premium, développement sur mesure et upgrades SLA disponibles sur demande — l'équipe Magento wallonne de Wimakeit (Presles, entre Charleroi et Namur) est certifiée Adobe Commerce depuis 2021.
Oui. Tax Switch Hyva dispose d'une démo en ligne sur demo.wimakeit.be/module-tax-switch-hyva où vous pouvez explorer l'admin et le frontend avec une installation réelle pré-remplie de données. Pour une évaluation plus longue, demandez une licence d'évaluation via notre formulaire de contact — l'évaluation couvre la même scope que la licence payante et se convertit en clé permanente à l'achat.
Aucun paiement à rembourser — Tax Switch Hyva est gratuit. S'il ne convient pas, désactivez simplement le module via bin/magento module:disable ; le nettoyage est automatique via le revert du setup patch.
Tax Switch Hyva est distribué sous licence commerciale propriétaire — pas MIT, pas GPL, pas open source. Le code PHP est livré dans vendor/wimakeit/ après composer require, donc vous pouvez le lire, l'auditer, et le patcher localement pour votre propre installation Magento. Vous ne pouvez PAS le redistribuer, le sous-licencier, le publier sur un registre Composer public, ou le revendre. 1 licence = 1 domaine production + 1 domaine staging/dev (voir les Conditions Générales pour l'EULA complet). Les modules Wimakeit ne sont PAS sur le packagist.org public — ils sont distribués exclusivement via le registre Composer privé packages.wimakeit.be.

Installation & mises à jour 6

Lancez composer require wimakeit/module-tax-switch-hyva:^1.1.7, puis bin/magento setup:upgrade, bin/magento setup:di:compile, et enfin bin/magento cache:flush. L'onglet « Installation » de cette page liste chaque étape de configuration (ACLs, crons, valeurs par défaut) — un déploiement prend quelques minutes, pas des heures. Besoin d'aide ? Wimakeit propose des prestations d'installation Magento depuis notre bureau wallon (Presles, entre Charleroi et Namur).
Étape 1 : récupérez un token sur packages.wimakeit.be → Mon compte → Tokens. Étape 2 : à la racine de votre projet, ajoutez à auth.json : {"http-basic": {"packages.wimakeit.be": {"username": "VOTRE-EMAIL", "password": "VOTRE-TOKEN"}}}. Étape 3 : enregistrez le repo : composer config repositories.wimakeit composer https://packages.wimakeit.be. Étape 4 : composer require wimakeit/module-tax-switch-hyva:^1.1.7. Dans les pipelines CI/CD, injectez COMPOSER_AUTH en variable d'environnement JSON pour éviter de commiter auth.json.
La plupart des marchands sont en ligne en 30 minutes : composer install (1-2 min) → setup:upgrade + di:compile (5-10 min selon la taille de la stack) → configuration admin (5-15 min en suivant l'onglet Installation) → smoke test sur un produit ou une commande. Comptez plus de temps si vous avez un thème custom qui override des templates similaires. L'équipe Wimakeit a livré ce module sur de nombreuses boutiques B2B et DTC en Belgique.
Tax Switch Hyva est conçu pour Magento 2.4.x / Mage-OS 2.0+ et n'a pas d'équivalent Magento 1. Lors d'une migration depuis Magento 1, l'équipe Wimakeit prend en charge l'audit, la migration de données et l'intégration de Tax Switch Hyva dans le nouveau back-office, dans le cadre d'un projet de migration Magento. Passer d'Adobe Commerce à Mage-OS est transparent pour Tax Switch Hyva : même composer require, même code module, même schéma de base — pas de fork à maintenir, pas de changement de licence.
Les mises à jour passent par votre dépendance composer (ce package exact), hébergée sur le registre Composer privé Wimakeit packages.wimakeit.be. Chaque release est annoncée sur l'onglet Changelog + les actualités Wimakeit et suit le versioning sémantique — composer update reste sûr à l'intérieur d'une version majeure.
Tous les templates .phtml sont overridables depuis votre thème : copiez le fichier dans app/design/frontend/{VotreVendor}/{theme}/Wimakeit_{Module}/templates/ en respectant le même chemin relatif. Blocks, ViewModels et Helpers s'override via DI preference dans votre propre module custom — déclarez <preference for="Wimakeit\…\OriginalClass" type="VotreVendor\Override\Class" /> dans etc/di.xml. Le XML layout s'étend (préféré) ou s'override de manière standard Magento. Les modules Wimakeit n'utilisent jamais le keyword final sur les classes que vous pourriez raisonnablement vouloir override — surcharger est un scénario de premier ordre, pas un hack.

Support & sécurité 3

Ouvrez un ticket via le formulaire de contact wimakeit.be ou envoyez un email à contact@wimakeit.com avec le nom du module, sa version, votre version Magento/Mage-OS et les étapes pour reproduire. Les correctifs sont livrés dans le prochain patch. Le support Wimakeit répond en français, anglais et néerlandais en jours ouvrables (horaires CET).
Envoyez les rapports privés à contact@wimakeit.com avec le préfixe [SECURITY] dans l'objet — précisez le module, la version et les étapes de reproduction. Accusé de réception en jours ouvrables, mention dans le Changelog sur souhait du déclarant. Wimakeit est une SRL belge (société à responsabilité limitée) soumise au droit belge et européen sur la vie privée et la divulgation responsable.
Oui. Tax Switch Hyva ne stocke que les données nécessaires à son périmètre fonctionnel, ne suit jamais les acheteurs entre les sites, et ne fait aucun appel tiers par défaut. Combinez-le avec le module RGPD Wimakeit pour publier les bandeaux cookies et les formulaires de demande d'accès aux données conformes aux guidances DPA belge, française et néerlandaise. Les hébergeurs Wimakeit (OVH Roubaix / Gravelines, Cblue Gembloux) gardent toutes les données en UE.

À propos de Wimakeit 1

Wimakeit est une agence Magento certifiée Adobe basée à Presles, en Wallonie (entre Charleroi et Namur), Belgique, qui construit des boutiques Magento et Mage-OS depuis 2020, pour des clients BE / FR / NL. Chaque module de cette marketplace tourne en production chez au moins un client Wimakeit (eat your own dog food). Ligne directe avec les développeurs qui ont écrit le code, support multilingue (FR / EN / NL), horaires CET, pas d'offshore. Consultez nos références pour voir le type de projets Magento que nous livrons.

Quelque chose n'est pas couvert par la FAQ ?

Signalez un bug ou posez une question — le formulaire est pré-rempli avec ce module.

Signaler un bug

Changelog

Categories: Security, Feature, Fix, Perf, Admin, Deps.

[1.1.6] - 2026-05-27

Fix

  • price-label-init.phtml no longer dies with Uncaught SyntaxError: Unexpected end of input. A <script> substring inside a comment was breaking the host HTML parser; rephrased to avoid the literal tag.

[1.1.5] - 2026-05-27

Fix

  • Varnish + HttpOnly X-Magento-Vary no longer trap users in the wrong tax mode. The toggle now reloads onto a one-shot ?_tx=<mode>-<ts> URL so Varnish misses and the backend repopulates the cache under the correct vary hash. A defensive self-heal IIFE runs on every page: if the cookie disagrees with the server-rendered mode and no _tx is already in the query string, the page transparently reloads cache-busted. Without these, toggling on one page and navigating to another previously-cached page silently reverted the display.
  • Ships a noop.phtml and wires the Luma switcher blocks (wimakeit.taxswitch.header/footer/floating/price.label.init) at it via template="Wimakeit_TaxSwitchHyva::noop.phtml", plus belt-and-braces <remove/> + <referenceBlock remove="true"/>. On some Hyvä stacks (magento2-base-layout-reset interactions) the Luma block can still slip through and render unstyled at the top of header.container; on those installs ship a theme override at app/design/.../Wimakeit_TaxSwitch/templates/tax-switcher.phtml that just return;s.

Feature

  • HTVA / TVAC label is now actually rendered next to prices. The previous flow only sized labels that nothing else ever injected. The price-label initializer now:
  • Decorates Hyvä PDP .product-info-main .price-container .final-price > .price-wrapper and Wimakeit_PageBuilder slider .wm-pb-product__price server-side label at boot, and observes the DOM for late-mounted fragments.
  • Lets themes register extra selectors via window.wmiTaxLabelSelectors = ['.my-theme-price', …] before the initializer fires.
  • Ships a Magento_Catalog::product/price/amount/default.phtml override (wired via layout setTemplate on product.price.render.default) that injects the active label server-side everywhere the standard \Magento\Framework\Pricing\Render\Amount block is used — PDP info-price-stock, related/upsell sliders, sidebar widgets.
  • Skips price nodes that already have a sibling .wmi-tax-label so server-side template overrides always win.

Admin

  • The price-label initializer (and self-heal) now boots whenever the module is enabled — the show_price_label toggle still gates the actual label injection, but the Varnish self-heal must run on every page to be effective.

[1.1.4] - 2026-05-08

Fix

  • ifconfig layout paths realigned with the wimakeit_tax_switch config section name (renamed in wimakeit/module-tax-switch 1.3.2). Previously the Hyvä switcher block could be rendered while the toggle was disabled on stores that upgraded both modules together.

[1.1.3] - 2026-04-29

Deps

  • Certified PHP 8.1 → 8.3 support. Composer php constraint tightened to >=8.1 <8.4.

[1.1.2] - 2026-04-28

Deps

  • Direct wimakeit/module-core dependency removed — pulled in transitively via wimakeit/module-tax-switch. The marketplace bundle scanner resolves it correctly.

[1.1.1] - 2026-04-28

Deps

  • wimakeit/module-core dependency declared explicitly so the marketplace bundle scanner picks it up. Superseded by 1.1.2.

[1.1.0] - 2026-04-22

Feature

  • Aligned with wimakeit/module-tax-switch 1.3.0 — the Both (HT + TTC) display mode is removed. Switcher now offers two modes only: Excluding Tax (HT) and Including Tax (TTC).

Admin

  • Added missing French translations (fr_FR) for the switcher aria-labels and screen-reader descriptions.

[1.0.1] - 2026-04-14

Admin

  • Composer/Satis distribution archives now exclude internal files (.gitlab-ci.yml, .claude/, docs/, .gitattributes).

[1.0.0] - 2026-03-12

Feature

  • Initial release of Wimakeit Tax Switch — Hyvä compatibility for Magento 2 / Mage-OS.
  • Adds the Hyvä-native frontend bits required to render wimakeit/module-tax-switch on Hyvä themes: Tailwind classes, Alpine.js switcher component, pre-compiled CSS and the hyva_config_generate_before observer that exposes the active tax-display mode to the Hyvä bundle.
  • Requires wimakeit/module-tax-switch ≥ 1.0 on the same store.

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 Tax Switch Hyva
SKU module : wimakeit-module-tax-switch-hyva · Langue : fr_FR

Besoin d'aide ?

Notre équipe est disponible pour vous accompagner dans l'intégration.

Contactez-nous
Planifier un appel