Tax Switch Hyva

Free
v1.1.8 Annual Subscription Updated Jun 5, 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.
Free Hyvä Compatible Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
Free
Try the live demo
  • Updates and support included for 12 months
  • Full documentation included
  • Compatible with Hyvä themes
  • Composer-ready installation

Tax Switch — Hyvä

The Hyvä-frontend companion of wimakeit/module-tax-switch. If you run the Tax Switch module on a Hyvä storefront, install this one too: it replaces the Luma (RequireJS + jQuery) templates with Alpine.js components and vanilla-JS price labels, while reusing the same admin configuration, the same cookie, and the same ViewModel.

You install this module in addition to the main Tax Switch module — never instead of it. The main module owns the configuration, the plugin layer and the FPC integration; this one owns the Hyvä-compatible rendering.

Who it's for

  • Stores running on Hyvä Themes that need a tax display mode switcher (HT/TTC) without dragging RequireJS back into their bundle
  • Multi-frontend setups where Luma and Hyvä coexist and need consistent tax-switch behaviour
  • Hyvä projects that want the full Tax Switch feature set (visibility rules, styling, price labels, four display styles) without writing their own Alpine.js components

Key benefits

  • Alpine.js components, no jQuery — the radio, toggle, segmented and dropdown styles are reimplemented with x-data so they fit naturally into a Hyvä bundle.
  • Vanilla-JS price labels — auto-sizing HT/TTC labels next to prices, with no dependency on RequireJS or mage/cookies.
  • Reuses the main module's configuration — all admin settings (visibility, styling, labels, customer groups, devices) live in the main Tax Switch module. Nothing new to learn or configure here.
  • Removes the Luma blocks — automatically strips the original RequireJS-based blocks from layout, so Hyvä themes don't load them by mistake.
  • CSS variables hook — override the defaults from your Hyvä theme's CSS with a clean set of --wmi-tax-* variables (gap, bg, radius, font-size, border, active colours).

Compatibility

  • Magento 2.4.x / Mage-OS equivalent
  • PHP 8.1, 8.2, 8.3
  • Requires wimakeit/module-tax-switch 1.0 or later (this module is a frontend addon, not a standalone payment of tax-switching logic)
  • Requires the official Hyvä Themes base module (hyva-themes/magento2-theme-module 1.0+)
  • A Hyvä-based storefront theme

Install this module via Composer. Make sure your auth.json is configured with your Wimakeit credentials.

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
License
Annual Subscription
Support
12 months
Last updated
Jun 5, 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

Compatibility checker

Pick your stack to see if this module fits.

Compatibility 4

Yes. Tax Switch Hyva is tested against Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce on the same line, and Mage-OS 2.0+ — on PHP 8.1, 8.2 and 8.3. The Specifications tab lists the exact tested combinations. If your stack is in the list, we guarantee a clean install. Wimakeit is an Adobe-certified Magento agency based in Presles (Charleroi / Namur region), Wallonia, Belgium and runs every module against the same matrix we ship to enterprise clients across Belgium, France and the Netherlands.
Yes — fully. Tax Switch Hyva ships a native Hyvä-compatible frontend (Tailwind + Alpine.js) and integrates with Hyvä Checkout when applicable. No companion fallback module needed. Every Hyvä-marked module is built and maintained by the same Wimakeit team that ships Hyvä builds for production stores.
Hyvä Storefront (Tailwind + Alpine.js, server-rendered) and Hyvä Checkout (React-based, headless on top of Magento) are two distinct packages. Tax Switch Hyva ships native Hyvä Storefront compatibility — its frontend is rendered through Hyvä templates with no Luma fallback. Hyvä Checkout integration is delivered when the module has a checkout-step touchpoint (custom payment input, terms checkbox, etc.); otherwise the module runs server-side without any Hyvä Checkout customisation needed. See the Specifications tab for the exact Hyvä integration scope of this module.
Yes. Tax Switch Hyva respects the standard Magento scope (default / website / store / store_view). Every configuration is overridable per store view. Frontend labels use Magento's standard translation files — shipped in French, English and Dutch out of the box. Currencies follow your Magento currency setup with no extra wiring. A typical Wimakeit Magento store runs an fr_BE / nl_BE / en_GB triplet from a single backend — Tax Switch Hyva is ready for this B2B / international setup.

Pricing & licensing 4

