Tax Switch

v1.3.4 Jaarabonnement Updated 5 jun. 2026

Tax Switch

Laissez vos clients basculer l'affichage des prix HT ↔ TTC d'un simple clic, sans rechargement de page, sur toute la boutique. Idéal pour les sites B2B/B2C hybrides.
Magento 2.4.4 Magento 2.4.5 Magento 2.4.6 Magento 2.4.7 Mage-OS 2.0 Mage-OS 2.1
€ 49,00
Probeer de live demo
  • Updates and support included for 12 months
  • License key delivered immediately by email
  • 30-day money-back guarantee
  • Full documentation included
  • Composer-ready installation

Tax Switch

Laat elke klant kiezen hoe hij uw prijzen ziet — inclusief BTW of exclusief BTW — en onthoud zijn keuze op de hele site. Deze module voegt een kleine switcher toe aan uw storefront (radio, toggle, segmented of dropdown stijl) die elke prijsweergave on-the-fly omschakelt: catalogus, winkelmandje, mini-cart, shipping, ordertotalen. Geen herberekening, geen tweede checkout, gewoon een propere visuele wissel.

Het is bijzonder nuttig voor B2B-georiënteerde B2C-winkels: professionals willen HT-prijzen vergelijken met hun leveranciersoffertes, consumenten willen TTC voor hun budget. In plaats van één publiek te forceren of twee winkels te onderhouden, laat u de bezoeker kiezen.

Voor wie

  • B2B- en "B2B + B2C-gemengde" handelaars die zowel professionele klanten als eindklanten bedienen vanuit dezelfde winkel
  • Belgische / Franse / Luxemburgse winkels waar HT vs TTC een dagelijkse reflex is voor kopers
  • Handelaars die HT-prijzen willen tonen tijdens catalog browsing maar TTC bij checkout, of omgekeerd, zonder hun tax-configuratie te moeten herschrijven

Belangrijkste voordelen

  • Cookie-based, FPC-compatibel — de keuze wordt opgeslagen in een wmi_tax_display_mode cookie en blootgesteld via HTTP Context, zodat Varnish / ingebouwde Full Page Cache blijven werken zonder de gebruikersvoorkeur te verliezen.
  • Plugin-based price override — intercepteert elke relevante Magento Tax Config-methode (catalog price, shipping, cart line items, cart subtotal, sales / order prices, sales / order subtotal) zodat de toggle overal werkt, niet alleen op productpagina's.
  • Vier display-stijlen — radio buttons, toggle, dropdown of segmented control. Kies wat bij uw theme past.
  • Configureerbare prijslabels — toon optioneel HT/TTC naast elke prijs op de site, met auto-sizing labels (configureerbare ratio t.o.v. prijs font-size), positie before/after, custom labeltekst (HTVA/TVAC in plaats van HT/TTC als u dat verkiest).
  • Visibility rules — toon de switcher overal, alleen op de catalogus, sluit checkout uit, of beperk tot specifieke layout handles. Optionele targeting op klantengroep en device (desktop/mobile).
  • Theming via CSS-variabelen — primaire kleur, active text-color, border, background, border-radius, font size, allemaal configureerbaar vanuit de admin. Geen CSS-bestand om te editeren.
  • Veilig ontworpen — input-validatie weert elke mode-waarde buiten de geconfigureerde set; cookies gebruiken de Secure flag op HTTPS; CSS-waarden worden via whitelist gevalideerd (hex, rgb/rgba, hsl/hsla, CSS-variabelen) in plaats van met regex gestript.

Compatibiliteit

  • Magento 2.4.x / Mage-OS equivalent
  • PHP 8.1, 8.2, 8.3
  • Vereist wimakeit/module-core 3.0 of hoger
  • Ontworpen voor Luma-frontends out of the box; te combineren met wimakeit/module-tax-switch-hyva voor Hyvä-storefronts
  • Compatibel met Varnish Full Page Cache (gebruikt HTTP Context-variatie)

