Appearance
Upgrading to 2.0
2.0.0 is a major release. Most sites update without changes, but read this page before you update: it lists what you have to check in your settings and templates. All changes are in the changelog.
You can update directly from any 1.x version, follow the update instructions. Make a backup of the files and the database first, and test the update on a copy of your site when you can.
Requirements
2.0.0 requires ExpressionEngine 7.3+, PHP 8.2+ and Reinos Store 4.0.0+. For ExpressionEngine 6 and lower use the legacy package in the download (legacy/ee_reinos_store_tax-v1.4.0.zip). cURL is no longer required.
Update Reinos Store to 4.0.0 or later first, see Upgrading to 4.0 of the Store. The install and the update check the Store version, and the control panel pages of this module as well: without Reinos Store 4.0.0 the module is not installed or updated and the control panel shows a message.
Check your settings
Reverse charge
If you use the EU reverse charge, check these settings after the update:
- The reverse charge is only applied when Reverse charge VAT for EU store owners is enabled. Check that this setting is enabled.
- That setting needs the new Store country of the Store settings (Store 4.0.0): set it to the country your store is based in. Without a Store country the reverse charge is not applied.
- The reverse charge is only applied when the customer filled in a company name (it is not compared with the name in VIES), when the billing country is the country of the tax number, and not to business customers from the Store country. They are charged the normal tax.
See EU reverse charge for all conditions.
No Tax
The "No Tax" option of Tax calculation is removed. The Store changes it to "Exclusive", which it already worked like, so the prices stay the same. To charge no tax at all, turn off the Calculate tax setting.
Check your templates
- With the reverse charge,
{cart:tax_details}has no rows anymore (an order shows one 0% row). Use{if cart:is_reverse_charge_eu}to show a reverse charge notice instead. - The unused
{reinos_store_tax_action_url},{reinos_store_tax_selected_country},{reinos_store_tax_pickup_enabled}and{reinos_store_tax_ship_to_address_enabled}global variables are removed. Remove them from your templates. - The
{exp:reinos_store_tax:countries}tag is removed, it never worked. Use the country_list tag of the Store instead.
After the update
- The EU import had outdated rates for Estonia (24%, low 13%), Finland (25.5%, low 13.5%), Lithuania (low 12%), Luxembourg (17%), Romania (21%, low 11%) and Slovakia (23%, low 19%). Import the EU rules again to update the existing rules; changes you made to their rates are overwritten. See Import Tax Rules
- Importing the Canada tax rules again added every province again. When you did, delete the duplicates of the earlier import by hand.
- The settings moved to the add-on's main page in the CP (was
addons/settings/reinos_store_tax/settings), and a tax rule is added or edited atruleandrule/<id>(wasrules/0andrules/<id>). Update your bookmarks.
For developers
When you have your own add-on or custom code that uses Store Tax:
- The
reinos_store_save_cart_detailshook is removed, it didn't change anything. The Store (4.0.0) saves the tax of the moment of the checkout on the order items. - The unused
cp_js_endhook and the action behind the global variables are removed. The tables are created by migrations, and the hooks are registered by ExpressionEngine.
