Samir Sabri

<p><strong>TaxDebug for WooCommerce</strong> helps store owners debug, understand, trust, and report their taxes – especially when using WooCommerce Tax (automated taxes) or other tax calculation services.</p>
<h4>Key Features</h4>
<p><strong>Deep Tax Visibility</strong><br />
* See exactly how taxes were calculated for every order<br />
* View applied tax rates, line-item breakdowns, and calculation formulas<br />
* Understand which service/plugin produced each tax amount (WooCommerce Core, WooCommerce Tax, TaxJar, Avalara)</p>
<p><strong>Issue Detection Engine</strong><br />
* Automatically detect common tax problems:<br />
  * No tax collected where expected<br />
  * Tax charged in non-taxable regions<br />
  * Rate mismatches vs reference rates<br />
  * Missing local (county/city) taxes<br />
  * Tax changes between cart and checkout<br />
  * Suspected API errors</p>
<p><strong>Beautiful Dashboard & Reports</strong><br />
* Modern, responsive admin interface<br />
* Interactive charts showing tax by state, country, and over time<br />
* KPI cards for total tax, taxable sales, and effective rates<br />
* Powerful filtering by date, country, state, tax source, and more</p>
<p><strong>Order Explorer</strong><br />
* Search and filter all orders with tax data<br />
* View detailed tax debug information for any order<br />
* Identify orders with detected issues quickly</p>
<p><strong>Accountant-Friendly Exports</strong><br />
* Export summary reports by country/state<br />
* Export detailed order-level tax breakdowns<br />
* Export detected issues for review<br />
* CSV format compatible with Excel and accounting software</p>
<p><strong>Safe & Non-Intrusive</strong><br />
* Does NOT modify how taxes are calculated<br />
* Only observes, logs, and analyzes tax data<br />
* Works with any tax calculation method</p>
<p><strong>Feedback & Analytics</strong><br />
* In-app feedback widget to report false positives/negatives<br />
* Feature request and success story submissions<br />
* Privacy-first usage analytics (all data stored locally)<br />
* Deactivation survey to help improve TaxDebug<br />
* All feedback stored locally – no external tracking</p>
<h4>Compatibility</h4>
<p>TaxDebug works with:<br />
* WooCommerce Core tax rates<br />
* WooCommerce Tax (automated taxes via TaxJar)<br />
* TaxJar plugin<br />
* Avalara AvaTax<br />
* Other tax plugins</p>
<h4>Requirements</h4>
<ul>
<li>WordPress 5.8 or higher</li>
<li>WooCommerce 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
</ul>
<h3>Privacy</h3>
<p>TaxDebug stores order tax data locally in your WordPress database. This includes:<br />
* Order IDs and dates<br />
* Customer billing/shipping addresses (country, state, city, postcode only)<br />
* Order totals and tax amounts<br />
* Tax calculation details</p>
<p>TaxDebug does NOT:<br />
* Store payment information<br />
* Store full customer names or personal details beyond address location</p>
<p>Data retention can be configured in Settings. You can also manually clear all logs at any time.</p>
<h4>Feedback Collection</h4>
<p>TaxDebug collects optional feedback to improve the plugin:</p>
<ul>
<li><strong>In-app feedback</strong>: Report false positives, false negatives, feature requests, or success stories</li>
<li><strong>Usage analytics</strong>: Anonymous local tracking of which features are used</li>
<li><strong>Deactivation survey</strong>: Optional one-question survey when deactivating</li>
</ul>
<p><strong>Local Storage</strong>: All feedback is always stored locally in your WordPress database.</p>
<p><strong>Optional Remote Sending</strong>: You can opt-in to send anonymous feedback to the developer to help improve TaxDebug. This is <strong>disabled by default</strong> and must be explicitly enabled in Settings.</p>
<h4>What IS Sent (When Opted-In)</h4>
<ul>
<li>Anonymous store UUID (random identifier, NOT your domain)</li>
<li>Feedback type and message</li>
<li>Your email (only if you voluntarily provide it)</li>
<li>Store country and currency</li>
<li>Active tax plugin (e.g., TaxJar, Avalara)</li>
<li>Plugin, WordPress, and WooCommerce versions</li>
<li>Daily aggregated counts: orders logged, issues detected, features used</li>
</ul>
<h4>What is NEVER Sent</h4>
<ul>
<li>Your site URL or domain name</li>
<li>Customer names, emails, or addresses</li>
<li>Order details, totals, or line items</li>
<li>Tax amounts or financial data</li>
<li>Any personally identifiable information (PII)</li>
</ul>
<h4>How to Disable Remote Sending</h4>
<p>Go to <strong>WooCommerce <span aria-hidden="true" class="wp-exclude-emoji">→</span> TaxDebug <span aria-hidden="true" class="wp-exclude-emoji">→</span> Settings</strong> and turn off “Send Anonymous Feedback”. You can do this at any time. Local feedback storage will continue to work.</p>
<h3>Developer Notes</h3>
<h4>Hooks & Filters</h4>
<p>TaxDebug provides several hooks for extensibility:</p>
<p><strong>Actions:</strong><br />
* <code>taxdebug_loaded</code> – Fired when TaxDebug is fully loaded<br />
* <code>taxdebug_order_logged</code> – Fired when an order is logged (params: log_id, order_id, payload)<br />
* <code>taxdebug_installed</code> – Fired on plugin installation<br />
* <code>taxdebug_logs_cleaned_up</code> – Fired when old logs are cleaned up</p>
<p><strong>Filters:</strong><br />
* <code>taxdebug_order_payload</code> – Filter the order payload before logging<br />
* <code>taxdebug_detected_issues</code> – Add custom issue detection rules</p>
<h4>REST API Endpoints</h4>
<p>TaxDebug provides a REST API under the <code>taxdebug/v1</code> namespace:</p>
<ul>
<li><code>GET /logs</code> – Get tax logs with filtering</li>
<li><code>GET /logs/{id}</code> – Get single log</li>
<li><code>GET /logs/order/{order_id}</code> – Get log by order ID</li>
<li><code>POST /logs/reanalyze/{order_id}</code> – Re-analyze an order</li>
<li><code>GET /issues</code> – Get detected issues</li>
<li><code>GET /stats/dashboard</code> – Get dashboard statistics</li>
<li><code>GET /stats/chart/time</code> – Get time series chart data</li>
<li><code>GET /stats/chart/state</code> – Get tax by state data</li>
<li><code>GET /stats/chart/country</code> – Get tax by country data</li>
<li><code>GET /export/summary</code> – Export summary CSV</li>
<li><code>GET /export/detailed</code> – Export detailed CSV</li>
<li><code>GET /export/issues</code> – Export issues CSV</li>
</ul>
<p>All endpoints require <code>manage_woocommerce</code> capability.</p>
<h4>Database Tables</h4>
<p>TaxDebug creates two custom tables:</p>
<ul>
<li><code>{prefix}taxdebug_logs</code> – Stores order tax log data</li>
<li><code>{prefix}taxdebug_issues</code> – Stores detected issues</li>
<li><code>{prefix}taxdebug_feedback</code> – Stores user feedback submissions</li>
<li><code>{prefix}taxdebug_analytics</code> – Stores usage analytics</li>
<li><code>{prefix}taxdebug_error_logs</code> – Stores internal error logs</li>
</ul>
<h4>WP-CLI Commands</h4>
<p>(Coming in future versions)</p>