Installeer deze module via Composer. Zorg ervoor dat uw auth.json is geconfigureerd met uw Wimakeit-inloggegevens.

Terminal 
$ composer require wimakeit/module-tax-switch:^1.3.4
$ 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 dependency

This module requires wimakeit/module-core 3.0 or later. Composer pulls it automatically from the Wimakeit registry as long as the registry is declared in your project's composer.json.

Companion module for Hyvä

If your storefront runs on Hyvä, also install wimakeit/module-tax-switch-hyva. That module replaces the Luma (RequireJS) frontend with Alpine.js / vanilla-JS templates while reusing the same admin configuration and ViewModel.

ACL permission

ResourceDefault
Wimakeit_TaxSwitch::config (edit Tax Switcher configuration)granted to Administrator role only

Configuration

Go to Stores → Configuration → Wimakeit → Tax Switcher. The module is disabled by default so installing it never changes a live frontend until you turn it on.

General

SettingDefault
Enable Tax SwitcherNo
Default Display ModeAuto (use the store's native Tax → Price Display config)

Display Options

SettingDefault
Available ModesHT, TTC (1,2)
Display Styleradio (options: radio, toggle, dropdown, segmented)
Positionheader
Show LabelsYes

Visibility Rules

SettingDefault
Page Visibilityall_pages (options: all_pages, catalog_only, exclude_checkout, specific_handles)
Excluded Layout Handlesempty
Customer Groupsempty (all groups)
Device Visibilityall (options: all, desktop, mobile)

Labels (next to prices)

SettingDefault
Show Tax Label Next to PricesNo
Excluding Tax Labelempty (falls back to HT)
Including Tax Labelempty (falls back to TTC)
Show Currency SymbolYes
Price Label Positionafter
Price Label Size Ratio0.6 (60% of price font size, range 0.4–1.0)

Styling (CSS variables)

SettingDefault
Primary / Active Color#333333
Active Text Color#ffffff
Border Color#B9B8AF
Background Colortransparent
Border Radius4px
Font Size0.8125rem

Override any of these to match your theme without touching CSS files.

Full Page Cache note

The module uses Magento HTTP Context to vary FPC entries by tax display mode. After enabling the module on a live store, flush the FPC once (bin/magento cache:flush full_page) so the new context variation takes effect.

Versie
v1.3.4
Licentie
Jaarabonnement
Ondersteuning
12 maanden
Last updated
5 jun. 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ä
Niet compatibel
Pakket
wimakeit/module-tax-switch

Compatibility checker

Pick your stack to see if this module fits.

Compatibiliteit 4

Ja. Tax Switch is getest tegen Magento Open Source 2.4.4 → 2.4.7, Adobe Commerce op dezelfde lijn, en Mage-OS 2.0+ — op PHP 8.1, 8.2 en 8.3. Het tabblad Specificaties toont de geteste combinaties. Staat uw stack erbij, dan garanderen wij een schone installatie. Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België — elke module wordt getest op dezelfde matrix die we naar onze enterprise-klanten in België, Frankrijk en Nederland uitrollen.
Tax Switch richt zich vandaag op de klassieke Magento / Luma-stack. Een aparte Hyvä-companion bestaat mogelijk — bekijk de Wimakeit modules-catalogus of neem contact op met ons Waalse kantoor (Presles) voor een Hyvä-portering op maat.
Hyvä Storefront (Tailwind + Alpine.js, server-rendered) en Hyvä Checkout (React-gebaseerd, headless bovenop Magento) zijn twee aparte pakketten. Tax Switch bevat native Hyvä Storefront-compatibiliteit — de frontend wordt gerenderd via Hyvä-templates, zonder Luma-fallback. Hyvä Checkout-integratie wordt geleverd wanneer de module een raakvlak heeft met een checkout-stap (custom betaalinput, voorwaarden-checkbox, ...); anders draait de module server-side zonder Hyvä Checkout-aanpassing. Zie het tabblad Specificaties voor de exacte Hyvä-scope van deze module.
Ja. Tax Switch respecteert het standaard Magento-scope (default / website / store / store_view). Elke configuratie is overschrijfbaar per store view. Frontend-labels gebruiken de standaard Magento-vertaalbestanden — by-default in het Nederlands, Frans en Engels. Valuta's volgen uw Magento-valutaconfiguratie zonder extra werk. Een typische Wimakeit Magento-webshop draait een fr_BE / nl_BE / en_GB-triplet vanuit één backend — Tax Switch is klaar voor deze B2B / internationale setup.

Prijs & licentie 4

€49 — eenmalige betaling, eeuwigdurende licentie, geen abonnementskosten. Inclusief 1 jaar minor updates + e-mailsupport in Nederlands, Frans en Engels, 1 productie + 1 staging/dev-domein. Het verlengen van het supportvenster na jaar 1 is optioneel. Bureau- of multi-store-tarieven worden rechtstreeks onderhandeld via contact@wimakeit.com.
Ja. Tax Switch heeft een live demo op demo.wimakeit.be/module-tax-switch waar u admin en frontend kan verkennen met een echte installatie inclusief sample data. Voor langere evaluaties vraagt u een evaluatielicentie aan via ons contactformulier — de evaluatie dekt dezelfde scope als de betaalde licentie en wordt na aankoop omgezet in een permanente sleutel.
Wij beoordelen terugbetalingsverzoeken geval per geval. Levert de module niet wat aangekondigd? Mail contact@wimakeit.com vanaf het e-mailadres gekoppeld aan uw licentie. Het Wimakeit-terugbetalingsbeleid staat in de algemene voorwaarden en geldt voor elke module op deze marketplace.
Tax Switch wordt verspreid onder een commerciële proprietary licentie — geen MIT, GPL of andere open-source licentie. De PHP-broncode komt na composer require in vendor/wimakeit/ terecht; u kan ze lezen, auditen en lokaal patchen voor uw eigen Magento-installatie. U mag de code NIET herverspreiden, sublicentiëren, op een publiek Composer-register publiceren of doorverkopen. Eén licentie = één productiedomein + één staging/dev-domein (zie de algemene voorwaarden voor de volledige EULA). Wimakeit-modules staan NIET op het publieke packagist.org — ze worden uitsluitend verspreid via het private Composer-register packages.wimakeit.be.

Installatie & updates 6

Voer composer require wimakeit/module-tax-switch:^1.3.2 uit, daarna bin/magento setup:upgrade, bin/magento setup:di:compile en tot slot bin/magento cache:flush. Het tabblad Installation op deze pagina lijst elke configuratiestap (ACL's, crons, defaultwaarden) — een deploy duurt minuten, geen uren. Hulp nodig? Wimakeit biedt Magento-installatiediensten vanuit ons Waalse kantoor (Presles, tussen Charleroi en Namen).
Stap 1: haal een token op via packages.wimakeit.be → Mijn account → Tokens. Stap 2: voeg in de root van uw project aan auth.json toe: {"http-basic": {"packages.wimakeit.be": {"username": "UW-E-MAIL", "password": "UW-TOKEN"}}}. Stap 3: registreer het repo: composer config repositories.wimakeit composer https://packages.wimakeit.be. Stap 4: composer require wimakeit/module-tax-switch:^1.3.2. In CI/CD-pipelines injecteert u COMPOSER_AUTH als JSON-environment-variabele in plaats van auth.json te commit'en.
De meeste merchants zijn binnen 30 minuten live: composer install (1-2 min) → setup:upgrade + di:compile (5-10 min afhankelijk van de stack) → adminconfiguratie (5-15 min volgens het Installation-tabblad) → smoke test op een product of order. Reken meer tijd als u een custom theme heeft dat vergelijkbare templates overschrijft. Het Wimakeit-team heeft deze module geleverd aan B2B- en DTC-shops in heel België.
Tax Switch is ontworpen voor Magento 2.4.x / Mage-OS 2.0+ en heeft geen Magento 1-equivalent. Bij een migratie vanaf Magento 1 neemt het Wimakeit-team de audit, datamigratie en integratie van Tax Switch in de nieuwe backoffice voor zijn rekening, in het kader van een Magento-migratieproject. De overstap van Adobe Commerce naar Mage-OS is transparant voor Tax Switch: zelfde composer require, zelfde modulecode, zelfde databaseschema — geen fork om te onderhouden, geen licentiewijziging.
Updates lopen via uw composer-dependency (exact dit pakket), gehost op het private Composer-register van Wimakeit op packages.wimakeit.be. Elke release wordt aangekondigd op het Changelog-tabblad + het Wimakeit-nieuws en volgt semver — composer update blijft veilig binnen een major.
Alle .phtml-templates zijn overschrijfbaar vanuit uw theme: kopieer het bestand naar app/design/frontend/{UwVendor}/{theme}/Wimakeit_{Module}/templates/ met hetzelfde relatieve pad. Blocks, ViewModels en Helpers worden overschreven via DI-preference in uw eigen custom module — declareer <preference for="Wimakeit\…\OriginalClass" type="UwVendor\Override\Class" /> in etc/di.xml. Layout-XML wordt uitgebreid (voorkeur) of overschreven op de standaard Magento-manier. Wimakeit-modules gebruiken nooit het keyword final op klassen die u redelijkerwijs zou willen override — overschrijven is een first-class scenario, geen hack.

Support & beveiliging 3

Open een ticket via het contactformulier op wimakeit.be of mail contact@wimakeit.com met modulenaam, versie, Magento/Mage-OS-versie en reproduceringsstappen. Fixes verschijnen in de volgende patch. Wimakeit-support antwoordt in het Nederlands, Frans en Engels op werkdagen (CET-uren).
Stuur security-rapporten privé naar contact@wimakeit.com met het voorvoegsel [SECURITY] in het onderwerp — vermeld de module, versie en reproductiestappen. Bevestiging op werkdagen, vermelding in het Changelog op verzoek. Wimakeit is een Belgische BV (besloten vennootschap) onderworpen aan Belgisch en Europees recht inzake privacy en responsible disclosure.
Ja. Tax Switch bewaart uitsluitend data binnen zijn functionele scope, volgt nooit shoppers over verschillende sites, en doet by-default geen enkele externe call. Combineer met de Wimakeit GDPR-module voor cookiebanners en data-subject request forms conform Belgische, Franse en Nederlandse DPA-richtlijnen. De hostingpartners van Wimakeit (OVH Roubaix / Gravelines, Cblue Gembloux) houden alle klantdata binnen de EU.

Over Wimakeit 1

Wimakeit is een Adobe-gecertificeerd Magento-bureau in Presles, Wallonië (tussen Charleroi en Namen), België, dat sinds 2020 Magento- en Mage-OS-webshops bouwt voor klanten in BE / FR / NL. Elke module op deze marketplace draait in productie bij minstens één Wimakeit-klant (we eat our own dogfood). Directe lijn met de ontwikkelaars die de code hebben geschreven, meertalige support (NL / FR / EN), CET-werkuren, geen offshore. Bekijk onze referenties voor het soort Magento-projecten dat wij opleveren.

Iets gevonden dat niet in de FAQ staat?

Meld een bug of stel een vraag — het formulier is voor-ingevuld met deze module.

Een bug melden

Changelog

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

[1.3.2] - 2026-05-08

Admin

  • Admin menu group standardized — module appears under a top-level Wimakeit_TaxSwitch entry with a Settings child that opens directly on the configuration section.
  • Config section path renamed from wimakeit_taxswitch to wimakeit_tax_switch for consistency with the other Wimakeit modules. A data patch migrates existing core_config_data rows automatically on setup:upgrade — no manual reconfiguration needed.

[1.3.1] - 2026-04-29

Admin

  • Internal release pipeline standardized (validate, tag, deploy, release stages). No functional change for merchants.

Deps

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

[1.3.0] - 2026-04-22

Feature

  • Simplified switcher to two modes only: Excluding Tax (HT) and Including Tax (TTC). The legacy "Both" (HT + TTC) display mode and its vertical/horizontal layout, templates, JS, CSS and translation keys are removed.

Admin

  • Stores that had "Both" selected fall back to the configured default mode after upgrade — review your Stores → Configuration → WiMakeIT → Tax Switch → Default mode setting if you used it.

[1.2.3] - 2026-04-14

Admin

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

[1.2.2] - 2026-04-10

Security

  • Cookie value is now validated against the admin-configured Available modes before being applied — blocks a business-logic bypass where a crafted cookie could force a display mode the merchant disabled.
  • Cookie lifetime reduced from 1 year to 30 days (GDPR proportionality).
  • Removed hardcoded EUR / € fallback — multi-currency stores now read the active currency for the price label suffix.

Perf

  • TaxConfigPlugin moved from global di.xml to frontend/di.xml — no longer instantiated in admin, CLI or cron requests.
  • Template position check runs once per page instead of three times (shouldDisplay() short-circuited earlier).
  • Duplicate caching removed from TaxConfigPlugin (the provider already cached upstream).

Admin

  • Dead methods, no-op requirejs-config.js and ~28 lines of redundant logic removed.

[1.2.1] - 2026-04-07

Admin

  • Config readers refactored to use the shared AbstractConfig base from wimakeit/module-core — consistent typed getters (getString, getBool, …) across all Wimakeit modules.
  • Admin Show Tax Label field now controls visibility of HT/TTC labels, currency and position fields via UI dependencies; field order reorganized for clarity.

Deps

  • Depends on wimakeit/module-core for shared config and admin-tab abstractions.

[1.2.0] - 2026-03-11

Security

  • CSS values are now validated against a whitelist (hex, rgb/rgba, hsl/hsla, CSS variables, numbers with units, named colors) instead of a regex blacklist. Invalid CSS is rejected outright rather than having characters stripped.

Perf

  • HttpContextPlugin skips REST (/rest/) and GraphQL endpoints, which never use Full Page Cache, and skips AJAX requests that use customer sections.
  • A per-request "processed" flag avoids running the same HTTP Context logic twice.
  • TaxConfigPlugin short-circuits with a cached module-enabled check, so disabled installs pay no overhead.
  • Frontend MutationObserver now targets specific containers (.page-wrapper, minicart) instead of the entire <body>, and only reacts to mutations that contain price-related elements.

[1.1.0] - 2026-03-11

Feature

  • Optional price label next to every price across the site (HT/TTC, with custom text like HTVA/TVAC).
  • Auto-sizing labels: configurable ratio (0.4–1.0) relative to price font size.
  • Label position before or after the price; "both" mode with vertical or horizontal layout.
  • Admin configuration for all price-label settings.
  • MutationObserver-driven label rendering for dynamic content (minicart, AJAX updates).

Admin

  • Hides Magento's native tax labels (.price-label, data-label) when the module is active to avoid duplicates.
  • Inline JavaScript/CSS extracted from PHTML into separate, cache-friendly price-label.css / price-label.js files.

[1.0.0] - 2024-03-10

Feature

  • Initial release.
  • Frontend tax display mode switcher with three modes (HT / TTC / Both).
  • Cookie-based user preference, persistent across sessions.
  • Full Page Cache compatibility via HTTP Context variation.
  • Plugin intercepting Magento Tax Config for catalog prices, shipping, cart prices and subtotals, sales / order prices and subtotals.
  • Vanilla JavaScript implementation — no jQuery, no Knockout.

Security

  • Input validation on mode values (only 1, 2, 3 accepted).
  • Secure cookie flag enforced on HTTPS.
  • XSS protection via proper output escaping.

Admin

  • French and English translations included (fr_FR, en_US).
  • PHP 8.1+ with strict types and readonly properties throughout.

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 Tax Switch
Module SKU: wimakeit-module-tax-switch · Taal: nl_NL

Hulp nodig?

Ons team helpt u graag met de integratie.

Neem contact op
Planifier un appel