About this plugin
Many US states hold an annual sales tax holiday — a “tax free weekend” during which certain products under a price threshold are exempt from sales tax (for example, Texas exempts qualifying items priced under $100 during its August holiday).
This plugin automates that for WooCommerce. While the promotion is enabled, on the days you select, products at or under your price cap that ship to your selected states are not charged sales tax. Everything else in the cart is taxed normally — mixed carts are handled per line item.
Features
- Master toggle — turn the promotion on and off with one checkbox.
- Day selection — pick which days of the week the exemption applies (e.g. Friday–Sunday), evaluated in your site’s timezone.
- Auto-shutoff date — optionally set a date after which the promotion deactivates automatically (it stays active through the end of that date). Leave it blank to keep it enabled until you turn it off.
- Price cap — items at or under this price qualify (default 99.99, matching “under $100” rules). Compared per unit against the active (sale) price, pre-tax.
- Multiple states — select one or more US states; the exemption applies when the customer’s taxable (shipping) address is in one of them.
- Product exclusions — search and exclude specific products or variations.
- Category exclusions — exclude whole product categories; subcategories are excluded automatically.
- Customer savings message — an optional banner on the cart and checkout pages tells customers exactly how much sales tax they’re saving (e.g. “you’re saving $8.25”), computed from your real tax rates. Classic cart/checkout templates only.
- Order audit trail — exempt line items and orders are flagged with hidden meta ( _rbtfw_exempt, _rbtfw_applied ) so you can report on holiday sales later.
- Admin warning notice — while the promotion is enabled, a persistent notice in wp-admin reminds you that tax is not being charged on qualifying items.
- Performance-first — zero database queries added to the storefront; all checks run from one autoloaded option in memory.
- WP-CLI — wp rbtfw status and wp rbtfw check <product_id> [--state=TX] [--day=saturday] let you dry-run eligibility without waiting for the weekend.
- HPOS (High-Performance Order Storage) compatible.
How it works
Eligible items are assigned WooCommerce’s built-in Zero rate tax class at calculation time. WooCommerce then handles mixed carts, refunds, order taxes, and tax reports natively — this plugin never performs its own totals math and never modifies your tax rate tables.
Developer filters
- rbtfw_is_product_eligible — final say on a product’s eligibility after all built-in rules pass.
- rbtfw_taxable_location — override the [ country, state ] used for the destination check.
- rbtfw_now — override the “current” datetime (used by the WP-CLI dry-run, handy in tests).