Module Ultimateqrcode EN

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search

Informations

Module name Ultimateqrcode
Editor / Editeur Atoo.Net - https://www.atoo-net.com
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-03-20
Note / Nota

Installation

  1. Download the module and place it in the htdocs/custom/ultimateqrcode/ directory
  2. In Dolibarr: go to Home → Setup → Modules/Applications
  3. Find UltimateQRcode in the Atoo-Net section and activate it
  4. Configure permissions per user group (see Rights and permissions)

Module Configuration

Access configuration via Home → Setup → Modules/Applications → UltimateQRcode (wrench icon), or directly through the administration menu.

The configuration page has three tabs.

Tab "QR codes" (free generator)

Free QR code generator

This tab provides an on-demand QR code generator:

Field Description
Data Content to encode: URL, email address, free text, vCard, etc.
ECC Error correction level:
L (≈7% — smallest): minimal size
M (≈15%): standard use
Q (≈25%): good resistance
H (≈30% — best): highly resistant (recommended with logo)
Size Point size (1 to 10 pixels per QR module)
GENERATE button Instantly generates and displays the QR code

Click Like that in the help text to see a generation example.

Tab "QR with logo"

QR code generator with embedded logo

This tab generates a QR code with a logo inserted in the center:

Field Description
Data URL or content to encode (default: https://www.atoo-net.com/)
Size 1 to 10 — controls the resolution of the generated image
Choose a file PNG logo to embed in the center of the QR code
GENERATE button Generates the QR code with the logo and saves it
Select a QR code to display Choose from previously generated QR codes to display
DISPLAY button Displays the selected QR code
Trash icon Deletes the selected QR file (with confirmation)

The Uploaded Logos section lists all uploaded PNG files with their size and upload date. A delete button is available on each row.

Template:Note

Tab "About"

Displays module version information, author details and documentation links.


Usage in Records

The module adds a QR code tab to the following object records:

Object Added tab(s)
Third party QR code + QR-Url (two separate tabs)
Contact QR code
Product / Service QR code
Lot / Serial number QR code
Warehouse QR code
Proposal (Quote) QR code
Customer order QR code
Supplier order QR code
Customer invoice QR code
Supplier invoice QR code
Contract QR code
Intervention QR code
Project QR code
Member (foundation) QR code
User group QR code
User QR code

Common structure of the QR code tab

Each QR code tab is organized in two sections:

Top section — Configurable data QR code

QR code tab on a third party record — field selection

The user selects which fields to include in the QR code using checkboxes:

  • Left column: checkbox
  • Center column: field label and current value (grayed out if unchecked)
  • Right column: the generated QR code (spanning the full height of the table)

Available fields depend on the object type:

Object Available fields
Third party Company name, Address, ZIP, Town, Country, Phone, Email, URL + Extra fields
Product Ref., Label, Description, Price excl. tax, Price incl. tax, Barcode, Weight, Volume, URL + Extra fields
Warehouse Label, Short location name, Description, Address, ZIP, Town, Country, URL + Extra fields
User Login, First name, Last name, Phone, Mobile, Email, Address, ZIP, Town, Country, URL + Extra fields
Contact Title, First name, Last name, Company, Job, Phone, Mobile, Email, Address, etc.
(others) Fields specific to each object type

Template:Note

The displayed QR code is clickable: clicking it opens the label printing window.

Bottom section — Record URL QR code

QR code tab — bottom section with URL QR and Save/Cancel buttons

The bottom section displays:

  • The label URL of the [object] record
  • A clickable link to the Dolibarr record
  • A second QR code encoding the direct URL to the record (also clickable for label printing)
  • The SAVE and CANCEL buttons

Automatic default field selection

On first display (no configuration saved), the module automatically selects fields whose value is non-empty. This ensures a relevant QR code right from the first opening.

Saving configuration

Check/uncheck the desired fields, then click SAVE. The selection is saved and applies to all objects of the same type (one global configuration per object type).


QR code tab — Examples by object

Product

QR code tab on a product record

Example configuration for a product: Ref. and Label checked, plus extra fields Ecotax and ControlHistoryLink. The QR encodes these four values concatenated.

Warehouse

QR code tab on a warehouse record

Useful for physical identification of storage locations. The Short location name field (lieu) allows specifying the storage zone.

User

QR code tab on a user record

The user QR code encodes contact information (login, first name, last name, phone, mobile, email, country...). Practical for badges or internal business cards.

Template:Note


QR-Url Tab (Third parties only)

QR-Url tab on a third party — QR with logo

Third party records have a second QR tab called QR-Url, specialized in generating QR codes with an embedded logo encoding the record URL.

Features:

Element Function
Size (1-10) Resolution of the generated QR code
Choose file + UPLOAD LOGO Upload a PNG logo to embed in the center
Select a QR code to display Choose from QR codes already generated for this third party
DISPLAY button Displays the selected QR code
Uploaded Logos section Lists available logos with download and delete options

The displayed QR encodes the URL of the third party record, with the chosen logo inserted in the center of the image.


Label Printing

Label printing window — 120×57mm format

Clicking any QR code in any tab opens a popup print window optimized for labels in 120 × 57 mm format (compatible with standard label printers).

The label contains:

  • Left: the configurable data QR code
  • Center: key text information (reference, label, name, etc. depending on the object)
  • Right: the record URL QR code

The window automatically triggers the browser's print dialog.

Template:Note


Rights and Permissions

UltimateQRcode module permissions

The module defines two permission levels, to be assigned per user group in Setup → Groups and users:

Permission Description Effect
Read qrcode outcomes Read QR codes Allows viewing QR code tabs and displaying generated QR codes
Create/Modify qrcode outcomes Create / Modify Allows checking/unchecking fields and saving the configuration

Template:Note


FAQ

The QR code is empty or shows "No data"
No field is checked, or all checked fields have empty values in the record. Check at least one field with a value and click SAVE.
The label does not print at the correct size
Verify that the printer paper format is set to 120×57mm. Disable margins in the browser's print options.
Extra fields do not appear
Custom attributes must be defined in Setup → Extra attributes for the relevant object type.
The QR with logo is not readable
The logo takes up too much space. Use a smaller logo or increase ECC to H to improve error correction.
The QR code tab does not appear on some records
Verify that the module is activated and that the user has the Read qrcode outcomes permission.

See also