TaxDebug for WooCommerce

A tax debugging and reporting tool for WooCommerce. Debug tax issues, understand calculations, and generate audit-ready reports.

wijnbergdevelopments

<p>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>
<h3>Key features</h3>
<ul>
<li>Display customizable switches where you want</li>
<li>Gutenberg block support</li>
<li>Shortcode for easy integration (including shortcode generator)</li>
<li>Flexible display options for prices with and without VAT</li>
<li>Remembers the user’s preference for future visits</li>
<li>Choose between a toggle switch or buttons</li>
</ul>
<p>For more information about this plugin, please visit the <a href="https://products.wijnberg.dev/product/wordpress/plugins/tax-switch-for-woocommerce/" rel="nofollow ugc">plugin page</a>.</p>
<h3>Requirements</h3>
<ul>
<li>WooCommerce plugin installed and activated</li>
<li>WooCommerce tax calculations enabled and configured</li>
</ul>
<h3>Configuration</h3>
<p>Configure the plugin settings below for proper functionality.</p>
<h4>WooCommerce settings</h4>
<p>Ensure these WooCommerce settings are configured first:</p>
<ol>
<li>
<p><strong>Configure tax calculations</strong></p>
<ul>
<li>Go to: <em>WooCommerce > Settings > General</em></li>
<li>Verify your shop address is complete</li>
<li>Enable <em>“Enable tax rates and calculations”</em></li>
<li>Set <em>“Default customer location”</em> to <em>“Shop base address”</em></li>
</ul>
</li>
<li>
<p><strong>Set up tax rates</strong></p>
<ul>
<li>Go to: <em>WooCommerce > Settings > Tax > Standard Rates</em></li>
<li>Add your regional tax rates</li>
</ul>
</li>
<li>
<p><strong>Recommended: tax calculation method</strong></p>
<ul>
<li>Go to: <em>WooCommerce > Settings > Tax</em></li>
<li>Set <em>“Calculate tax based on”</em> to <em>“Shop base address”</em><br />
<em>(This provides instant tax calculation. Other methods require customers to enter their address first.)</em></li>
</ul>
</li>
<li>
<p><strong>Individual product configuration</strong></p>
<ul>
<li>Edit products at: <em>Products > [Product]</em></li>
<li>Under <em>Product Data > Tax</em>, set status to <em>“Taxable”</em></li>
</ul>
</li>
</ol>
<h4>Plugin settings</h4>
<p>Configure these plugin-specific settings:</p>
<ol>
<li><strong>Main settings</strong>
<ul>
<li>Go to: <em>WooCommerce > Settings > Tax Switch</em></li>
<li>Set your preferred text values</li>
<li>Optional: Restrict display locations</li>
<li>Optional: Generate a shortcode via <em>WooCommerce > Settings > Tax Switch > Shortcode</em></li>
</ul>
</li>
</ol>
<h3>Usage</h3>
<p>After installation and configuration, you can add the tax switch to your pages in two ways:</p>
<ol>
<li>Use the Gutenberg block “Tax Switch for WooCommerce” in your page or post editor.</li>
<li>Use the shortcode <code>[wdevs_tax_switch]</code> anywhere in your content.</li>
</ol>
<h4>Shortcode Usage</h4>
<p><strong>Switch/buttons</strong></p>
<p>Basic usage:<br />
[wdevs_tax_switch]</p>
<p>Displays a switch to toggle displaying prices including or excluding VAT.</p>
<p>The shortcode accepts several attributes to customize its appearance and behavior:</p>
<ul>
<li><code>class-name</code>: Adds custom CSS classes to the switch.
<ul>
<li>Default: is-style-default</li>
<li>Options: is-style-default, is-style-inline, is-style-flat-pill, or custom classes</li>
</ul>
</li>
<li><code>switch-type</code>: Determines the style of the toggle.
<ul>
<li>Default: <code>switch</code></li>
<li>Options: <code>switch</code>, <code>buttons</code></li>
</ul>
</li>
<li><code>switch-color</code>: Sets the color of the switch handle.</li>
<li><code>switch-color-checked</code>: Sets the color of the switch when it’s in the “on” position.</li>
<li><code>switch-background-color</code>: Sets the background color of the switch.</li>
<li><code>switch-text-color</code>: Sets the text color of the switch labels.</li>
<li><code>switch-background-color-checked</code>: Sets the background color of the switch when it’s in the “on” position.</li>
<li><code>switch-label-incl</code>: Sets the text for the “including VAT” label.
<ul>
<li>Default: Uses the text set in the plugin settings or “Incl. VAT” if not set.</li>
</ul>
</li>
<li><code>switch-label-excl</code>: Sets the text for the “excluding VAT” label.
<ul>
<li>Default: Uses the text set in the plugin settings or “Excl. VAT” if not set.</li>
</ul>
</li>
<li><code>switch-aria-label</code>: Sets the aria label of the switch.
<ul>
<li>Default: Uses the text set in the plugin settings or “Switch between prices including and excluding VAT” if not set.</li>
</ul>
</li>
</ul>
<p>Example with custom attributes:</p>
<pre><code>[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"]
</code></pre>
<p><strong>Label</strong></p>
<p>Basic usage:<br />
[wdevs_tax_switch_label]</p>
<p>Displays text indicating the currently selected tax setting. The text updates automatically when the tax switch is toggled.</p>
<p>The shortcode accepts several attributes to customize its appearance and behavior:</p>
<ul>
<li><code>class-name</code>: Adds custom CSS classes to the label.
<ul>
<li>Default: is-style-default</li>
<li>Options: is-style-default or custom classes</li>
</ul>
</li>
<li><code>label-text-incl</code>: Sets the text to display when “including VAT” is selected.
<ul>
<li>Default: Uses the text set in the plugin settings or “Incl. VAT” if not set.</li>
</ul>
</li>
<li><code>label-text-excl</code>: Sets the text to display when “excluding VAT” is selected.
<ul>
<li>Default: Uses the text set in the plugin settings or “Excl. VAT” if not set.</li>
</ul>
</li>
<li><code>label-text-color</code>: Sets the “excluding VAT” text color.</li>
<li><code>label-text-color-checked</code>: Sets the “including VAT” text color.</li>
</ul>
<p>Example with custom attributes:</p>
<pre><code>[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"]
</code></pre>
<h4>PHP implementation</h4>
<p>You can use these shortcodes with PHP with the do_shortcode() function:</p>
<pre><code><?php echo do_shortcode('[wdevs_tax_switch]'); ?>
<?php echo do_shortcode('[wdevs_tax_switch_label]'); ?>
</code></pre>
<h4>JavaScript events</h4>
<p>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>
<pre><code>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
 });
