English Русский Українська

Documentation Units Measurement Product

The modification allows adding and configuring various price units for products and options. It is suitable if you sell products with prices set per specific quantity, such as price per square meter, linear meter, cubic meter, kilogram, piece, etc.

Version: 1.0
Release: 20.02.2024
Return to the catalog
More about the modification
1. Information to users
2. Modification installer
3. Modification configuration
4. Add unit of measurement
5. Stylization
6. List of changes

Information to users

Please carefully review this information before starting to use our products. We have endeavored to provide maximum compatibility and user convenience, but some aspects may require your attention and configuration. Do not hesitate to contact us with any questions or if you need assistance.

  • The modification has been tested on the standard Opencart template but may require adaptation for other templates.
  • During installation, additional fields are created in the database. We recommend creating a backup of your data before installation for data recovery if needed.

Try first installing «Localcopy OCMOD», and then attempt to install our modification again. This sequence may resolve potential conflicts and help you successfully implement our changes on your website.

Download for OpenCart 2x
Download for OpenCart 3x

Modification installer

The installation process of the modification consists of two steps:

  • Unit_Of_Measurement_Product_x_OpenCart_x.ocmod.zip - this archive contains the main functionality of the module and the modification;
  • Unit_Of_Measurement_Product_Default_OpenCart_x.ocmod.zip - this archive contains a modification for connecting the template.

To install the modification, follow these steps:

  • Login to the Admin Panel and navigate to Menu -> Extensions -> Extension Installer;
  • Upload and install both archives;
  • After successful installation, you will receive a notification;
  • Go to Menu -> Extensions -> Modifications and click the «Refresh» button in the upper right corner;
  • After completing these steps, go to Menu -> Extensions -> Modules and install the module Units Measurement Product.

Modification configuration

To configure the modification, go to Menu -> Extensions -> Modules -> Units Measurement Product

Main configuration parameters:

  • Status - controls the activation of the modification;
  • Separator - allows you to specify the symbol between the price and the unit of measurement [Example: 10.00 / piece | 10.00 per sq. m.];
  • Display in options - enables display next to the price in the options section;
  • Display in product list (Admin) - displays a column with the unit of measurement in the admin panel on the product list page + sorting by unit of measurement.

Database Status:

  • Displays the status of fields in the database table;
  • Manages the installation or removal of fields from the database.

Add Unit Of Measurement

To add a unit of measurement, go to the section Menu -> System -> Localization -> Units Measurement Product, and click the "Add" button. A window will open, where you should fill in the fields;

Form fields:

  • Unit Name - the full name of the unit of measure;
  • Unit - the designation of the unit of measure (e.g., pcs., sq. m.);
  • Default - determines whether this unit of measure will be automatically used when creating a product;
  • Sort Order - set the sorting order for displaying units of measurement in the list;
  • Status - determines whether to display this unit of measure;
  • Category - sets the unit of measurement for all products in the selected categories.

Styling

If styling of elements is needed, add classes with the required attributes in the CSS file connected to the template:

  • .separate - styling for the separator;
  • .unit - styling for the unit of measurement;
  • .separate-option - styling for the separator in options;
  • .unit-option - styling for the unit of measurement in options.

Problems and solutions

If you have any questions or problems, we have collected in this section answers to frequently asked questions and solutions to the most common and common problems.

Familiarize

List of changes

  • v1.020.02.2024

    Latest release

    Added:

    • The ability to specify a unit of measurement on the product card;
    • The ability to specify a unit of measurement for each product option;
    • Ability to set a unit of measurement for all products in selected categories;
    • Units of measurement are displayed on the product page, in categories, on the search page, on the manufacturers' page, and in standard modules.