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.<\/p>\n
For more information about this plugin, please visit the plugin page<\/a>.<\/p>\n Configure the plugin settings below for proper functionality.<\/p>\n Ensure these WooCommerce settings are configured first:<\/p>\n Configure tax calculations<\/strong><\/p>\n Set up tax rates<\/strong><\/p>\n Recommended: tax calculation method<\/strong><\/p>\n Individual product configuration<\/strong><\/p>\n Configure these plugin-specific settings:<\/p>\n After installation and configuration, you can add the tax switch to your pages in two ways:<\/p>\n Switch\/buttons<\/strong><\/p>\n Basic usage: Displays a switch to toggle displaying prices including or excluding VAT.<\/p>\n The shortcode accepts several attributes to customize its appearance and behavior:<\/p>\n Example with custom attributes:<\/p>\n Label<\/strong><\/p>\n Basic usage: Displays text indicating the currently selected tax setting. The text updates automatically when the tax switch is toggled.<\/p>\n The shortcode accepts several attributes to customize its appearance and behavior:<\/p>\n Example with custom attributes:<\/p>\n You can use these shortcodes with PHP with the do_shortcode() function:<\/p>\n 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.<\/p>\n If you are loading the switch dynamically (via AJAX), dispatch this event after rendering to initialize the component:<\/p>\n To translate the option texts via WPML:<\/p>\n This plugin integrates with WooCommerce\u2019s 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.<\/p>\n The following themes have been tested and confirmed compatible:<\/p>\n The following plugins have been tested and confirmed compatible:<\/p>\n 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.<\/p>\n 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:<\/p>\n This plugin is fully open source. You can find the source code on GitHub<\/a><\/p>\nRequirements<\/h3>\n
\n
Configuration<\/h3>\n
WooCommerce settings<\/h4>\n
\n
\n
\n
\n
\n(This provides instant tax calculation. Other methods require customers to enter their address first.)<\/em><\/li>\n<\/ul>\n<\/li>\n\n
Plugin settings<\/h4>\n
\n
\n
Usage<\/h3>\n
\n
[wdevs_tax_switch]<\/code> anywhere in your content.<\/li>\n<\/ol>\nShortcode Usage<\/h4>\n
\n[wdevs_tax_switch]<\/p>\n\n
class-name<\/code>: Adds custom CSS classes to the switch.\n\n
switch-type<\/code>: Determines the style of the toggle.\n\n
switch<\/code><\/li>\nswitch<\/code>, buttons<\/code><\/li>\n<\/ul>\n<\/li>\nswitch-color<\/code>: Sets the color of the switch handle.<\/li>\nswitch-color-checked<\/code>: Sets the color of the switch when it\u2019s in the \u201con\u201d position.<\/li>\nswitch-background-color<\/code>: Sets the background color of the switch.<\/li>\nswitch-text-color<\/code>: Sets the text color of the switch labels.<\/li>\nswitch-background-color-checked<\/code>: Sets the background color of the switch when it\u2019s in the \u201con\u201d position.<\/li>\nswitch-label-incl<\/code>: Sets the text for the \u201cincluding VAT\u201d label.\n\n
switch-label-excl<\/code>: Sets the text for the \u201cexcluding VAT\u201d label.\n\n
[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\"]\n<\/code><\/pre>\n
\n[wdevs_tax_switch_label]<\/p>\n\n
class-name<\/code>: Adds custom CSS classes to the label.\n\n
label-text-incl<\/code>: Sets the text to display when \u201cincluding VAT\u201d is selected.\n\n
label-text-excl<\/code>: Sets the text to display when \u201cexcluding VAT\u201d is selected.\n\n
label-text-color<\/code>: Sets the \u201cexcluding VAT\u201d text color.<\/li>\nlabel-text-color-checked<\/code>: Sets the \u201cincluding VAT\u201d text color.<\/li>\n<\/ul>\n[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\"]\n<\/code><\/pre>\nPHP implementation<\/h4>\n
\n\n<\/code><\/pre>\nJavaScript events<\/h4>\n
document.addEventListener('wdevs-tax-switch-changed', function(event) {\n console.log(event.detail);\n \/\/ event.detail contains:\n \/\/ - isSwitched: boolean - the raw switch state\n \/\/ - displayIncludingVat: boolean - whether prices now display including VAT\n });\n<\/code><\/pre>\n document.dispatchEvent( new CustomEvent('wdevs-tax-switch-appeared') );\n<\/code><\/pre>\nWPML<\/h3>\n
\n
Compatibility<\/h3>\n
\n
\n
Incompatibility<\/h3>\n
\n
Additional Information<\/h3>\n