Welcome

Learn how to install, configure, and automate the standardization of your product model numbers.

Overview

Eliminate manual and repetitive work when creating identification codes.

The module ensures unique and standardized identifiers through an intelligent Template system. With this solution, you eradicate human errors and duplicates, establishing a logical and scalable structure for total inventory control.

Requirements

Ensure you have permissions for:

  • Extension Installer & Manager
  • Product Catalog

Version Comparison

Free Version Full Version
Lock Model field
Templates Only 1 Unlimited
Number Intervals Only 1 Unlimited
Prefixes Unlimited
Suffixes Unlimited
Get Full Version

Key Features

Essential

Smart Auto-fill

The system identifies the default template and automatically fills the "Model" field when opening a new form, saving time and clicks.

Integrity

Security & Uniqueness

Guarantees a **unique identity** for each product, preventing duplicate numbers. Lock the Model field for manual editing to eliminate human errors.

Important

Retroactive Processing

Standardize existing store items. The module safely generates and applies model numbers to your current products.

Dynamic Templates

Combine prefixes, intervals, and suffixes to create distinct rules by department or product category.

Multi-language Interface

Intuitive interface with native translations in EN, PT, FR, ES, and IT.

Full Scalability

Manage multiple rules simultaneously without performance loss in large databases.

Support & License

Support

Need help?

Get Support

License

Software distributed under the terms:

GPL v3.0

Model Number Structure

The code generation is modular and flexible, divided into three components that ensure full traceability and uniqueness.

PrefixABC-XYZ-
Sequential0001
Suffix-ASD-QWE

Prefixes

Macro identifiers that precede the sequential number (e.g., ABC-XYZ-).

  • Modular: Segmented into multiple blocks.
  • Scalable: Add as many blocks as you wish.
  • Optional: Use only when necessary.
  • Connection: Requires a separator before the numeral.

Numerical Range

The mandatory sequential core (e.g., 0001), ensuring uniqueness.

  • Padding: Left-aligned zero filling.
  • Variable: Customizable digit length.
  • Ranges: Specific rules per category.

Suffixes

Final attributes to detail versions or status (e.g., -ASD-QWE).

  • Modular: Segmented into multiple blocks.
  • Scalable: Add as many blocks as you wish.
  • Optional: Use only when necessary.
  • Connection: Requires a separator before the numeral.

Attention: Separator Sensitivity

The system processes each character literally, linking the numerical range to the unique combination of prefixes, suffixes, and separators. Any change — such as swapping a hyphen (-) for a slash (/) — defines a new identity, automatically restarting the numerical sequence for that specific identifier.

ABC-XYZ-0001-ASD-QWE Reference pattern.
ABC/XYZ-0001-ASD-QWE The slash changes the prefix: the count restarts for this new group.

Standardization Tip:

To maintain readability on labels and reports, use short acronyms to represent categories or brands.

Recommended: HW-MEM-DDR4-001 (Hardware - Memory - DDR4)
Avoid: HARDWARE-MEMORY-DDR4-001

Installation

Follow the workflow below to apply automatic numbering to your products.

01

Download

Get the official module directly from the OpenCart Marketplace:

Official Page
02

Upload

In your store's admin panel, go to Extensions > Installer. Click Upload and select the downloaded file.

03

Activation

Locate the module in the extensions list and click the Install icon to activate it.

Tech Tip: After activation, remember to go to Extensions > Modifications and click the Refresh button (blue icon) to clear the system cache.

Accessing Settings

After installation, follow this workflow to configure your automation.

01

Side Menu

Go to Extensions > Extensions.

02

Filter

Select the Modules extension type.

03

Edit

Click Edit to open the panel.

1. General Settings

General Tab
General Configuration
ParameterFunction
Auto-fillGenerates the template instantly when creating products.
Prevent EditingLocks the Model field to prevent manual changes.
StatusEnables or disables the module.

2. Prefix and Suffix

These tabs allow you to compose the text or date elements surrounding the sequential number.

Prefix Tab
Prefix and Suffix Configuration

Group Settings

ParameterFunction
Name Internal identification.
E.g.: Electronics, Apparel.
Separator Character that joins this group to the sequential number.

