內容簡介
Tax Switch for WooCommerce 讓顧客可在含稅與未稅價格之間自由切換顯示，提供可自訂的切換元件與多種顯示方式，同時記住使用者偏好設定，提升購物體驗與價格透明度。
【主要功能】
• 可自訂切換元件，支援切換開關與按鈕兩種樣式
• 支援 Gutenberg 區塊編輯器直接插入
• 提供短代碼（Shortcode）及短代碼產生器方便整合
• 自動記住使用者的含稅/未稅顯示偏好
• 彈性的價格顯示選項，可自訂顏色與標籤文字
• 可限制切換元件的顯示位置
外掛標籤
開發者團隊
📦 歷史版本下載
原文外掛簡介
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:
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”
Set up tax rates
Go to: WooCommerce > Settings > Tax > Standard Rates
Add your regional tax rates
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.)
Individual product configuration
Edit products at: Products > [Product]
Under Product Data > Tax, set status to “Taxable”
Plugin settings
Configure these plugin-specific settings:
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:
Use the Gutenberg block “Tax Switch for WooCommerce” in your page or post editor.
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:
Save your options first in: WooCommerce -> Settings -> Tax Switch
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.
