Plugin: tax-switch-for-woocommerce (Used by 96 domains)

Tax Switch for WooCommerce enhances your WooCommerce store by allowing users to toggle between displaying prices including or excluding VAT. This plugin adds a customizable switch component and provides a flexible way to display both price versions.

Key features

• Display customizable switches where you want
• Gutenberg block support
• Shortcode for easy integration (including shortcode generator)
• Flexible display options for prices with and without VAT
• Remembers the user’s preference for future visits
• Choose between a toggle switch or buttons

For more information about this plugin, please visit the plugin page.

Requirements

• WooCommerce plugin installed and activated
• WooCommerce tax calculations enabled and configured

Configuration

Configure the plugin settings below for proper functionality.

WooCommerce settings

Ensure these WooCommerce settings are configured first:

1. Configure tax calculations

   • Go to: WooCommerce > Settings > General
   • Verify your shop address is complete
   • Enable “Enable tax rates and calculations”
   • Set “Default customer location” to “Shop base address”

2. Set up tax rates

   • Go to: WooCommerce > Settings > Tax > Standard Rates
   • Add your regional tax rates

3. Recommended: tax calculation method

   • Go to: WooCommerce > Settings > Tax
   • Set “Calculate tax based on” to “Shop base address”
     (This provides instant tax calculation. Other methods require customers to enter their address first.)

4. Individual product configuration

   • Edit products at: Products > [Product]
   • Under Product Data > Tax, set status to “Taxable”

Plugin settings

Configure these plugin-specific settings:

1. Main settings
   • Go to: WooCommerce > Settings > Tax Switch
   • Set your preferred text values
   • Optional: Restrict display locations
   • Optional: Generate a shortcode via WooCommerce > Settings > Tax Switch > Shortcode

Usage

After installation and configuration, you can add the tax switch to your pages in two ways:

1. Use the Gutenberg block “Tax Switch for WooCommerce” in your page or post editor.
2. Use the shortcode [wdevs_tax_switch] anywhere in your content.

Shortcode Usage

Switch/buttons

Basic usage:
[wdevs_tax_switch]

Displays a switch to toggle displaying prices including or excluding VAT.

The shortcode accepts several attributes to customize its appearance and behavior:

• class-name: Adds custom CSS classes to the switch.
  • Default: is-style-default
  • Options: is-style-default, is-style-inline, is-style-flat-pill, or custom classes
• switch-type: Determines the style of the toggle.
  • Default: switch
  • Options: switch, buttons
• switch-color: Sets the color of the switch handle.
• switch-color-checked: Sets the color of the switch when it’s in the “on” position.
• switch-background-color: Sets the background color of the switch.
• switch-text-color: Sets the text color of the switch labels.
• switch-background-color-checked: Sets the background color of the switch when it’s in the “on” position.
• switch-label-incl: Sets the text for the “including VAT” label.
  • Default: Uses the text set in the plugin settings or “Incl. VAT” if not set.
• switch-label-excl: Sets the text for the “excluding VAT” label.
  • Default: Uses the text set in the plugin settings or “Excl. VAT” if not set.
• switch-aria-label: Sets the aria label of the switch.
  • Default: Uses the text set in the plugin settings or “Switch between prices including and excluding VAT” if not set.

Example with custom attributes:

[wdevs_tax_switch class-name="is-style-inline" switch-type="switch" switch-color="#ffffff" switch-color-checked="#000000" switch-background-color="#000000" switch-background-color-checked="#4CAF50" switch-text-color="#FF0000" switch-label-incl="Incl. tax" switch-label-excl="Excl. tax" switch-aria-label="Switch between prices including and excluding VAT"]

Label

Basic usage:
[wdevs_tax_switch_label]

Displays text indicating the currently selected tax setting. The text updates automatically when the tax switch is toggled.

The shortcode accepts several attributes to customize its appearance and behavior:

• class-name: Adds custom CSS classes to the label.
  • Default: is-style-default
  • Options: is-style-default or custom classes
