Manual

Add-on setup

Hooks

For the module to work correctly, you must install the hooks as specified in the “Information” tab.

Global settings

Go to Add-on→ Downloaded modules → Fractional stock → Settings tab → Main.

The tab shows the Global product settings. Applying these settings affects all products in the store unless local product settings are specified.

Global product settings

Use fractional stock — when the add-on is enabled, by default this setting is applied to all products (“Use fractional stock” is set).

On the same tab you can set the Unit of measure for quantity, by default — pcs.

Example

For instance, if a building materials store sells items only in square meters, you can enable global fractional stock usage in the module settings and set the unit of measure to “sq. m.”.

As a result, all products (if they have no local settings and fractional stock is not disabled per product) will show the unit of measure “sq. m.” from the add-on global settings.

Local product settings

Global settings may not suit every product. To assign local parameters to a product, open the product and go to the “MS: fractional stock and packs” tab:

You can set the following options for products:

• Use global settings — uncheck this box if you want to use local settings.
• Use fractional stock (yes / no) — if selected, the product will be handled in multiples according to the specified step.
• Unit of measure for quantity — if the product’s unit differs from the global one, specify the other unit here. For example, if the global setting is “sq. m.” but this product should be tracked by pieces, set it to “pcs”.
• Quantity step — the step for increasing product quantity in the cart; can be fractional or integer. Default is 1.
• Minimum quantity to order — the minimum quantity that can be added to the cart.
• Maximum quantity per purchase for a single product — the maximum quantity that can be added to the cart. Default is 0, i.e. no limit.

Documents

You can configure display of fractional values for printing in documents.

To do this go to Documents (Settings → Notifications → Documents). When editing any document, new variables become available in the ms_fractional_stock section.:

When editing product tables you will also find the new variables available.

Compatibility with other modules

The add-on is compatible with the “Packs” module from make shop and the “CommerceML” add-on from CS-Cart.