Area Calculator

v1.3.1 Rev 20 Sept 2021

Overview

Area Calculator allows a two-dimension input for calculating the area to be used to order products that need special calculation such as banners, signs, customer area carpets, counter tops, etc. It allows multiple unit inputs such as feet/inches, yards/feet, meters/cm, etc. and handles decimal input also.

AbanteCart v1.3.1 use Area calculator v1.3.1. Tested up to PHP 8.0.
AbanteCart v1.3.0 use Area calculator v1.3.0. Tested up to PHP 8.0.
AbanteCart v1.2.16 use Area calculator v1.2.16. Tested up to PHP 7.4.
AbanteCart v1.2.15 use Area calculator v1.2.15.

Hint:
If you need more than one Calculator for your products check out these packs. They could reduce your cost.
Pricing Calculator Pack (includes all Calculators – Area, Length, Liquids, Volume and Weight)
Pricing Calculator Area & Length Pack (includes Area and Length)
Pricing Calculator Liquid & Weight Pack (includes Liquids and Weight)
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:
1. Main product quantity become inactive when you add options with track-able values.
2. You need to check the length classes in Admin panel under System > Localization > Length Classes for inclusion of Meter (m), Feet (ft) and Yard (yd) in order to use multiple unit type conversion selection displayed. Please refer to our F.A.Q for additional length classes added by extension.
3. Please refer to our F.A.Q for How to set product dimension for our shippers extension.
4. The extension doesn’t work with prior AbanteCart v.1.3.0 default shippers due to the custom weight calculation that was made, so you have to use our shippers in order to have the correct weight calculated. Contact us if you are using a different shipping method than any of our shipping extension and need further guidance.
Important Note:
This extension doesn’t work with AbanteCart v1.2.16 default Fast Checkout extension. You can use our Quick Checkout extension to let customer checkout faster. Refer here to know more about our Quick Checkout extension.
Important Note:
At the moment:
1. This extension does not support multiple location.
2. If you use our Quick View Extension, the Area calculation field is not shown in the Lightbox.
3. You cannot use more than one calculator in the same product.

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. Run Order: If you are using multiple of our extensions, refer to our F.A.Q for How to set extensions sort/run order if you are using multiple extensions. You can leave it blank if you are only using our Area Calculator individually.

Admin

Add Calculator Product Info


1. Click the Calculator Product Info tab.

Important Note for number 2: You need to define the unit text as it is used for the calculation.

2. Define unit text – for area it is usually sqft, sqin. or sqyd . The text will be shown as price/sqft etc.

Note: You should use weight input for the same unit of selling – eg if selling per sqft use the weight for a sqft.

3. Show Multiple Unit Type – Allows your customer to choose the unit type they are familiar with metric or non-metric. The extension will convert to the option settings for pricing.

This example is using input of Feet and output of Inches to match the unit pricing of price/sqin.

Global Attribute


1. Click the add button to open up the available global attribute types.
2. Click Product Option.

Notes for number 3: We suggest you to use area as the global attribute name so it is easier for you to determine that is the area calculator element type.

3. Name: Enter the desired global attribute name.
4. Element Type: Select area as the element type.

Product Settings

Add Area Option To A Product

1. Click this button to add new option.

Notes for number 2: We suggest you to use global attributes for faster product option creation.

2. Select the global attribute that you have create earlier.
3. Enter the desired option name.
4. Select area as the element type.

Area Option Settings

This is a two-dimension calculation using Length X Width, Length X Height, Length X Depth.

1. Turn ON if you want to show the stock to customer.
2. Enter input limit message to notify them that they need enter the value between minimum and maximum limit. Default message is “Please enter between:”.
3. Enter minimum error limit to let customer know that they need to enter bigger value than the minimum limit value. Default message is: “Please enter minimum:”.
Enter minimum error limit to let customer know that they need to enter smaller value than the maximum limit value. Default message is: “The maximum cannot exceed:”.
4. Select area type. Available options are Length X Width, Length X Height and Length X Depth.
5. Enter minimum length.
6. Enter maximum length.
7. Enter minimum width.
8. Enter maximum width.

