Module Ultimateqrcode DE

Informationen

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-07-25
Note / Nota	Kompatibel mit Dolibarr v24

Installation

Laden Sie das Modul herunter und legen Sie es im Verzeichnis htdocs/custom/ultimateqrcode/ ab
In Dolibarr: Home → Konfiguration → Module/Anwendungen
Suchen Sie das Modul UltimateQRcode im Bereich Atoo-Net und aktivieren Sie es
Die Rechte müssen pro Benutzergruppe konfiguriert werden (siehe Rechte und Berechtigungen)

Modulkonfiguration

Die Konfiguration erreichen Sie über Home → Konfiguration → Module/Anwendungen → UltimateQRcode (Schraubenschlüssel-Symbol) oder direkt über das Administrationsmenü.

Die Konfigurationsseite besteht aus drei Registerkarten.

Registerkarte „QR-Codes" (freier Generator)

Diese Registerkarte bietet einen QR-Code-Generator auf Anfrage:

Feld	Beschreibung
Data	Der zu kodierende Inhalt: URL, E-Mail-Adresse, Freitext, vCard usw.
ECC	Fehlerkorrekturstufe: • L (≈7% — kleinste): minimale Größe • M (≈15%): übliche Verwendung • Q (≈25%): gute Widerstandsfähigkeit • H (≈30% — beste): sehr widerstandsfähig (empfohlen mit Logo)
Size	Punktgröße (von 1 bis 10 Pixel pro QR-Modul)
Schaltfläche GENERATE	Erzeugt und zeigt sofort den QR-Code an

Klicken Sie im Hilfetext auf Like this, um ein Generierungsbeispiel zu sehen.

Registerkarte „QR mit Logo"

Diese Registerkarte ermöglicht die Erstellung eines QR-Codes mit einem in der Mitte eingefügten Logo:

