Surcharges & multiplier

Fields can influence the price of a product – either via a fixed surcharge per option or via a multiplier (factor) on the selling price.

Enabling prices

The price function is enabled globally in the plugin configuration:

Settings > System > Plugins > Article Configurator … > Configuration

• Enable prices for option fields (enablePrices) – Only when this option is active can you store a value (price or factor) for options.

As long as the option is disabled, you simply enter available options comma-separated (e.g. tea, coffee, water). With prices enabled, you instead maintain name + value per option.

Options with a price (dropdown, single & multi select)

With prices enabled, the field types dropdown, single select and multi select show a list of options, each with two inputs:

Input	Meaning
Option name	Display text of the option, e.g. Black.
Value	The surcharge (e.g. 10) or – with the multiplier enabled – the factor.

Use Add option to create more options, and the delete icon to remove an option.

Fixed surcharge

If the multiplier toggle is disabled, the value is added as a fixed surcharge to the product price. If the customer selects, for example, an option with the value 10, the unit price increases by 10.

Multiplier (factor on the selling price)

If the multiplier toggle is enabled, the stored value of the selected option is multiplied by the selling price. This allows price-dependent surcharges (e.g. a percentage surcharge for a particular variant).

Number field as a multiplier

A number field can also act as a multiplier. To do so, enable the multiplier toggle in the number field (with prices enabled). The following parameters are available:

Parameter	Meaning
Value	Base value for the multiplication.
Step size	Step size for the input in the frontend.
Min	Smallest permitted value.
Max	Largest permitted value.

The number entered by the customer is used for the price calculation – ideal e.g. for dimensions or quantities where the price scales with the entry.

Displaying factors in the cart

In the plugin configuration you control with Display markup factors in cart (displayMarkupFactors) whether the underlying factors are shown in the cart. This option is only relevant when you work with multipliers.

Calculation & output

Surcharges and factors are calculated on the server side in the cart and flow into the total price of the line item. In the order, in the cart and on documents, the selected options are shown together with the corresponding price – see Output in order & documents.

Note: The option Separated quantity for attribute with prices (separatedQuantity) is planned for a future version and is disabled in the current configuration.