</code></pre>
<p>If you are loading the switch dynamically (via AJAX), dispatch this event after rendering to initialize the component:</p>
<pre><code>   document.dispatchEvent( new CustomEvent('wdevs-tax-switch-appeared') );
</code></pre>
<h3>WPML</h3>
<p>To translate the option texts via WPML:</p>
<ol>
<li>Save your options first in: WooCommerce -> Settings -> Tax Switch</li>
<li>Then translate the texts in: WPML -> String Translations and search for your option values in the domain ‘tax-switch-for-woocommerce’</li>
</ol>
<h3>Compatibility</h3>
<p>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.</p>
<p>The following themes have been tested and confirmed compatible:</p>
<ul>
<li>GeneratePress</li>
<li>Blocksy</li>
<li>Thrive</li>
<li>Flatsome</li>
<li>Kapee</li>
<li>Entr</li>
<li>Woodmart</li>
<li>Hello Elementor</li>
</ul>
<p>The following plugins have been tested and confirmed compatible:</p>
<ul>
<li>WooCommerce Product Table Lite (+ PRO)</li>
<li>Tiered Pricing Table for WooCommerce (+ Premium)</li>
<li>Measurement Price Calculator for WooCommerce</li>
<li>Discount Rules for WooCommerce</li>
<li>YITH WooCommerce Product Add-Ons (+ & Extra Options Premium)</li>
<li>JetEngine Listing Grid (Elementor)</li>
<li>Product Add-Ons for WooCommerce</li>
<li>B2BKing – Ultimate WooCommerce Wholesale and B2B Solution (+ Premium)</li>
<li>Advanced Product Fields Pro for WooCommerce</li>
<li>WooCommerce Quantity Discounts, Rules & Swatches</li>
<li>FacetWP</li>
<li>Variation Swatches for WooCommerce (+ PRO)</li>
<li>Variation Price Display Range for WooCommerce (+ PRO)</li>
<li>WooCommerce Product Add-Ons Ultimate</li>
<li>Advanced Woo Search (+ PRO)</li>
<li>B2B Market</li>
<li>FiboFilters</li>
<li>Extra Product Options & Add-Ons for WooCommerce</li>
<li>FiboSearch – Ajax Search for WooCommerce (+ Pro)</li>
<li>YayMail – WooCommerce Email Customizer</li>
<li>PDF Invoices & Packing Slips for WooCommerce</li>
<li>WooCommerce Product Bundles</li>
<li>LiteSpeed Cache</li>
<li>Elementor Pro</li>
<li>YITH WooCommerce Role Based Prices</li>
<li>WooCommerce Dynamic Pricing and Discount Rules</li>
<li>Price Based on Country for WooCommerce</li>
<li>WP Grid Builder</li>
</ul>
<p>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>
<h3>Incompatibility</h3>
<p>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>
<ul>
<li>Unlimited Elements for Elementor (+ Pro): AJAX pagination and filtering issues</li>
<li>Barn2: WooCommerce Product Options</li>
</ul>
<h3>Additional Information</h3>
<p>This plugin is fully open source. You can find the source code on <a href="https://github.com/Paulsky/tax-switch" rel="nofollow ugc">GitHub</a></p>
<p>For more information and other WordPress plugins, visit <a href="https://products.wijnberg.dev/product-category/wordpress/plugins/" rel="nofollow ugc">Wijnberg Developments</a>.</p>


Tax Switch for WooCommerce

Let customers toggle between inclusive and exclusive VAT pricing in your WooCommerce store.

TaxDebug for WooCommerce vs Tax Switch for WooCommerce