M2 module
Nick Paul avatar
Written by Nick Paul
Updated over a week ago

Selling in square meters or linear meters? It couldn't be easier with the M2 Module add-on!

Have you always wanted to sell your products in square meters or linear metres? This add-on makes it possible! Let the customer easily choose his number of laminate packages by entering a calculation. This way, the customer always has enough packages and knows what he needs.
​
​Installation πŸ› οΈ
​

mceclip6.png


To install this add-on, an implementation from a developer is required . So it may take a while before the add-on is active. Simply click on " Request add-on " and let Plus+ notify our development heroes. πŸ‘¨β€βš•οΈ
​
After clicking " Request Add-on ", you would be redirected to " My Plus+ Add-ons " page. You will also see the following message appear in the top right corner of the dashboard.
​

mceclip7.png


​
​Add-on settings/overview βš™οΈ
After installation you will see that the add-on is in your overview , including installation date and status.
​
With this add-on, the status would first be "Open" , this is because the developers would first have to add the code to your webshop.
​

mceclip5.png


As soon as the developers are working on this you should see the status change to "Work in progress".
​

mceclip6.png


If the developers have added the code, this status will be set to "inactive" , so you can set it up properly and then activate it! βœ…
​

mceclip0.png


To activate the add-on, click on the hamburger menu and choose "activate". Prefer to see a preview in test mode first ? Which can. Click " Activate in preview mode" and the add-on would be visible only to you. So not for the customers !
​

mceclip9.png


​
​Settings βš™οΈ
​

mceclip1.png


​Of course we have some general settings for this add-on, they are explained below!The settings are as follows:
πŸ“ White space above the calculation module: How much white space do you want above the module? This way you can give the element some space and it is not stuck to the block above it.
πŸ“ White space under the calculation module:How much white space do you want under the module? This way you can give the element some space and it is not stuck to the block below.
πŸ“ Show price display add-on: The price display on the product page will be changed. This corresponds to the data entered from the add-on. We recommend to use this to avoid erroneous price displays!
πŸ“ Show .00 after the decimal point: Very simple, should a .00 be added after the decimal point when the price is round?
πŸ“ Show currency sign: Do you want to show the currency sign in front of the price? Then activate this option.
πŸ“ Show space between currency sign and price: Do you have the currency sign active? Then you can of course always choose to put a space between the currency and the price.
​
​

Set up products for the M2 module βš™οΈ
In order for the M2 module to work, some adjustments must be made in your product settings. Let's go through it step by step!
​
1. An extra field must be created with the product settings in your back office, for example with the name 'Calculation', this must be a text field . Think carefully about this field, because this will become visible in, for example, the shopping cart page and on the customer's invoice.
​Tip: Do you not want the product to be placed in the shopping cart from the 'product overview'? Make this field mandatory!
​

mceclip2.png

Remember this name well! We need to add a translation to custom translations. This can be found under 'Content -> Translations -> Add custom translation' .
​
With the translation, you enter the following tag as the translation key: dmws-w8fzr7-calculate
The translation is then the name of the extra field, in this case ' Berekening '
​

mceclip0.png


2. In the product you must also work with tags to identify the module and the display the desired data. There are 2 variants in the module: Calculate the number (linear meters) and calculate the number of packs (square meters).
The tag must always start with dmwscalculate, all other values ​​must start with | be separated.
So you have 2 variants: calculate:length and calculate:surface area .
With length (meters) you get 1 field with the product, and the number in the shopping cart is also adjusted (because you buy 40 cm, for example).
With surface area(square meters) you get 4(!) fields and you must also have the value value:xxxx in the tag.
The customer can then make a calculation by entering his own length x width, his m2 (also calculated when he fills in his LxW) or select the number of packs.
​
​2 examples:
Variant 1 (linear meters): dmwscalculate| calculate:length |unit:cm
Variant 2(square meters): dmwscalculate| calculate:surface area|unit:m2|value:2.690
​
With the 1st variant (linear meters) you have to change the product price to the price of, for example, 1cm. You enter the price per centimeter/meter (value). The example uses cm: dmwscalculate|calculate:length| unit:cm
In this case, the customer can increase the quantity of the product per 1cm.
​
With the 2nd variant (square meters), the product price is the normal quantity price.
We have set the 'unit' to m2, which means that the product is offered in square meters.
So behind surface area you enter how many square meters 1 product (package) can cover. In the example below, 1 package can therefore cover 2,690m2.
​

mceclip3.png

Within this add-on translation keys are used , with which you can adjust the text of the add-on to your own text. You can do this with custom translations .
The translation keys for this are as follows:

  • Enter the length in $1 and calculate how many items you need

  • Enter the surface area for $1 and calculate how many items you need

  • Quantity

  • Price per item

  • Minimum order quantity

  • Maximum order quantity

  • Total price

  • ($1 price per $2)

  • Excl. VAT

  • incl. VAT

  • Order ID

  • dmws-w8fzr7-calculate

  • dmws-calculate-length

  • dmws-calculate-width

Did this answer your question?