Element Composition

ParameterDescription
Type Defines if the element will be Fixed Text or a Dynamic Date.
Content (Text) The textual value to be displayed (e.g., PROD).
Format (Date) The desired date pattern (e.g., 2-digit year + month).
Separator Character that joins this element to the next one within the same prefix.

Tip: You can add multiple elements to create complex prefixes, such as YEAR-CATEGORY-.

3. Sequential Interval

Intervals Tab
Sequential Number Range Configuration
Parameter Description
Name Internal identification.
E.g.: General Count, Batch 2024.
Leading Zeros Enables padding for visual standardization.
Length Total number of digits.
E.g.: A length of 4 transforms "1" into "0001".
Min / Max Defines the starting point and the final count limit.

Security Tip: The system uses these limits to ensure non-duplication. Upon reaching the maximum value, an alert will be issued preventing new records to guarantee data integrity.

Tip: If you work with variations (such as colour or size), use the Shared Sequence option in the Template tab to maintain a single sequence across all products.

4. Template

Template Tab
Final identifier assembly interface
Parameter Description
Name Internal identification.
E.g.: Mouse, Keyboard, A4 Sheets.
Prefix Link to the configured Prefix group.
Shared Sequence Allows different variations of a product to share the same numerical sequence.
Interval Link to the Sequential Numbering rule.
Suffix Link to the configured Suffix group.
Default Sets the template as the primary one for auto-fill.

Workflow Tip: The Template is where you "stitch together" the previous settings. Make sure that the Prefix, Interval, and Suffix groups have already been created before finalizing this step.

Shared Sequence

The Shared Sequence option allows different variations of a product (such as color, size, or version) to share the same numerical sequence, even if they have distinct suffixes.

How it works

When enabled, the system ignores the suffix when calculating the next available number, considering only the prefix.

Prefix
TSHIRT-
Number
001
Suffix
-WHT / -BLK

Behavior Comparison

Disabled

Each suffix has its own sequence
TSHIRT-001-WHT
TSHIRT-002-WHT
TSHIRT-003-WHT
────────────
TSHIRT-001-BLK
TSHIRT-002-BLK

Enabled

Unified sequence by prefix
TSHIRT-001-WHT
TSHIRT-002-WHT
TSHIRT-003-WHT
────────────
TSHIRT-004-BLK
TSHIRT-005-BLK

Result: Numbering continues sequentially across all variations, avoiding duplication and maintaining global consistency.

When to use

Colour variations
Size variations
Product versions

Important: The number must be immediately after the prefix. Different structures may prevent correct sequence identification.

Generating Numbers

Follow the workflow below to apply automatic numbering to your products.

Model generation interface
View of the Model field with integrated template controls
01

Navigation

In the side menu, go to Catalog and select the Products option.

02

Access

Click Edit on the product or the Add New button.

03

Location

Go to the Data tab and locate the Model field in the form.

04

Generate Number

Select the template and click the Generate button . The Model field will be filled.

Convenience Tip: When selecting a non-default template and checking the "Set as default" option, the system will automatically save your choice upon generating the number.

Uninstallation

Follow the steps below for a clean and safe uninstallation.

01

Deactivate

Go to Extensions > Extensions, filter by Modules, locate the module and click Uninstall.

02

Uninstall

Locate the module in the list of installed extensions and click the Uninstall icon.

03

Delete

Still in the installed extensions list, click Delete.

What happens to the data?

Uninstallation removes the module settings and files. However, the model numbers already generated for your products will remain saved in the database to prevent loss of integrity in your records.

Enjoying the module?

I know, it's a paid module, but if it's saving your day and optimising your catalogue, how about buying me a coffee? This helps keep the code clean, the support fast, and provides the caffeine needed for the next updates!

License Information

Free and Full versions licensing terms.

This extension (Free and Full versions) is licensed under the GNU General Public License v3.0 (GPL-3.0).

Use and modification of the software must comply with the terms established by the GPL-3.0 license.

Technical support and updates are provided exclusively to original purchasers through the official OpenCart Marketplace.

For complete license details, please refer to the LICENSE file included in this repository or visit the official page of the GNU General Public License v3.0 .