Mandatory VAT/Tax ID Option

v1.3.1 Rev 02 Sept 2021

Overview

Mandatory VAT/Tax ID Option helps you to change telephone, fax, company or VAT/Tax ID field become a mandatory field. Both storefront and admin are changed
You need to validate the VAT ID manually, you can validate it here.  And the IBAN here.

AbanteCart v1.3.1 use Mandatory VAT/Tax ID Option v1.3.1. Tested up to PHP 8.0.
AbanteCart v1.3.0 use Mandatory VAT/Tax ID Option v1.3.0.1. Tested up to PHP 8.0.
AbanteCart v1.2.16 use Mandatory VAT/Tax ID Option v1.2.16.4. Tested up to PHP 7.4.
AbanteCart v1.2.15 use Mandatory VAT/Tax ID Option v1.2.15.4.
AbanteCart v1.2.10 – v1.2.13 use Mandatory VAT/Tax ID Option v1.2.10.3.
AbanteCart v1.2.9 use Mandatory VAT/Tax ID Option v1.2.9.3.
AbanteCart v1.2.0 – v1.2.8 use Mandatory VAT/Tax ID Option v1.2.6.7.

Important Notes for AbanteCart v1.2.16:
This extension works with default checkout only. If you are using the Fast Checkout extension and want to require a phone you will need to enable it within that extension.
Important Notes for AbanteCart v1.3.0 and you are using the Fast Checkout extension:
1. If you want to require a phone you will need to enable it within that extension.
2. The fields other than the fax are only shown only if the “Turn ON if you require customer or guest to enter their xxxx” field is turned ON.
Important Notes:
1. Starting with extension v1.2.15 we have adopted a license key for all our extensions. Your extension will only work if you have a validated license key entered for the location where your extension is installed. Refer to here for more details on how license keys work.
2. AbanteCart v1.2.14 is extremely problematic. Install Patch files or better to update to 1.2.15.
Important Notes:
The core/lib/package_manager.php file in some AbanteCart versions must be replaced. Please check the details and find the download here . This should be done PRIOR to install/update of this extension v1.2.7.4.
You must replace the file for each of the listed versions with each AbanteCart update – eg. currently using v1.2.6 and have the replacement file – when you update to v1.2.7, you will need to replace with the patch file for v1.2.7.

Setup

1. Turn ON to use the extension.

Important Notes: If you already have an account in our support system and you are using multiple WHY2 extensions, you do NOT need to create another account in the support system.

2. Enter your WHY2 license code. Refer to How to obtain license code section for more information.
3. Turn ON if you require customer or guest to enter their phone number.
4. Turn ON if you require customer or guest to enter their fax number.
5. Enter the text that will be used for the fax field information.
6. Turn ON if you require customer or guest to enter their company name.
7. Enter the text that will be used for the company field information.
8. Turn ON if you require customer or guest to enter their VAT/Tax ID.
9. Enter the text that will be used for the VAT/Tax ID field information.
10. Turn ON to add the registration number field.
11. Turn ON if you require customer or guest to enter their Company/Personal registration number.
12. Enter the text that will be used for the Company/Personal field information.
13. Turn ON to add the Bank Name field.
14. Turn ON if you require customer or guest to enter their Bank Name.
15. Enter the text that will be used for the Bank Name field information.
16. Turn ON to add the Bank Address field.
17. Turn ON if you require customer or guest to enter their Bank Address.
18. Enter the text that will be used for the Bank Address field information.
19. Turn ON to add the IBAN Code field.
20. Turn ON if you require customer or guest to enter their IBAN Code.
21. Enter the text that will be used for the IBAN Code field information.
22. Turn ON to add the SWIFT Code field.
23. Turn ON if you require customer or guest to enter their SWIFT Code.
24. Enter the text that will be used for the SWIFT Code field information.
25. Turn ON to show the VAT/Tax ID text in the order confirmation email / invoice page.
26. Enter your desired text, if any, to precede the VAT/Tax ID number on the order confirmation email to customer.
27. Turn ON to show the Registration Number text in the order confirmation email / invoice page.
28. Enter your desired text, if any, to precede the Registration Number on the order confirmation email to customer.
29. Turn ON to show the Bank Name text in the order confirmation email / invoice page.
30. Enter your desired text, if any, to precede the Bank Name on the order confirmation email to customer.
31. Turn ON to show the Bank Address text in the order confirmation email / invoice page.
32. Enter your desired text, if any, to precede the Bank Address on the order confirmation email to customer.
33. Turn ON to show the IBAN text in the order confirmation email / invoice page.
34. Enter your desired text, if any, to precede the IBAN code on the order confirmation email to customer.
35. Turn ON to show the SWIFT text in the order confirmation email / invoice page.
36. Enter your desired text, if any, to precede the SWIFT code on the order confirmation email to customer.
37. Turn ON if you want to show your company information in order confirmation email.
38. Enter your company info (name, address, phone, VAT/Tax ID, etc.) you want to be shown in the order confirmation email and admin invoice page.
39. You can leave it blank if you don’t want to set the extension run order.

