Tax Display Switcher: setup and help

Upload the ZIP in Modules > Module Manager > Upload a module. Install it and click Configure. Use the module's Settings > Configuration screen, headed General Settings.

Requires PrestaShop 1.6 or later and PHP 7.1 or later.

In multishop, select the context you want to configure. Settings resolve from shop to shop group to global scope.

Click Save. There is no separate placement selector in this form.

For a customer group that should normally browse tax-excluded prices, configure that group's price display method in PrestaShop and keep Default Display set to Follow customer group (default). The native values are 0 for tax included and 1 for tax excluded.

The module stores multilingual keys LABEL_INCL, LABEL_EXCL, SUFFIX_INCL, and SUFFIX_EXCL. These are not four editable fields in the current General Settings form.

Installation seeds labels by language. English values are Incl. VAT, Excl. VAT, incl. VAT, and excl. VAT. German uses inkl. MwSt. and zzgl. MwSt.. French uses TTC and HT. Polish uses brutto and netto. Italian uses IVA incl. and IVA escl.. Spanish uses con IVA and sin IVA. Other language codes use the English fallback at installation.

If you need custom wording, adapt the theme's widget template or arrange a controlled configuration change. Do not look for label fields that this form does not expose. Compact toggle labels and help text also use module translations.

On PrestaShop 1.7 and later, the widget can render in displayNav1 or displayNav2. It renders once, in the first applicable call. On PrestaShop 1.6, it can also use displayTop.

If the hook is missing from a custom header, add the appropriate native call at the desired position:

{hook h='displayNav2'}

For a PrestaShop 1.6 header:

{hook h='displayTop'}

The module does not render through displayTop on 1.7 and later. If another supported navigation hook already ran, the once-only guard can prevent a second copy at your new position. Check actual hook order when moving it.

For custom markup, copy the module template into your theme and edit the copy:

/themes/your_theme/modules/mprtaxdisplayswitcher/views/templates/hook/switcher.tpl

The toggle style includes a help control. Tooltip behavior uses the theme's available Bootstrap tooltip integration.

The front script saves the preference directly in the public mpr_tax_display cookie before updating prices. It does not call a switch AJAX endpoint in this revision.

A non-default choice stores:

mpr_tax_display=0
mpr_tax_display=1

Returning to the configured default removes the cookie. The cookie uses path /, SameSite Lax, and Secure on HTTPS. A later request reads the preference before price display is prepared. It changes the request's cached group display method without updating the stored group record.

The module supplies hidden price data through displayProductPriceBlock only for hook calls with type="weight". It prepares sale and regular prices in both modes and formats them in the active currency. For example:

<span class="mpr-tax-prices"
      style="display:none"
      data-si="120.00"
      data-se="100.00"
      data-ri="150.00"
      data-re="125.00"
      data-d="1"></span>

These attributes contain formatted strings in real output. JavaScript uses compatible product and listing markup to replace visible prices.

Changes are instant when all detected visible prices have matching .mpr-tax-prices data. If data is absent, a price cannot be matched or coverage is incomplete, the script saves the preference and reloads the page so the server renders the chosen mode. Cart and checkout pages reload even when product recommendations contain price data.

The module controls price presentation. Tax rules, stored product prices, actual tax liability, and order accounting still use the shop's tax and checkout configuration. For display data where native inclusive and exclusive values are equal while tax is enabled, the module can calculate an inclusive display fallback from the default-country tax rate. Test that case separately for customer-address and VAT-sensitive shops.

Open an uncached storefront page without a saved preference. Confirm it uses Default Display. Switch modes and inspect both the visible price and mpr_tax_display in browser storage.

Navigate immediately to another product. Confirm the chosen mode persists. Switch back to the configured default and confirm the cookie disappears.

Test a product listing, a simple product, a product with combinations, and discounted regular/sale prices. Change the currency and repeat. Test cart and checkout separately, comparing display with the actual totals and tax lines. Inspect custom layouts where hidden price spans are absent or only some nodes update.

For a read-only check of native group display data, use your actual table prefix and language ID:

SELECT g.id_group, gl.name, g.price_display_method
FROM ps_group AS g
INNER JOIN ps_group_lang AS gl ON gl.id_group = g.id_group
WHERE gl.id_lang = 1;

Use the module's classes and CSS variables in your theme stylesheet. For example:

:root {
  --mpr-primary: #1f7a5c;
  --mpr-border: #d6d6d6;
  --mpr-text: #222;
  --mpr-text-muted: #777;
}
.mprtaxswitch-host { margin-left: 12px; }
.mprtaxswitch__btn { text-transform: uppercase; }
.mprtaxswitch-tooltip .tooltip-inner { max-width: 320px; }

If the control is missing, check Enable Tax Switcher, theme hooks, once-only rendering, and front asset loading. Use the module's Integrity screen for infrastructure checks.

If prices remain unchanged, inspect .mpr-tax-prices and the theme's displayProductPriceBlock call with type weight. Check browser script errors and whether the markup matches the script's price containers.

If a reload restores the wrong mode, inspect cookie permissions, scope, and the page cache. Test without a cached HTML response. If suffixes are absent, check Show Price Suffix, the suffix values, browser script errors and the theme's price markup.

The preference is saved in the browser cookie. There is no separate switching URL at /module/mprtaxdisplayswitcher/switch or /ajax.

Set Enable Tax Switcher to No to stop the widget and override while retaining settings. Uninstall through Module Manager to remove the menu and module configuration.

Uninstall leaves existing visitor preference cookies in their browsers. You can clear mpr_tax_display in the browser when checking default behavior. Remove any theme template customizations separately.