Uni CPO 4 Documentation

Search…

Uni CPO Add-ons

Non Option Variable (NOV)

Non Options Variables (NOVs) are *synthetic* variables, created for a sole purpose of calculating a specific maths formula or utilising Matrix functionality.

And this is how the modal window looks like at the beginning:

There are two major settings:

- Enable/disable NOVs functionality
- Enable/disable wholesale functionality for NOVs

Next you can see the list of available Option's variables (or *regular variables* or simply *variables*), their special variables and NOV variables. More Options you add - more Option's variables are in this list. These variables can be used in maths formulas for NOVs.

Next is the repeatable list of NOVs actually. Let's review the next example:

In this example: NOVs functionality is enabled; the list of regular variables contains many vars (why they are colored differently?); one *simple* NOV is added. As it can be seen the value of this NOV is a pretty simple maths formula with two variables used in it. The name of this NOV is

{uni_nov_cpo_area}

and this is its value

{uni_cpo_width}*{uni_cpo_length}

So, the result of evaluation of this formula will be the value calculated by multiplication of the value of the first variable and the second variable. Now, it is possible this newly created NOV in Main Formula or Formula Conditional Logic instead of writing *possibly a lot of times* the mentioned above maths formula of multiplication. **This is the main purpose of NOVs - to make life easier!** 😊

NOV with wholesale functionality

`Free`

NOV with Matrix functionality

`Pro`

The 'matrix' functionality is a new and exciting feature of Uni CPO version 4. 🤟 It makes it possible to use table based list of prices based on one or two options. 💪

Usage

First, check 'Matrix?' checkbox to reveal the related fields. which are: '**1st var**', '**# in cols**' and '**2nd var**'. '**1st var**' lets you connect a certain option to the values defined in the first row. '**# in cols**' - the values of the first row, actually. These values must be separated by '**|**' sign. '**2nd var**' lets you connect a certain option to the values defined in the first column. The matrix (table) can be edited inline, so there is not a problem to add a new **row** or delete it. But the number of columns and their first values are taken from '**# in cols**' field only. It is also possible to use the same option in both '**1st var**' and '**2nd var**' fields if you need to pick the price based on one option only.

If you need to **add more or make less columns**, change the number of values in '**# in cols**' field and click on "Generate" button. The matrix will rebuild itself then.

It is possible to prepare the table in CSV and then just import it. ⚠️ **CSV file must contain semicolon ";" separated values**! ⚠️ Not dot separated, not comma separated, but semicolon ";" separated ONLY! These are examples of such files: Step builder CSV files examples. Sometimes decimal numbers of your CSV file can be comma separated. I suggest you to **click on "Generate" button just after the import is made**. This action will normalize values (will change all the commas to dots, in particular) in the matrix and there will not be any problems of using them. ⚠️ **The second limitation is that you CAN use NUMERIC values ONLY! ⚠️** Numeric values for columns, for rows and for cells. NOV matrices are about using numeric values only!

This rule leads us to understanding two possible tactics/usage cases of this table of prices: *simple *(suitablefor discrete values) and *ranges* (only suitable if you have to use ranges of option's values).

It looks like this:It can be seen that I intend to use it with discrete values, so, for instance, nothing can be selected in between of 10 and 20 in any of the options chosen. And this matrix covers all the possible pairs of chosen values.

It looks like this:It can be seen that values in the first row and the first column are written like ranges (1 and 2000, 2001 and 2250 and so on) and price values are repeated four times - just to cover both values in each range pair. This is because I intend to let users choose any values in those ranges. So, for instance, user can pick 1400 and 900. So, instead of write down all such possible variations in the table, I put it like 'from' and 'to' values and according to the rule ("the closest value will be picked") it does not really matter if 1400 is closer to 1 or to 2000. And the same is for 900. Price value will still be 400.25.

NOV with unit conversion functionality

`Pro`

This functionality makes it possible to auto convert values of certain variables from one measurement unit to another one. Like, from 'm' to 'in' etc. This is how it looks like:

What is showcased in the screenshot is that I have created a new NOV called

{uni_nov_cpo_with_m}

so it always holds the value in meters after converting the value from regular variable

{uni_cpo_width}

I can go even further and add another one Option called 'Measurement Unit'. I can give visitors a possibility to choose a measurement unit dynamically. So, instead of using only and ever the default dimension unit, a visitor can choose which one he wants to add values in. This is what must be done prior using such functionality:

- 1.A new Option (Select or Radio) must be added and its suboptions must be configured like it is described here
- 2.This new Option created must be chosen in Measurement Unit setting in Dimensions Settings. Although i
*t is not necessary to enable Dimension Settings, just pick the correct option in the mentioned above setting from that modal window.* - 3.Done! 😃

Now the script will know which dimension unit to use as 'from' instead of the default one from WC settings! 👍

NOV matrices in 'rangesum' calculation mode

`Pro`

`Advanced`

Starting from version 4.6.3 the very special functionality is added to the plugin. This functionality involves using NOV matrix to calculate differently than normal. Normally, during the evaluation of NOV matrix only one value will be picked and it is based on 1st and 2nd variables, of course. **This new mode of calculation of NOV value sums values of each number in the range of numbers based on the rates picked from the matrix connected to this NOV.** The great example of this functionality is so called game ranks booster calculators. Let's say you offer rank boosting for DOTA game (nice game btw 👍), let's say the current player's rank is 100 and he/she wants it to be 4005. In you calculator each rank has its own price, like from 1 to 2000 each rank costs 0.045, but from 2001 to 3000 it costs 0.057 each and so on. Now, you can create a very simple matrix with such ranges and the final price for our example will be calculated like that: (2000 - 1)*0.045+(3000-2000)*0.057.... = $200 Briefly, this is the idea behind this new way/mode of evaluation of NOV value.

add_filter( 'uni_cpo_rangesum_enabled_novs', 'uni_cpo_rangesum_enabled_novs_func', 10, 1 );

function uni_cpo_rangesum_enabled_novs_func($vars) {

$vars[] = 'uni_nov_cpo_rangesum';

return $vars;

}

where

`uni_cpo_rannge_sum`

is the name of your NOV.Also, please, read in the blog how to use this functionality. We have created an article tutorial: https://moomoo.agency/how-to-setup-printed-booklets-product-with-uni-cpo-and-woocommerce/

Last modified 1yr ago