Feld	Beschreibung
Data	Zu kodierende URL oder Inhalt (Standard: https://www.atoo-net.com/)
Größe	Von 1 bis 10 — steuert die Auflösung des erzeugten Bildes
Datei auswählen	PNG-Logo, das in der Mitte des QR-Codes eingebettet werden soll
Schaltfläche GENERATE	Erzeugt den QR-Code mit dem Logo und speichert ihn
QR-Code zur Anzeige auswählen	Auswahl unter bereits erzeugten QR-Codes zur Anzeige
Schaltfläche ANZEIGEN	Zeigt den ausgewählten QR-Code an
Symbol Papierkorb	Löscht die ausgewählte QR-Datei (mit Bestätigung)

Der Abschnitt Hochgeladene Logos listet alle abgelegten PNG-Dateien mit ihrer Größe und dem Upload-Datum auf. In jeder Zeile steht eine Löschschaltfläche zur Verfügung.

Hinweis: Die empfohlene ECC-Stufe für einen QR-Code mit Logo ist H (30%), da das Logo einen Teil des Codes verdeckt — die Fehlerkorrektur gleicht dies aus.

Registerkarte „Über"

Zeigt Informationen zur Modulversion, zum Autor und den Link zur Dokumentation an.

Verwendung in den Datensätzen

Das Modul fügt eine Registerkarte QR-Code in den Datensätzen folgender Objekte hinzu:

Objekt	Hinzugefügte Registerkarte(n)
Kunde/Lieferant	QR-Code + QR-Url (separate Registerkarten)
Kontakt	QR-Code
Produkt / Dienstleistung	QR-Code
Los / Seriennummer	QR-Code
Lager	QR-Code
Angebot	QR-Code
Kundenauftrag	QR-Code
Lieferantenauftrag	QR-Code
Kundenrechnung	QR-Code
Lieferantenrechnung	QR-Code
Vertrag	QR-Code
Einsatz	QR-Code
Projekt	QR-Code
Mitglied (Verein)	QR-Code
Benutzergruppe	QR-Code
Benutzer	QR-Code

Gemeinsame Struktur der QR-Code-Registerkarte

[Neu in v24] Jede QR-Code-Registerkarte ist nun in fünf Bereiche gegliedert:

Bereich 1 — Einstellungsleiste

Einstellungsfeld: Größe, ECC-Qualität und Logoauswahl

Oben auf jeder QR-Code-Registerkarte ermöglicht eine Einstellungsleiste die Konfiguration von:

Einstellung	Beschreibung
Größe	Auflösung des QR-Codes (von 2 bis 10 Pixel pro Modul). Je höher der Wert, desto größer und lesbarer der QR-Code.
Qualität (ECC)	Fehlerkorrekturstufe: Niedrig (L ≈ 7%), Mittel (M ≈ 15%), Viertel (Q ≈ 25%), Hoch (H ≈ 30%).
Logo	PNG-Logo, das in der Mitte des QR-Codes eingebettet wird, auswählbar aus den hochgeladenen Logos.

Hinweis: Wenn ein Logo ausgewählt ist, wird die ECC-Qualität automatisch auf Hoch (H) erzwungen, um die Lesbarkeit trotz des Logos zu gewährleisten. Der Hinweis (Bei Logo auf Hoch erzwungen) wird neben dem Auswahlfeld angezeigt.

Diese Einstellungen werden unabhängig pro Objekttyp (Rechnung, Angebot, Auftrag usw.) gespeichert und gelten für beide angezeigten QR-Codes (Daten und URL).

Bereich 2 — Logo-Auswahltabelle

Die Tabelle listet die im Verzeichnis documents/mycompany/logos/ verfügbaren Logos auf:

Spalte	Beschreibung
Radio	Optionsfeld zur Auswahl des Logos (oder „Kein Logo")
Logo	PNG-Dateiname mit Vorschausymbol
Größe	Dateigröße in Byte
Datum	Datum des letzten Uploads
Vorschau	Lupensymbol zur Logovorschau
Aktionen	Symbole zum Umbenennen und Löschen

Ein Upload-Formular am Ende der Seite ermöglicht das Hinzufügen neuer PNG-Logos.

Sicherheit: Ist das Logo im Verhältnis zur Kapazität des QR-Codes zu groß, wechselt das Modul automatisch in den Modus ohne Logo, um einen Fehler zu vermeiden. Eine Meldung wird in den Dolibarr-Protokollen erfasst.

Bereich 3 — QR-Code mit konfigurierbaren Daten

QR-Code-Registerkarte eines Kunden/Lieferanten — Feldauswahl

Der Benutzer wählt über Kontrollkästchen die in den QR-Code aufzunehmenden Felder aus:

Die linke Spalte enthält das Kontrollkästchen
Die mittlere Spalte zeigt die Feldbezeichnung und ihren aktuellen Wert (grau, wenn nicht angehakt)
Die rechte Spalte zeigt den erzeugten QR-Code (mit oder ohne Logo, je nach Auswahl)

Die verfügbaren Felder hängen vom Objekt ab:

Objekt	Verfügbare Felder
Kunde/Lieferant	Firma, Adresse, Postleitzahl, Ort, Land, Telefon, E-Mail, URL + Zusatzfelder
Produkt	Ref., Bezeichnung, Beschreibung, Preis netto, Preis brutto, Barcode, Gewicht, Volumen, URL + Zusatzfelder
Lager	Bezeichnung, Kurzname des Standorts, Beschreibung, Adresse, Postleitzahl, Ort, Land, URL + Zusatzfelder
Benutzer	Login, Vorname, Nachname, Telefon, Mobiltelefon, E-Mail, Adresse, Postleitzahl, Ort, Land, URL + Zusatzfelder
Kontakt	Anrede, Vorname, Nachname, Firma, Position, Telefon, Mobiltelefon, E-Mail, Adresse usw.
Rechnung	Ref., Kundenref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL
(weitere)	Objektspezifische Felder

Hinweis: In Dolibarr definierte Zusatzfelder (ergänzende Attribute) werden automatisch zur Liste der verfügbaren Felder hinzugefügt.

Der angezeigte QR-Code ist anklickbar: ein Klick öffnet das Fenster zum Etikettendruck.

Bereich 4 — QR-Code der Datensatz-URL

QR-Code-Registerkarte — unterer Bereich mit URL-QR und Schaltflächen Save/Cancel

Der untere Bereich zeigt:

Die Bezeichnung URL des Datensatzes [Objekt]
Den anklickbaren Link zum Dolibarr-Datensatz
Einen zweiten QR-Code, der die direkte URL zum Datensatz kodiert (ebenfalls anklickbar für den Etikettendruck)
Die Schaltflächen SPEICHERN und ABBRECHEN

Bereich 5 — vCard-QR-Code (Kontakt, Benutzer, Kunde/Lieferant, Mitglied)

vCard-QR-Code auf einem Kontaktdatensatz

Die Datensätze Kontakt, Benutzer, Kunde/Lieferant (Firma) und Mitglied verfügen über einen zusätzlichen vCard-QR-Code am Ende der Seite.

Das Scannen dieses QR-Codes mit einem Smartphone ermöglicht das direkte Hinzufügen des Kontakts zum Telefonverzeichnis. Der kodierte vCard-Inhalt wird als Klartext unter dem QR-Code angezeigt.

Live-Vorschau

[Neu in v24] Die QR-Codes werden in Echtzeit aktualisiert, wenn der Benutzer Folgendes ändert:

die Größe des QR-Codes
die ECC-Qualitätsstufe
das ausgewählte Logo
die angehakten Felder (Daten-QR)

Kein Neuladen der Seite ist erforderlich. Die Vorschau verwendet eine AJAX-Anfrage mit einer Verzögerung von 300 ms, um übermäßige Aufrufe zu vermeiden. Diese Funktion ist auf allen 16 QR-Seiten des Moduls verfügbar.

Automatische Standardfeldauswahl

Bei der ersten Anzeige (keine gespeicherte Konfiguration) wählt das Modul automatisch die Felder aus, deren Wert nicht leer ist. Dies gewährleistet einen relevanten QR-Code bereits bei der ersten Öffnung.

Speichern der Konfiguration

Die gewünschten Felder an-/abhaken und anschließend auf SPEICHERN klicken. Die Auswahl wird gespeichert und gilt für alle Objekte desselben Typs (eine globale Konfiguration pro Objekttyp).

QR-Code-Registerkarte — Beispiele nach Objekt

Kundenrechnung

[Neu in v24]

Beispielkonfiguration für eine Kundenrechnung: Ref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto und Gesamt brutto angehakt. Das Logo expert_dolibarr.png ist ausgewählt und in der Mitte des QR-Codes eingebettet. Die ECC-Qualität wird automatisch auf Hoch (H) erzwungen.

Produkt

Beispielkonfiguration für ein Produkt: Ref. und Bezeichnung angehakt, zusammen mit den Zusatzfeldern Ecotax und ControlHistoryLink. Der QR-Code kodiert diese vier verketteten Werte.

Lager

Nützlich für die physische Kennzeichnung von Lagerorten. Das Feld Kurzname des Standorts ermöglicht die Angabe des Lagerbereichs.

Benutzer

Der Benutzer-QR-Code kodiert Kontaktinformationen (Login, Vorname, Nachname, Telefon, Mobiltelefon, E-Mail, Land...). Praktisch für Ausweise oder interne Visitenkarten.

Hinweis: Die QR-Code-Registerkarte des Benutzers ist nur für den Benutzer selbst oder für Benutzer mit der Berechtigung zum Lesen von Benutzerdatensätzen sichtbar.

Registerkarte QR-Url (nur Kunden/Lieferanten)

Datensätze von Kunden/Lieferanten verfügen über eine zweite QR-Registerkarte namens QR-Url, die auf die Erzeugung von QR-Codes mit eingebettetem Logo spezialisiert ist, die die URL des Datensatzes kodieren.

Funktionen:

Element	Funktion
Größe (1-10)	Auflösung des erzeugten QR-Codes
Datei auswählen + LOGO HOCHLADEN	Ein PNG-Logo zum Einbetten in die Mitte hochladen
QR-Code zur Anzeige auswählen	Auswahl unter den bereits für diesen Kunden/Lieferanten erzeugten QR-Codes
Schaltfläche ANZEIGEN	Zeigt den ausgewählten QR-Code an
Abschnitt Hochgeladene Logos	Liste der verfügbaren Logos mit Download- und Löschoptionen

Der angezeigte QR-Code kodiert die URL des Kunden-/Lieferantendatensatzes, mit dem gewählten Logo in der Mitte des Bildes.

Etikettendruck

Ein Klick auf einen QR-Code in einer beliebigen Registerkarte öffnet ein Druck-Popup-Fenster, optimiert für Etiketten im Format 120 × 57 mm (kompatibel mit gängigen Etikettendruckern).

Das Etikett enthält:

Links: den QR-Code mit konfigurierbaren Daten
In der Mitte: die wichtigsten Textinformationen (Referenz, Bezeichnung, Name usw. je nach Objekt)
Rechts: den QR-Code der Datensatz-URL

Das Fenster löst automatisch den Druckdialog des Browsers aus.

Hinweis: Für einen optimalen Druck auf Klebeetiketten den Drucker auf das Format 120×57mm einstellen und die Ränder in den Druckoptionen des Browsers deaktivieren.

Rechte und Berechtigungen

Berechtigungen des Moduls UltimateQRcode

Das Modul definiert zwei Berechtigungsstufen, die pro Benutzergruppe unter Konfiguration → Benutzer & Gruppen zugewiesen werden:

Berechtigung	Beschreibung	Wirkung
Read qrcode outcomes	QR-Codes lesen	Ermöglicht das Anzeigen der QR-Code-Registerkarten und der erzeugten QR-Codes
Create/Modify qrcode outcomes	Erstellen / Ändern	Ermöglicht das An-/Abhaken der Felder und das Speichern der Konfiguration

Hinweis: Ohne die Berechtigung Read sind die QR-Code-Registerkarten nicht sichtbar. Ohne die Berechtigung Write kann der Benutzer die QR-Codes sehen, aber die Feldauswahl nicht ändern.

Neuerungen und Kompatibilität mit v24

[Neu in v24] Das Modul UltimateQRcode Version 24 bringt folgende Verbesserungen:

Neue Funktionen

Funktion	Beschreibung
Seitenspezifische Einstellungen	Größe, ECC-Qualität und Logo direkt auf jeder QR-Code-Datensatzseite konfigurierbar
Eingebettetes Logo	Möglichkeit, ein PNG-Logo in der Mitte jedes QR-Codes einzubetten, auf allen Seiten
Live-Vorschau	Echtzeit-Aktualisierung der QR-Codes bei Änderung von Größe, ECC, Logo oder angehakten Feldern (AJAX, ohne Neuladen)
vCard-QR-Code	vCard-QR-Code für Kontakte, Benutzer, Kunden/Lieferanten und Mitglieder zum direkten Hinzufügen zum Telefonverzeichnis
Logoverwaltung	Hochladen, Vorschau, Umbenennen und Löschen von Logos direkt über die Oberfläche jeder Datensatzseite

Kompatibilität mit Dolibarr v24

Korrektur	Detail
Modul-Symbol	Hinzufügen der Erweiterung `.png` in der Eigenschaft `$this->picto` des Moduldeskriptors, gemäß der Dolibarr v23+-Warnung.
Währung	Ersetzen von `$conf->currency` (veraltet) durch `getDolCurrency()`.
Konstanten	Ersetzen der direkten Zuweisung `$conf->global->XXX = value` (veraltet) durch `dolibarr_set_const()`.

Fehlerkorrekturen

Fehler	Korrektur
Rechnungs-Registerkarte nicht gefunden	Korrektur der Groß-/Kleinschreibung des Registerkarten-Schlüssels im Moduldeskriptor.
Veralteter Admin-Parameter	Entfernung des Parameters „Anzeigegröße der QR-Codes (in Pixel)", der durch die seitenweise Größeneinstellung überflüssig geworden ist.
Logo-Überlauf	Hinzufügen eines Try/Catch-Mechanismus zur Behandlung des Kapazitätsüberlaufs, wenn das Logo zu groß ist: automatischer Wechsel in den Modus ohne Logo.

Übersetzungen

Hinzufügen der fehlenden Übersetzungsschlüssel in den 5 Sprachdateien (FR, EN, DE, ES, IT) für die neuen Funktionen: Auswahl der ECC-Qualität, Logoverwaltung und alle Objekttypen.

FAQ

Der QR-Code ist leer oder zeigt „Keine Daten": Kein Feld ist angehakt, oder alle angehakten Felder haben im Datensatz einen leeren Wert. Mindestens ein Feld mit einem Wert anhaken und auf SPEICHERN klicken.

Das Etikett wird nicht in der richtigen Größe gedruckt: Überprüfen, ob das Papierformat des Druckers korrekt auf 120×57mm eingestellt ist. Ränder in den Druckoptionen des Browsers deaktivieren.

Zusatzfelder werden nicht angezeigt: Die ergänzenden Attribute müssen unter Konfiguration → Ergänzende Attribute für das betreffende Objekt definiert sein.

Der QR-Code mit Logo ist nicht lesbar: Das Logo nimmt zu viel Fläche ein. Ein kleineres Logo verwenden (idealerweise quadratisch, weniger als 100×100 Pixel) oder die ECC-Stufe auf H erhöhen, um die Fehlerkorrektur zu verbessern. Mit Modul v24 wird die ECC-Qualität automatisch auf H erzwungen, wenn ein Logo ausgewählt ist.

Der QR-Code wird ohne Logo angezeigt, obwohl ich eines ausgewählt habe: Das Logo ist wahrscheinlich im Verhältnis zum kodierten Inhalt zu groß. Das Modul wechselt automatisch in den Modus ohne Logo, um einen Fehler zu vermeiden. Ein kleineres Logo ausprobieren oder die Anzahl der angehakten Felder verringern.

Die QR-Codes werden bei Änderung der Einstellungen nicht aktualisiert: Die Live-Vorschau erfordert aktiviertes JavaScript im Browser. Prüfen, ob kein Skriptblocker aktiv ist. Die QR-Codes werden automatisch 300 ms nach jeder Änderung aktualisiert.

Die QR-Code-Registerkarte erscheint bei manchen Datensätzen nicht: Überprüfen, ob das Modul aktiviert ist und der Benutzer über die Berechtigung Read qrcode outcomes verfügt.

Siehe auch