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
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
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
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)
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
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.