Tax Switch Hyva is offered free of charge to Wimakeit clients. The licence covers production + 1 staging/dev domain. Premium support, custom development and SLA upgrades are available on request — Wimakeit's Wallonian Magento team (Presles, between Charleroi and Namur) has held an Adobe Commerce certification since 2021.
Yes. Tax Switch Hyva has a live demo on demo.wimakeit.be/module-tax-switch-hyva where you can poke around the admin and frontend with a real install pre-populated with sample data. For longer evaluations, request an evaluation licence via our contact form — evaluations cover the same scope as the paid licence and convert to a permanent key on purchase.
There is no payment to refund — Tax Switch Hyva is free. If it doesn't fit your store, just disable the module via bin/magento module:disable; uninstall cleanup is automatic via the module's setup patch revert.
Tax Switch Hyva is distributed under a commercial proprietary licence — not MIT, GPL or any other open-source licence. The PHP source ships in vendor/wimakeit/ once you composer require the package, so you can read it, audit it, and patch it locally for your own Magento install. You may NOT redistribute it, sublicense it, publish it on a public package registry, or sell it on. One licence = one production domain + one staging/dev domain (see terms for the full EULA). Wimakeit modules are NOT part of Magento's open-source repository on packagist.org — they are distributed exclusively via the private Composer registry packages.wimakeit.be.

Installation & updates 6

Run composer require wimakeit/module-tax-switch-hyva:^1.1.7, then bin/magento setup:upgrade, bin/magento setup:di:compile, and finally bin/magento cache:flush. The Installation tab on this page lists every configuration step (ACLs, cron jobs, default values) so a deploy takes minutes, not hours. If you need a hand, Wimakeit offers Magento installation services from our Wallonian office (Presles, between Charleroi and Namur).
Step 1: get a token on packages.wimakeit.be → My account → Tokens. Step 2: at the root of your project add to auth.json: {"http-basic": {"packages.wimakeit.be": {"username": "YOUR-EMAIL", "password": "YOUR-TOKEN"}}}. Step 3: register the repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Step 4: composer require wimakeit/module-tax-switch-hyva:^1.1.7. In CI/CD pipelines, inject COMPOSER_AUTH as a JSON env var instead of committing auth.json.
Most merchants are live within 30 minutes: composer install (1-2 min) → setup:upgrade + di:compile (5-10 min depending on stack size) → admin configuration (5-15 min following the Installation tab) → smoke test on a product or order. Allow extra time if you have a custom theme overriding similar templates. The Wimakeit team has shipped this exact module to B2B and DTC stores across Belgium.
Tax Switch Hyva is built for Magento 2.4.x / Mage-OS 2.0+ and has no Magento 1 equivalent. When migrating from Magento 1, the Wimakeit team handles the audit, the data migration and the integration of Tax Switch Hyva into the new backend as part of a Magento migration project. Migrating from Adobe Commerce to Mage-OS is transparent for Tax Switch Hyva: same composer require, same module code, same database schema — no fork to maintain, no licence change.
Updates ship through your composer dependency (this exact package), hosted on Wimakeit's private Composer repository at packages.wimakeit.be. Each release is announced on the Changelog tab + the Wimakeit news and follows semantic versioning — composer update is safe within a major.
All .phtml templates are overridable from your theme: copy the file into app/design/frontend/{YourVendor}/{theme}/Wimakeit_{Module}/templates/ keeping the same relative path. Blocks, ViewModels and Helpers are overridable via DI preference in your own custom module — declare <preference for="Wimakeit\…\OriginalClass" type="YourVendor\Override\Class" /> in etc/di.xml. Layout XML is extended (preferred) or overridden the standard Magento way. Wimakeit modules never use the final keyword on classes you might reasonably want to override — overriding is a first-class scenario, not a hack.

Support & security 3

Open a ticket through the contact form on wimakeit.be or email contact@wimakeit.com with the module name, version, Magento/Mage-OS version and the steps to reproduce. Fixes ship in the next patch release. Wimakeit support is staffed in French, English and Dutch on business days (CET working hours).
Send security reports privately to contact@wimakeit.com with a clear [SECURITY] subject prefix — please include the module name, version and the steps to reproduce. We acknowledge promptly on business days and credit reporters in the Changelog if they wish. Wimakeit is a Belgian SRL (société à responsabilité limitée) bound by Belgian and EU privacy and disclosure law.
Yes. Tax Switch Hyva stores only the data its feature scope requires, never tracks shoppers across sites, and ships zero third-party calls by default. Combine it with the Wimakeit GDPR module to publish cookie banners and data-subject request forms compliant with Belgian, French and Dutch DPA guidance. Wimakeit's EU-based hosting partners (OVH Roubaix / Gravelines, Cblue Gembloux) keep every customer's data inside the EU.

About Wimakeit 1

Wimakeit is an Adobe-certified Magento partner agency based in Presles, Wallonia (between Charleroi and Namur), Belgium, building Magento and Mage-OS stores since 2020 across BE / FR / NL. Every module on this marketplace runs in production on at least one Wimakeit client (we eat our own dog food). Direct line to the developers who built the code, multilingual support (FR / EN / NL), CET business hours, no offshore handoff. See our portfolio for the kind of Magento builds we ship.

Found something not covered by the FAQ?

Report a bug or ask a question — the form is prefilled with this module.

Report a 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.

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 Tax Switch Hyva
Module SKU: wimakeit-module-tax-switch-hyva · Language: en_US

Need help?

Our team is available to assist with integration.

Contact us
Planifier un appel