Skip to content

Product config parameters

This is the most important page in the manual. Bulk pricing, product variants and multi-dimension SKUs all come from here.

Where: Products → Add/Edit product → the Config parameters box. Available both in the admin panel and to suppliers in the user panel.

The syntax is INI-like: a [section] header, then one key=value per line. Section names are fixed and must not be changed.

Bulk pricing

Cheaper when buying more. Say the unit price is 100:

  • 5 or more: 90 each
  • 10 or more: 80 each
  • 20 or more: 65 each
ini
[wholesale]
5=90
10=80
20=65

The left side is the quantity threshold, the right side is the unit price once that threshold is reached (not a total).

Want a different bulk table for one member tier? Configure it under member pricing for that product — no need to touch this box.

Product variants

For products sold in several fixed flavours, such as monthly, quarterly and yearly memberships:

ini
[category]
Monthly=20
Quarterly=70
Yearly=150

The right side is the selling price of that variant (not a surcharge). Buyers get a set of options on the storefront.

Same idea for card products:

ini
[category]
Day pass=10.88
Week pass=68.88
Month pass=128.88
Year pass=488.88

Variant cost (3.4.3+)

To let the system calculate profit, also record the cost of each variant:

ini
[category_cost]
Monthly=10
Quarterly=30
Yearly=80

Bulk pricing per variant

Bulk rules for a specific variant, written as variant.quantity=unit price:

ini
[category_wholesale]
Day pass.5=9.88
Day pass.10=8.88
Day pass.20=6.88
Week pass.3=60.88
Week pass.6=50.88
Week pass.10=40.88

That sets unit prices for 5/10/20 day passes and 3/6/10 week passes.

Multi-dimension SKUs (3.1.1+)

For products with several independent option groups — a phone's colour, capacity, network and bundle. Written as group.option=surcharge:

ini
[sku]
Colour.Desert Titanium=0
Colour.Black Titanium=200
Colour.Natural Titanium=0
Colour.White Titanium=300
Capacity.128GB=0
Capacity.256GB=400
Capacity.512GB=800
Capacity.1TB=1600
Network.5G=0
Bundle.Standard=0
Bundle.Extended warranty=200

SKU numbers are surcharges, not prices. With a base price of 5000, "Black + 256GB" costs 5000 + 200 + 400 = 5600. Use 0 for no surcharge.

If the product also defines [category], the surcharge is added to the selected variant's price, not to the base price.

SKU cost (3.4.3+)

ini
[sku_cost]
Colour.Black Titanium=100
Capacity.256GB=200
Capacity.512GB=400
Bundle.Extended warranty=100

Combining them

All of these sections can coexist on one product:

ini
[category]
Monthly=30
Yearly=300

[category_cost]
Monthly=15
Yearly=150

[sku]
Line.Standard=0
Line.Premium=20

[category_wholesale]
Monthly.10=25

Common mistakes

SymptomCause
Parameters have no effectSection name is wrong. They are fixed — check the square brackets too
Buyer picked yearly and got a monthly keyThe keys were imported under the wrong variant — see card keys
SKU prices come out wrongSKU values are surcharges, not prices
One combination is always out of stockThere are no keys for that combination; stock is counted per combination

Going further

Config parameters + per-tier pricing + per-tier configuration together let you show different variants, different bulk rules and different prices to different tiers of buyer. That is the foundation of a layered reseller programme.

Released under the MIT License