Backup of previous modified email template

Important Notes: This is only available in AbanteCart v1.2.16 or higher Design > Email Templates only.

For Vat Tax ID to add the additional fields into the default storefront_order-confirm and the default storefront_order_confirm_notify_admin email templates we have modified those two templates. We have made a backup of the default templates for comparison. You can access the backup files via your cPanel file Manager.

If you previously modified either of those templates you will need to re-do the modification on the new templates required by the extension. This is done after installing the extension or each time you update the extension.

Step 1. Open cPanel and you should see:


1.Click the File Manager.

Step 2. After click the File Manager you should see:

2. Click public_html

3. Click the installation folder (if you are installing AbanteCart in the root folder, you can directly go to number 4).

4. Click taxid_option_email_template_backup and you will see the backup files.

5. There are 6 files that was backed up upon extension installation and we append the current date and time at the end of the email template text id and block name:

a.  storefront_order_confirm_admin_notify_allowed_placeholders: This is the backup of Allowed Placeholders field in storefront_order_confirm_admin_notify.

b. storefront_order_confirm_admin_notify_html_body: This is the backup of HTML Body field in storefront_order_confirm_admin_notify.

c. storefront_order_confirm_admin_notify_text_body: This is the backup of Text Body field in storefront_order_confirm_admin_notify.

d. storefront_order_confirm_allowed_placeholders: This is the backup of Allowed Placeholders field in storefront_order_confirm.

e. storefront_order_confirm_html_body: This is the backup of HTML Body field in storefront_order_confirm.

f. storefront_order_confirm_text_body: This is the backup of Text Body field in storefront_order_confirm.

Tax ID Default email templates

Important Notes: This is only available in AbanteCart v1.2.16 or higher Design > Email Templates only.

We have add several tag within storefront_order_confirm and storefront_order_confirm_admin_notify. Please don’t delete them. And in case you accidently delete the tag, you can copy the code from the following sections below.

Storefront Order Confirm (storefront_order_confirm)

HTML Body - *PRIOR TO* VAT/Tax ID Option v1.2.16.2

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong><br/>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>”

2.Copy