Notes for number 9:
You need to turn ON the Track Stock option in order to use Actual Qty, so the stock and maximum limit are adjusted. If you choose Fixed Limit and Track stock is ON, the one that will be adjusted is the stock only.

9. Select Maximum Basis:
A. Actual Qty: Select this if you want the extension automatically to reduce the maximum limit each time after customer enters the dimension. e.g. You have a 10 inch length X 10 inch width product which equals to 100sqin. Your customer order is 3X4 = 12sqin. The remaining stock will be 88. And the maximum limit will be adjusted based on your choice in number 10 below. (You have to turn ON the Track Stock Option).
B. Fixed Limit: Select this if you don’t want the maximum limit get reduced each time after customer select the dimension (The maximum limit will not be adjusted even though you turn ON the Track Stock Option).
10. Select dimension for adjustment: Select the dimension that you want to be adjusted upon customer order. (The choices will be automatically changed based on the area type that you choose in number 4 above and only shown if you choose Actual Qty as the Maximum Basis).
11. Choose different unit to let customer use big and small unit as the input. e.g. set feet as input unit and inch as output unit (You have to create the length class first).

12. Enter the decimal number to be used as rounding (If you leave this field empty, the extension uses 3 decimal number as the default decimal number).

Notes for number 13:
1. If you are using selectbox, we suggest you use option placeholder so the first option won’t be calculated.
2. It will first calculate the base total then multiply the option price with the total area and then finally sum the base total with the calculated option price total.
3. If you are using addon options, the calculator sort order setting (usually 0 but can be higher) the addon options sort order needs to be higher than the calculator sort order. e.g Calculator sort order is 1, Addon option needs to 2 or larger otherwise the option price won’t be calculated correctly or shown in the correct order on the product page.

13. Select options that will be calculated along with the area. Other product options need to be created in the regular options manner and then added to your product in order to be calculated with the area.

Order Details

Important Note:
At the moment the extension doesn’t support Save and Save & Recalculate using settings ALL. Please use act on behalf to create a new order.
If the order was cancelled, you need to add the quantity manually back into the product quantity.

Storefront

Product Page

Notes for number 1:
1. 100 is the stock that you set in the quantity field on the Product Options page.
2. sqin is the defined unit text that you enter via field number 1 in the general product settings page.

1. This is shown if you Turn ON the field number 1 in the settings page.
2. This is the limit message that was shown to customer that you enter via field number 2 in the settings page.
3. This is the minimum length that was shown to customer that you enter via field number 5 in the settings page.
4. This is the maximum length that was shown to customer that you enter via field number 6 in the settings page.
5. This is the minimum width that was shown to customer that you enter via field number 7 in the settings page.
6. This is the maximum width that was shown to customer that you enter via field number 8 in the settings page.
7. This is the unit that was shown to customer that you choose via field number 11 in the settings page.
8. This is the decimal number that was shown to customer that you choose via field number 12 in the settings page.


9. This is the Min or Max limit message that was shown to customer that you enter via field number 3 in the settings page.

Cart Page

Checkout Confirmation Page

Fast Checkout Page

Important Notes: This only works with AbanteCart v1.3.0 or higher default Fast Checkout Extension.

Order Confirmation Email

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 Area Calculator version 1.2.16 or 1.2.15 or higher the feature will be available.

For details on how the Extension Updater works click here.

Changelog

v1.3.1

2021 – 09 – 20

Support AbanteCart v1.3.1.

v1.3.0

2021 – 05 – 27

Support AbanteCart v1.3.0.

v1.2.16

2021 – 05 – 27

Support AbanteCart v1.2.16.

v1.2.15

2021 – 05 – 27

Initial Release.