Length Calculator

v1.3.1 Rev 21 Sept 2021

Overview

Length Calculator allows length-based measurement to be used to order products that need special calculation such as defined length of a pole, fabric sold by the yard, or jewelry chain sold by customer defined length, 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 Length calculator v1.3.1. Tested up to PHP 8.0.
AbanteCart v1.3.0 use Length calculator v1.3.0. Tested up to PHP 8.0.
AbanteCart v1.2.16 use Length calculator v1.2.16. Tested up to PHP 7.4.
AbanteCart v1.2.15 use Length 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 Length 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 Length 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 – The text will be shown as price/ft, price/m etc.

Note: You should use weight input for the same unit of selling in the product general tab page – e.g. if selling per ft use the weight for a ft.

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/ft.

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 length as the global attribute name so it is easier for you to determine that is the length calculator element type.

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

Product Settings

Add Length 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 dimension as the element type.

Length Option Settings

This is a single-dimension calculation using Length only.

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 maximum 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. Enter minimum length.
5. Enter maximum length.

Note for number 6: The Track Stock Option is the one in the options page.

6. 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 of pole. Your customer order 4 inch. The remaining stock will be 6 inch and the maximum length value in number 5 above will be adjusted according to the remaining stock. (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).
7. 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).

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

Notes for number 9:
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 dimension 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 be 2 or larger otherwise the option price won’t be calculated correctly or shown in the correct order on the product page.

9.  Select options that will be calculated along with the length. 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 length.

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. 28 is the stock that you set in the quantity field on the Product Options page.
2. in 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 dimension that was shown to customer that you enter via field number 5 in the settings page.
4. This is the maximum dimension that was shown to customer that you enter via field number 6 in the settings page.
5. This is the unit that was shown to customer that you choose via field number 7 in the settings page.
6. This is the decimal number that was shown to customer that you choose via field number 8 in the settings page.


7.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 Length Calculator v1.2.15 or v1.2.16 or higher the feature will be available.

For details on how the Extension Updater works click here.

Changelog

v1.3.1

2021 – 09 – 21

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.