• label-text-incl: Sets the text to display when “including VAT” is selected.
  • Default: Uses the text set in the plugin settings or “Incl. VAT” if not set.
• label-text-excl: Sets the text to display when “excluding VAT” is selected.
  • Default: Uses the text set in the plugin settings or “Excl. VAT” if not set.
• label-text-color: Sets the “excluding VAT” text color.
• label-text-color-checked: Sets the “including VAT” text color.

Example with custom attributes:

[wdevs_tax_switch_label class-name="tax-indicator" label-text-incl="Prices include tax" label-text-excl="Prices exclude tax" label-text-color="#FF0000" label-text-color-checked="#4CAF50"]

PHP implementation

You can use these shortcodes with PHP with the do_shortcode() function:

JavaScript events

The switch fires a JavaScript event when the tax display is toggled. You can listen for this event to execute custom code when a user switches between inclusive and exclusive VAT display. This is useful for when you need to perform additional actions based on the tax display state.

document.addEventListener('wdevs-tax-switch-changed', function(event) {
   console.log(event.detail);
   // event.detail contains:
   // - isSwitched: boolean - the raw switch state
   // - displayIncludingVat: boolean - whether prices now display including VAT
 });

If you are loading the switch dynamically (via AJAX), dispatch this event after rendering to initialize the component:

   document.dispatchEvent( new CustomEvent('wdevs-tax-switch-appeared') );

WPML

To translate the option texts via WPML:

1. Save your options first in: WooCommerce -> Settings -> Tax Switch
2. Then translate the texts in: WPML -> String Translations and search for your option values in the domain ‘tax-switch-for-woocommerce’

Compatibility

This plugin integrates with WooCommerce’s standard filters and actions for price display and calculation. While most plugins and themes work out of the box, some third-party code use custom price building methods that require specific compatibility integrations.

The following themes have been tested and confirmed compatible:

• GeneratePress
• Blocksy
• Thrive
• Flatsome
• Kapee
• Entr
• Woodmart
• Hello Elementor

The following plugins have been tested and confirmed compatible:

• WooCommerce Product Table Lite (+ PRO)
• Tiered Pricing Table for WooCommerce (+ Premium)
• Measurement Price Calculator for WooCommerce
• Discount Rules for WooCommerce
• YITH WooCommerce Product Add-Ons (+ & Extra Options Premium)
• JetEngine Listing Grid (Elementor)
• Product Add-Ons for WooCommerce
• B2BKing – Ultimate WooCommerce Wholesale and B2B Solution (+ Premium)
• Advanced Product Fields Pro for WooCommerce
• WooCommerce Quantity Discounts, Rules & Swatches
• FacetWP
• Variation Swatches for WooCommerce (+ PRO)
• Variation Price Display Range for WooCommerce (+ PRO)
• WooCommerce Product Add-Ons Ultimate
• Advanced Woo Search (+ PRO)
• B2B Market
• FiboFilters
• Extra Product Options & Add-Ons for WooCommerce
• FiboSearch – Ajax Search for WooCommerce (+ Pro)
• YayMail – WooCommerce Email Customizer
• PDF Invoices & Packing Slips for WooCommerce
• WooCommerce Product Bundles
• LiteSpeed Cache
• Elementor Pro
• YITH WooCommerce Role Based Prices
• WooCommerce Dynamic Pricing and Discount Rules
• Price Based on Country for WooCommerce
• WP Grid Builder

If you encounter any compatibility issues with other plugins or themes, please let us know. Your feedback helps us improve the plugin and extend compatibility to more third-party solutions.

Incompatibility

After multiple attempts to create compatibility functions, reaching out to the plugin developers several times, and still finding no viable solution, the following plugins remain incompatible:

• Unlimited Elements for Elementor (+ Pro): AJAX pagination and filtering issues
• Barn2: WooCommerce Product Options

Additional Information

This plugin is fully open source. You can find the source code on GitHub

For more information and other WordPress plugins, visit Wijnberg Developments.