“<td class=”align_left” style=”width: 200px;padding-bottom: 85px;”>
{{# seller_info }}
<br>
<strong>Ordered From:<br> {{{ seller_info }}}</strong>
{{/ seller_info }}
</td>”

and paste under

“{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>”

3. Copy

“{{# taxid }}
{{ taxid }} <br/>
{{/ taxid  }}
{{# registration }}
{{ registration }} <br/>
{{/ registration }}
{{# bank_name }}
{{ bank_name }} <br/>
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }} <br/>
{{/ bank_address }}
{{# iban }}
{{ iban }} <br/>
{{/ iban }}
{{# swift }}
{{ swift }} <br/>
{{/ swift }}”

and paste under

“{{# payment_data }}
{{ firstname }} {{lastname}} <br/>
{{# company }}
{{{ company }}} <br/>
{{/ company }}
{{# address_1 }}
{{{ address_1 }}} <br/>
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}} <br/>
{{/ address_2 }}
{{{ city }}} {{{ postcode }}} <br/>
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}”

Please refer to below screenshot.

HTML Body - VAT/Tax ID Option v1.2.16.2+

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong><br/>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>”

2. Replace

“<td class=”align_left”>
Order ID: <span style=”color: #069; font-weight: bold;”>{{ order_id }}</span><br/>
Date Ordered: {{ date_added }}<br>
Payment Method: <strong>{{ payment_method }}</strong><br/>
Shipping Method: <strong>{{ shipping_method }}</strong><br/>
<br/>
Email: <strong>{{ customer_email }}</strong><br/>
Telephone: <strong>{{ customer_telephone }}</strong><br/>
{{# customer_mobile_phone }}
Telephone: <strong>{{ customer_mobile_phone }}</strong><br/>
{{/ customer_mobile_phone }}
{{# customer_fax }}
Fax: <strong>{{ customer_fax }}</strong><br/>
{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>”

with

“<td class=”align_left”>
<table style=”width: 100%;”>
<tr>
<td style=”width: 60%;”>
Order ID: <span
style=”color: #069; font-weight: bold;”>{{ order_id }}</span><br/>
Date Ordered: {{ date_added }}<br>
Payment Method: <strong>{{ payment_method }}</strong><br/>
Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>
<br/>
</td>
<td style=”width: 40%;”>
{{# seller_info }}
<strong>Ordered From:<br> {{{ seller_info }}}</strong>
{{/ seller_info }}
</td>
</tr>
</table>
<table style=”width: 100%;”>
<tr>
<td style=”width: 60%;”>
Email: <strong>{{ customer_email }}</strong><br/>
Telephone: <strong>{{ customer_telephone }}</strong><br/>
{{# customer_mobile_phone }}
Telephone: <strong>{{ customer_mobile_phone }}</strong><br/>
{{/ customer_mobile_phone }}
{{# customer_fax }}
Fax: <strong>{{ customer_fax }}</strong><br/>
{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>
</tr>
</table>
</td>”

Please refer to below screenshot.

3. Copy

“{{# taxid }}
{{ taxid }} <br/>
{{/ taxid  }}
{{# registration }}
{{ registration }} <br/>
{{/ registration }}
{{# bank_name }}
{{ bank_name }} <br/>
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }} <br/>
{{/ bank_address }}
{{# iban }}
{{ iban }} <br/>
{{/ iban }}
{{# swift }}
{{ swift }} <br/>
{{/ swift }}”

and paste under

“{{# payment_data }}
{{ firstname }} {{lastname}} <br/>
{{# company }}
{{{ company }}} <br/>
{{/ company }}
{{# address_1 }}
{{{ address_1 }}} <br/>
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}} <br/>
{{/ address_2 }}
{{{ city }}} {{{ postcode }}} <br/>
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}”

Please refer to below screenshot.

Text Body

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong>”

2. Copy
“{{# seller_info }}
Ordered From:<br> {{{ seller_info }}}
{{/ seller_info }}
</td>”and paste under”IP Address:<strong>{{ customer_ip }}</strong>”3. Copy

“{{# taxid }}
{{ taxid }}
{{/ taxid }}
{{# registration }}
{{ registration }}
{{/ registration }}
{{# bank_name }}
{{ bank_name }}
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }}
{{/ bank_address }}
{{# iban }}
{{ iban }}
{{/ iban }}
{{# swift }}
{{ swift }}
{{/ swift }}”

and paste under

{{# payment_data }}
{{ firstname }} {{lastname}}
{{# company }}
{{{ company }}}
{{/ company }}
{{# address_1 }}
{{{ address_1 }}}
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}}
{{/ address_2 }}
{{{ city }}} {{{ postcode }}}
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}

Please refer to below screenshot.

Allowed Placeholders

Copy “seller_info” and paste behind text_project_label,“

Please refer to below screenshot.

Storefront Order Confirm Admin Notify (storefront_order_confirm_admin_notify)

HTML Body - *PRIOR TO* VAT/Tax ID Option v1.2.16.2

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong><br/>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>”

2.Copy

“<td class=”align_left” style=”width: 300px;padding-bottom: 98px;”>
{{# seller_info }}
<br>
<strong>Ordered From:<br> {{{ seller_info }}}</strong>
{{/ seller_info }}
</td>”

and paste under

“{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>”

3. Copy

“{{# taxid }}
{{ taxid }} <br/>
{{/ taxid  }}{{# registration }}
{{ registration }} <br/>
{{/ registration }}
{{# bank_name }}
{{ bank_name }} <br/>
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }} <br/>
{{/ bank_address }}
{{# iban }}
{{ iban }} <br/>
{{/ iban }}
{{# swift }}
{{ swift }} <br/>
{{/ swift }}”

and paste under

“{{# payment_data }}
{{ firstname }} {{lastname}} <br/>
{{# company }}
{{{ company }}} <br/>
{{/ company }}
{{# address_1 }}
{{{ address_1 }}} <br/>
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}} <br/>
{{/ address_2 }}
{{{ city }}} {{{ postcode }}} <br/>
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}”

Please refer to below screenshot.

HTML Body - VAT/Tax ID Option v1.2.16.2+

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong><br/>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>”

2. Replace

“<td class=”align_left”>
Order ID: <span style=”color: #069; font-weight: bold;”>{{ order_id }}</span><br/>
Date Ordered: {{ date_added }}<br>
Payment Method: <strong>{{ payment_method }}</strong><br/>
Shipping Method: <strong>{{ shipping_method }}</strong><br/>
<br/>
Email: <strong>{{ customer_email }}</strong><br/>
Telephone: <strong>{{ customer_telephone }}</strong><br/>
{{# customer_mobile_phone }}
Telephone: <strong>{{ customer_mobile_phone }}</strong><br/>
{{/ customer_mobile_phone }}
{{# customer_fax }}
Fax: <strong>{{ customer_fax }}</strong><br/>
{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>”

with

“<td class=”align_left”>
<table style=”width: 100%;”>
<tr>
<td style=”width: 60%;”>
Order ID: <span
style=”color: #069; font-weight: bold;”>{{ order_id }}</span><br/>
Date Ordered: {{ date_added }}<br>
Payment Method: <strong>{{ payment_method }}</strong><br/>
Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>
<br/>
</td>
<td style=”width: 40%;”>
{{# seller_info }}
<strong>Ordered From:<br> {{{ seller_info }}}</strong>
{{/ seller_info }}
</td>
</tr>
</table>
<table style=”width: 100%;”>
<tr>
<td style=”width: 60%;”>
Email: <strong>{{ customer_email }}</strong><br/>
Telephone: <strong>{{ customer_telephone }}</strong><br/>
{{# customer_mobile_phone }}
Telephone: <strong>{{ customer_mobile_phone }}</strong><br/>
{{/ customer_mobile_phone }}
{{# customer_fax }}
Fax: <strong>{{ customer_fax }}</strong><br/>
{{/ customer_fax }}
IP Address:<strong>{{ customer_ip }}</strong>
</td>
</tr>
</table>
</td>”

Please refer to below screenshot.

3. Copy

“{{# taxid }}
{{ taxid }} <br/>
{{/ taxid  }}
{{# registration }}
{{ registration }} <br/>
{{/ registration }}
{{# bank_name }}
{{ bank_name }} <br/>
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }} <br/>
{{/ bank_address }}
{{# iban }}
{{ iban }} <br/>
{{/ iban }}
{{# swift }}
{{ swift }} <br/>
{{/ swift }}”

and paste under

“{{# payment_data }}
{{ firstname }} {{lastname}} <br/>
{{# company }}
{{{ company }}} <br/>
{{/ company }}
{{# address_1 }}
{{{ address_1 }}} <br/>
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}} <br/>
{{/ address_2 }}
{{{ city }}} {{{ postcode }}} <br/>
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}”

Please refer to below screenshot.

Text Body

1. Replace “Shipping Method: <strong>{{ shipping_method }}</strong>” with “Shipping Method: <strong>{{{ shipping_method }}}</strong><br/>”

2. Copy
“{{# seller_info }}
Ordered From:<br> {{{ seller_info }}}
{{/ seller_info }}
</td>”and paste under”IP Address:<strong>{{ customer_ip }}</strong>”

3. Copy

“{{# taxid }}
{{ taxid }}
{{/ taxid  }}{{# registration }}
{{ registration }}
{{/ registration }}
{{# bank_name }}
{{ bank_name }}
{{/ bank_name }}
{{# bank_address }}
{{ bank_address }}
{{/ bank_address }}
{{# iban }}
{{ iban }}
{{/ iban }}
{{# swift }}
{{ swift }}
{{/ swift }}”

and paste under

{{# payment_data }}
{{ firstname }} {{lastname}}
{{# company }}
{{{ company }}}
{{/ company }}
{{# address_1 }}
{{{ address_1 }}}
{{/ address_1 }}
{{# address_2 }}
{{{ address_2 }}}
{{/ address_2 }}
{{{ city }}} {{{ postcode }}}
{{# zone }}
{{{ zone }}} <br/>
{{/ zone }}
{{{ country }}}

Please refer to below screenshot.

Allowed Placeholders

Copy “seller_info” and paste behind “order_total,“

Please refer to below screenshot.

Extension Updater

To assist you in always having the most current and correct version of your extension we have added a feature to notify you in the message section of your admin panel. And directly allow you to update this extension.

After you have installed Mandatory VAT/Tax ID Option v1.2.15.2 or v1.2.16 or higher the feature will be available.

For details on how the Extension Updater works click here.

For information on support and updates fees check our KB here.

Changelog

v1.3.1

2021 – 09 – 02

Support AbanteCart v1.3.1

v1.3.0.1

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.3.0

2021 – 05 – 08

Support AbanteCart v1.3.0

v1.2.16.4

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.2.16.3

2021 – 05 – 08

changesEnable version checker in the extension to recognize the new version series v 1.3.x introduced to AbanteCart.

v1.2.16.2

2021 – 03 – 29

changesChange AbanteCart v1.2.16 default customer order confirmation and admin order notification html body.

featureSupport WHY2 Delivery Scheduler extension.

v1.2.16.1

2020 – 12 – 28

featureImplement support expiration date.

v1.2.16

2020 – 08 – 31

Support AbanteCart v1.2.16.

v1.2.15.4

2021 – 06 – 03

bug-fixFix incorrect available extension version checker.

v1.2.15.3

2020 – 12 – 28

featureImplement support expiration date.

v1.2.15.2

2020 – 08 – 31

changesChange manual URL

bug-fixFix missing additional customer info fields in customer edit account page.

featureImplement built in extension updater.

v1.2.15.1

2020 – 04 – 29

bug-fixFix “Call to a member function verifyMailchimp() on null in extensions/taxid_option/core/taxid_option.php on line 1439“

v1.2.15

2019 – 06 – 17

Support AbanteCart v1.2.15.

v1.2.10.2

2018 – 08 – 31

Support PHP v5.3 – v7.2.
Support AbanteCart v1.2.13.

v1.2.10.1

2018 – 02 – 19

bug-fixFix missing company error message in Sale – Customer address page when admin quick save empty company name if admin turn ON required for company field.

featureAdd NA or NONE as an option for IBAN and SWIFT CODE.

Support AbanteCart v1.2.11-v1.2.12

v1.2.10

2017 – 04 – 28

Support AbanteCart v1.2.10

v1.2.9.3

2018 – 02 – 19

bug-fixFix missing company error message in Sale – Customer address page when admin quick save empty company name if admin turn ON required for company field.

featureAdd NA or NONE as an option for IBAN and SWIFT CODE.

v1.2.9.2

2017 – 04 – 28

bug-fix1. Option link url not correctly changed into clickable URL.
2. Wrong column name.
3. Use pricing calculator cart and order library if pricing calculator is turned on.
4. Use option link pro cart and order library if option link pro is turned on.
5. Remove extra product options new line in checkout confirm page.
6. Newsletter subscribers are not added to Constant Contact and MailChimp if Mandatory VAT/Tax ID Option extension is installed after Constant Contact and MailChimp.

v1.2.9.1

2017 – 03 – 18

bug-fixRemove extra new line for product options in checkout confirm, order confirm email.

featureUse whitelabel extension custom email footer if whitelabel is installed and turned on.

v1.2.9

2017 – 02 – 14

Support AbanteCart v1.2.9

v1.2.6.7

2018 – 02 – 19

bug-fixFix missing company error message in Sale – Customer address page when admin quick save empty company name if admin turn ON required for company field.

featureAdd NA or NONE as an option for IBAN and SWIFT CODE.

v1.2.6.6

2017 – 04 – 28

bug-fix1. Option link url not correctly changed into clickable URL.
2. Wrong column name.
3. Use pricing calculator cart and order library if pricing calculator is turned on.
4. Use option link pro cart and order library if option link pro is turned on.
5. Remove extra product options new line in checkout confirm page.
6. Newsletter subscribers are not added to Constant Contact and MailChimp if Mandatory VAT/Tax ID Option extension is installed after Constant Contact and MailChimp.

v1.2.6.5

2017 – 03 – 18

bug-fixRemove extra new line for product options in checkout confirm, order confirm email.

featureUse whitelabel extension custom email footer if whitelabel is installed and turned on.

v1.2.6.4

2017 – 02 – 14

bug-fix1. Fix guest taxid validation error.
2. Fix customer address validation error.
3. Fix admin-sale-customer-create customer validation error.
4. Fix missing tax id in customer address.
5. Fix doubled telephone and fax field in embed page.
6. Fix wrong validation for checkout > shipping > address.
7. Fix new checkout payment address creation issue.

featureAdd seller information to account > invoice

v1.2.6.3

2016 – 08 – 22

Fixed mismatch version number.

v1.2.6.2

2016 – 08 – 22

bug-fixFixed vat/tax field validation.

v1.2.6.1

2016 – 08 – 22

Support AbanteCart v1.2.8.

v1.2.6

2016 – 05 – 16

Support AbanteCart v1.2.6 and v1.2.7.

v1.2.1

2016 – 02 – 26

improvementAdded Bank Info’s, Personal/Company Registration number.

v1.2.0.1

2015 – 10 – 15

Initial Release.