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 | PHP 8.2 mindestens, PHP-Erweiterung GD
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-09-29 |
| Note / Nota | Kompatibel mit Dolibarr v25 und PHP 8.5 |
UltimateQRcode fügt den Dolibarr-Datensätzen QR-Codes hinzu (Partner, Kontakte, Produkte, Verkaufsdokumente, Projekte…). Jeder QR-Code codiert die von Ihnen gewählten Felder, kann in der Mitte ein Logo tragen und wird auf einem Etikett von 120 × 57 mm gedruckt. Personendatensätze erhalten zusätzlich einen vCard-QR-Code, den ein Smartphone scannt, um den Kontakt ins Adressbuch zu übernehmen.
Voraussetzungen
| Element | Version |
|---|---|
| Dolibarr | 25.0.0 oder höher |
| PHP | 8.2 mindestens (getestet bis PHP 8.5) |
| PHP-Erweiterung | GD (Erzeugung der PNG-Bilder) |
| Dolibarr-Module | Kein Pflichtmodul. Die Reiter erscheinen nur bei Objekten, deren Modul aktiviert ist (Rechnungen, Lager, Projekte…) |
Die Bibliotheken chillerlan/php-qrcode und michelf/php-markdown werden mit dem Modul ausgeliefert: eine Composer-Installation ist nicht nötig.
Installation
- Das Archiv
module_ultimateqrcode-25.0.x.zipim DoliStore herunterladen - In Dolibarr: Start → Einstellungen → Module/Anwendungen, Reiter Externes Modul bereitstellen/installieren, das Archiv hochladen. Andernfalls das Archiv in
htdocs/custom/entpacken: Sie müssenhtdocs/custom/ultimateqrcode/erhalten - Das Modul UltimateQRcode in der Liste suchen und aktivieren
- Den Benutzern oder Gruppen die Berechtigungen zuweisen (siehe Berechtigungen)
- Aktualisierung von einer älteren Version: den Ordner
ultimateqrcodeersetzen, dann das Modul deaktivieren und wieder aktivieren, damit Dolibarr die Reiter und Berechtigungen neu lädt.
Einrichtung des Moduls
Die Einrichtungsseite öffnen Sie über Start → Einstellungen → Module/Anwendungen → UltimateQRcode (Zahnrad-Symbol).
Die Einrichtungsseite hat vier Reiter: QR-Codes, QR mit Logo, Benutzerhandbuch und Über.
Reiter „QR-Codes“ (freier Generator)
Dieser Reiter ist ein QR-Code-Generator auf Abruf: der hier erzeugte QR-Code ist mit keinem Dolibarr-Datensatz verknüpft und kann beliebige Inhalte codieren.
| Feld | Beschreibung |
|---|---|
| Geben Sie hier die Daten ein, die im QR-Code codiert werden sollen | Der zu codierende Inhalt: URL, E-Mail-Adresse, Telefonnummer, Freitext… |
| Qualität | Fehlerkorrekturstufe: • Niedrig (L, ≈ 7 %): kompaktester QR-Code • Mittel (M, ≈ 15 %): üblicher Einsatz • Mittel-Hoch (Q, ≈ 25 %): gute Widerstandsfähigkeit • Hoch (H, ≈ 30 %): sehr widerstandsfähig gegen Verschmutzung und Kratzer |
| Größe | 1 bis 10 Pixel pro QR-Code-Modul |
| Schaltfläche ERZEUGEN | Erzeugt und zeigt den QR-Code an |
| Schaltfläche ETIKETT DRUCKEN | Öffnet den QR-Code auf einem Etikett von 120 × 57 mm (siehe Etikettendruck) |
Reiter „QR mit Logo“
Dieser Reiter erzeugt einen freien QR-Code mit einem Logo in der Mitte. Die erzeugten QR-Codes werden im temporären Ordner des Moduls aufbewahrt und können erneut angezeigt, gedruckt oder gelöscht werden.
| Element | Beschreibung |
|---|---|
| Geben Sie hier die Daten ein, die im QR-Code codiert werden sollen | URL oder zu codierender Inhalt |
| Größe | 2 bis 10, steuert die Bildauflösung |
| Logo-Tabelle | In documents/mycompany/logos/ verfügbare Logos, mit Größe, Datum, Vorschau (Lupe), Umbenennen und Löschen. Das Optionsfeld wählt das einzubettende Logo
|
| Schaltfläche ERZEUGEN | Erzeugt den QR-Code mit dem gewählten Logo |
| UPLOAD | Fügt ein neues Logo hinzu (PNG empfohlen) |
| QR-Code zur Anzeige auswählen + ANZEIGEN | Zeigt einen zuvor erzeugten QR-Code erneut an |
| Symbol Papierkorb | Löscht den gewählten QR-Code nach Bestätigung |
| Schaltfläche ETIKETT DRUCKEN | Druckt den angezeigten QR-Code auf ein Etikett von 120 × 57 mm |
- Hinweis: die Fehlerkorrektur wird auf Hoch erzwungen, da das Logo einen Teil der Matrix verdeckt.
Reiter „Benutzerhandbuch“
Das vollständige Benutzerhandbuch ist direkt in Dolibarr lesbar, in der Sprache des Benutzers (Französisch, Englisch, Deutsch, Spanisch oder Italienisch).
Reiter „Über“
Zeigt die Modulversion, den Autor, die Lizenz und Links zur Dokumentation.
Verwendung in den Datensätzen
Das Modul fügt den Datensätzen der folgenden 16 Objekte einen Reiter QR-Code hinzu:
| Objekt | Hinzugefügter Reiter | vCard-QR-Code |
|---|---|---|
| Partner | QR-Code | Ja |
| Kontakt / Adresse | QR-Code | Ja |
| Benutzer | QR-Code | Ja |
| Mitglied | QR-Code | Ja |
| Benutzergruppe | QR-Code | |
| Produkt / Leistung | QR-Code | |
| Charge / Seriennummer | QR-Code | |
| Lager | QR-Code | |
| Angebot | QR-Code | |
| Kundenauftrag | QR-Code | |
| Lieferantenbestellung | QR-Code | |
| Kundenrechnung | QR-Code | |
| Lieferantenrechnung | QR-Code | |
| Vertrag | QR-Code | |
| Serviceauftrag | QR-Code | |
| Projekt | QR-Code |
Gemeinsamer Aufbau des Reiters QR-Code
Jeder Reiter QR-Code ist in fünf Bereiche gegliedert.
Bereich 1 — Einstellungsleiste
Oben im Reiter lässt sich in einer Einstellungsleiste wählen:
| Einstellung | Beschreibung |
|---|---|
| Größe | Auflösung des QR-Codes, 2 bis 10 Pixel pro Modul |
| Qualität | Fehlerkorrektur: Niedrig (L), Mittel (M), Mittel-Hoch (Q) oder Hoch (H) |
| Logo | In der Mitte des QR-Codes eingebettetes Logo, gewählt in der Tabelle von Bereich 2 |
- Hinweis: sobald ein Logo gewählt ist, wird die Qualität auf Hoch (H) erzwungen und neben dem Auswahlfeld erscheint der Vermerk (Mit Logo auf Hoch erzwungen).
Diese Einstellungen werden pro Objekttyp gespeichert (Rechnungen, Angebote, Aufträge…) und gelten für alle QR-Codes des Reiters.
Bereich 2 — Logo-Auswahltabelle
Die Tabelle listet die Logos des Ordners documents/mycompany/logos/ auf:
| Spalte | Beschreibung |
|---|---|
| Optionsfeld | Wählt das Logo oder „Kein Logo“ |
| Logo | Dateiname |
| Größe | Dateigröße in Byte |
| Datum | Datum des Uploads |
| Vorschau | Lupe zum Anzeigen des Logos |
| Aktionen | Umbenennen und Löschen |
Ein Formular unten auf der Seite lädt neue Logos hoch.
- Sicherheit: ist das Logo für die Kapazität des QR-Codes zu groß, erzeugt das Modul den QR-Code ohne Logo, statt einen Fehler auszulösen, und vermerkt den Vorfall im Dolibarr-Protokoll.
Bereich 3 — Daten-QR-Code
Sie wählen die zu codierenden Felder durch Ankreuzen:
- das Kontrollkästchen nimmt das Feld auf oder schließt es aus;
- die mittlere Spalte zeigt die Bezeichnung und den aktuellen Wert des Feldes (ausgegraut, wenn nicht angekreuzt);
- der erzeugte QR-Code erscheint neben der Tabelle, mit oder ohne Logo, zusammen mit der Schaltfläche ETIKETT DRUCKEN.
Verfügbare Felder je Objekt:
| Objekt | Verfügbare Felder |
|---|---|
| Partner | Firma, Adresse, PLZ, Ort, Land, Telefon, E-Mail, URL |
| Kontakt | Vorname, Nachname, Telefon, Mobiltelefon, E-Mail, Adresse, PLZ, Ort, Land, URL |
| Benutzer | Login, Vorname, Nachname, Telefon, Mobiltelefon, E-Mail, Adresse, PLZ, Ort, Land, URL |
| Mitglied | Vorname, Nachname, Telefon, Privattelefon, E-Mail, Adresse, PLZ, Ort, Land, URL |
| Benutzergruppe | Gruppenname, Beschreibung, URL |
| Produkt / Leistung | Ref., Bezeichnung, Beschreibung, Preis netto, Preis brutto, Barcode, Gewicht, Volumen, URL |
| Charge / Seriennummer | Charge/Seriennr., Verbrauchsdatum, Mindesthaltbarkeitsdatum, URL |
| Lager | Bezeichnung, Kurzname des Lagerorts, Beschreibung, Adresse, PLZ, Ort, Land, URL |
| Angebot | Ref., Kundenref., Firma, E-Mail, Telefon, Datum, Gültig bis, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL |
| Kundenauftrag | Ref., Kundenref., Firma, E-Mail, Telefon, Datum, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL |
| Lieferantenbestellung | Ref., Lieferantenref., Firma, E-Mail, Telefon, Datum, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL |
| Kundenrechnung | Ref., Kundenref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL |
| Lieferantenrechnung | Ref., Lieferantenref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL |
| Vertrag | Ref., Kundenref., Lieferantenref., Firma, E-Mail, Telefon, Vertragsdatum, Öffentliche Notiz, URL |
| Serviceauftrag | Ref., Firma, E-Mail, Telefon, Datum, Beschreibung, URL |
| Projekt | Ref., Projektbezeichnung, Firma, E-Mail, Telefon, Startdatum, Enddatum, Öffentliche Notiz, URL |
- Hinweis: die im Datensatz ausgefüllten Zusatzfelder werden automatisch in die Liste aufgenommen, in der Form Zusatzfeld : Bezeichnung. Von anderen Modulen angelegte Zusatzfelder werden ignoriert.
Bereich 4 — QR-Code der Datensatz-URL
Rechts (oder je nach Bildschirmbreite unter der Tabelle) zeigt der Reiter:
- die Bezeichnung der Datensatz-URL, gefolgt von einem Link zum Datensatz;
- einen zweiten QR-Code mit der direkten URL des Datensatzes, ebenfalls als Etikett druckbar;
- unten auf der Seite die Schaltflächen SPEICHERN und ABBRECHEN.
Bereich 5 — vCard-QR-Code (Partner, Kontakt, Benutzer, Mitglied)
Die Datensätze Partner, Kontakt, Benutzer und Mitglied zeigen zusätzlich einen vCard-QR-Code. Mit einem Smartphone gescannt, bietet er an, den Kontakt direkt ins Adressbuch zu übernehmen. Der codierte vCard-3.0-Inhalt wird im Klartext neben dem QR-Code angezeigt.
Live-Vorschau
Die QR-Codes werden in Echtzeit aktualisiert, wenn Sie Folgendes ändern:
- die Größe;
- die Qualität;
- das Logo;
- die angekreuzten Felder.
Kein Neuladen der Seite nötig. Die Vorschau nutzt eine AJAX-Anfrage, die 300 ms nach der letzten Änderung gesendet wird. Sie funktioniert auf allen 16 Reitern QR-Code.
Automatische Vorauswahl der Felder
Bei der ersten Anzeige, solange keine Konfiguration gespeichert wurde, kreuzt das Modul die im Datensatz ausgefüllten Felder an. Der QR-Code ist so schon beim ersten Öffnen aussagekräftig.
Speichern der Konfiguration
Felder an- oder abwählen, dann auf SPEICHERN klicken. Die Auswahl gilt für alle Objekte desselben Typs (eine Konfiguration pro Objekttyp).
Reiter QR-Code — Beispiele je Objekt
Kundenrechnung
Beispiel einer Kundenrechnung: Ref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto, Gesamt brutto und URL sind angekreuzt. Das Logo expert_dolibarr.png ist in der Mitte beider QR-Codes eingebettet, die Qualität ist auf Hoch (H) erzwungen.
Produkt
Bei einem Produkt kann der QR-Code Referenz, Bezeichnung, Preise, Barcode, Gewicht und Volumen codieren: praktisch für die Regal- oder Lagerkennzeichnung.
Lager
Nützlich, um Lagerorte physisch zu kennzeichnen. Das Feld Kurzname des Lagerorts gibt den Bereich an (Gang, Regal…).
Benutzer
Der Benutzer-QR-Code codiert die geschäftlichen Kontaktdaten (Login, Vorname, Nachname, Telefonnummern, E-Mail, Adresse…), und der vCard-QR-Code übernimmt sie in ein Adressbuch. Praktisch für Ausweise oder interne Visitenkarten.
- Hinweis: der Reiter QR-Code eines Benutzers ist nur für den Benutzer selbst oder für Benutzer mit Leserecht auf Benutzerdatensätze sichtbar.
Wiederverwendbares QR-Code-Bild (QR mit Logo)
Um ein QR-Code-Bild mit Logo anderswo zu verwenden (Website, Broschüre, E-Mail-Signatur), nutzen Sie den Einrichtungsreiter QR mit Logo:
- die URL des Datensatzes oder einen anderen Inhalt in das Eingabefeld eingeben;
- Größe und Logo wählen, dann auf ERZEUGEN klicken;
- den QR-Code jederzeit über QR-Code zur Anzeige auswählen erneut anzeigen, drucken oder löschen.
- Hinweis: der frühere Reiter „QR-Url“ der Partner, den das Modul nicht mehr deklarierte, wurde entfernt. Der QR-Code der Datensatz-URL bleibt in Bereich 4 jedes Reiters QR-Code verfügbar.
Etikettendruck
Die Schaltfläche ETIKETT DRUCKEN oder ein Klick auf einen QR-Code öffnet ein Druckfenster im Format 120 × 57 mm, passend für gängige Etikettendrucker.
Das Etikett eines Datensatzes enthält:
- links: den Daten-QR-Code;
- in der Mitte: die wichtigsten Angaben des Datensatzes (Referenz, Partner, Gesamtbetrag… je nach Objekt);
- rechts: den QR-Code der Datensatz-URL.
Die Generatoren der Reiter QR-Codes und QR mit Logo drucken den soeben erzeugten QR-Code auf die gleiche Weise.
Das Fenster öffnet automatisch den Druckdialog des Browsers.
- Hinweis: für beste Ergebnisse auf Klebeetiketten den Drucker auf das Format 120 × 57 mm einstellen und in den Druckoptionen des Browsers die Ränder entfernen.
Berechtigungen
Das Modul definiert zwei Berechtigungen, die pro Benutzer oder Gruppe unter Benutzer & Gruppen vergeben werden:
| Berechtigung | Wirkung |
|---|---|
| QR-Codes lesen | Zeigt die Reiter QR-Code und die erzeugten QR-Codes an |
| QR-Codes erstellen / ändern | Erlaubt das An- und Abwählen der Felder und das Speichern der Konfiguration |
- Hinweis: ohne Leseberechtigung sind die Reiter QR-Code ausgeblendet. Ohne Änderungsberechtigung sieht der Benutzer die QR-Codes, kann aber die Feldauswahl nicht ändern. Hochladen, Umbenennen und Löschen von Logos ist Administratoren vorbehalten.
Neuerungen und Kompatibilität v25
Version 25.0.0 passt UltimateQRcode an Dolibarr 25 an.
| Änderung | Detail |
|---|---|
| Mindestversionen | Dolibarr 25.0.0 und PHP 8.2 |
| PHP 8.4 und 8.5 | Das Modul löst keine Deprecation-Meldung aus: Eigenschaften des Deskriptors an den Core angepasst, Seite „Über“ ohne Warnung |
| Zahlungs-Reiter | Die Reiter „QR-Code“ der Kunden- und Lieferantenzahlungen, die auf nicht vorhandene Seiten verwiesen (Fehler 404), wurden entfernt |
| Reiter QR-Url | Die verwaiste Seite des früheren Reiters QR-Url der Partner wurde gelöscht; die Dokumentation verweist auf den Reiter QR mit Logo |
| Übersetzte Berechtigungen | Beide Berechtigungen erscheinen jetzt in der Sprache des Benutzers („QR-Codes lesen“, „QR-Codes erstellen / ändern“) |
| vCard-Anzeige | vCard-Inhalt und mehrzeilige Adressen werden korrekt angezeigt, ohne sichtbares „\n“ und ohne Überlaufen der Seite |
| Zusatzfelder | Die Bezeichnung „Zusatzfeld“ ist übersetzt (vorher erschien „ExtraField“) |
| Benutzerhandbuch | Neuer Einrichtungsreiter mit dem vollständigen Handbuch in 5 Sprachen |
| Continuous Integration | Jede PHP-Datei des Moduls wird mit php -l unter PHP 8.4 und 8.5 geprüft
|
Historie v24
Neue Funktionen in v24
| Funktion | Beschreibung |
|---|---|
| Einstellungen pro Datensatz | Größe, Qualität und Logo direkt in jedem Reiter QR-Code einstellbar |
| Eingebettetes Logo | PNG-Logo in der Mitte jedes QR-Codes, auf allen Seiten |
| Live-Vorschau | Aktualisierung der QR-Codes in Echtzeit bei Änderung von Größe, Qualität, Logo oder Feldern |
| vCard-QR-Code | Für Partner, Kontakte, Benutzer und Mitglieder |
| Logo-Verwaltung | Hochladen, Vorschau, Umbenennen und Löschen von Logos in jedem Datensatz |
Kompatibilität mit Dolibarr v24
| Korrektur | Detail |
|---|---|
| Modul-Picto | Endung .png in der Eigenschaft $this->picto des Deskriptors ergänzt
|
| Währung | getDolCurrency() statt $conf->currency (veraltet)
|
| Konstanten | dolibarr_set_const() statt direktem Schreiben in $conf->global
|
Fehlerbehebungen in v24
| Fehler | Korrektur |
|---|---|
| Rechnungsreiter nicht gefunden | Groß-/Kleinschreibung des Reiterschlüssels im Deskriptor korrigiert |
| Veralteter Einrichtungsparameter | „Anzeigegröße der QR-Codes (in Pixel)“ entfernt, ersetzt durch die Größeneinstellung jedes Datensatzes |
| Logo zu groß | Automatischer Rückfall auf „ohne Logo“ statt eines Fehlers |
Übersetzungen in v24
Fehlende Übersetzungsschlüssel in den 5 Sprachen (FR, EN, DE, ES, IT) ergänzt: Qualität, Logo-Verwaltung und alle Objekttypen.
FAQ
- Der QR-Code ist leer oder zeigt „Keine Daten“
- Kein Feld ist angekreuzt, oder die angekreuzten Felder sind im Datensatz leer. Mindestens ein ausgefülltes Feld ankreuzen und auf SPEICHERN klicken.
- Das Etikett wird nicht in der richtigen Größe gedruckt
- Prüfen Sie, dass das Papierformat des Druckers auf 120 × 57 mm eingestellt ist, und entfernen Sie die Ränder in den Druckoptionen des Browsers.
- Die Zusatzfelder erscheinen nicht
- Nur im Datensatz ausgefüllte Zusatzfelder werden angeboten. Sie werden in der Einrichtung des betreffenden Moduls definiert (zum Beispiel Partner → Ergänzende Attribute).
- Der QR-Code mit Logo ist nicht lesbar
- Das Logo bedeckt zu viel Fläche. Verwenden Sie ein kleineres, möglichst quadratisches Logo. Die Qualität ist bereits auf Hoch (H) erzwungen, sobald ein Logo gewählt ist.
- Der QR-Code erscheint ohne Logo, obwohl ich eines gewählt habe
- Das Logo ist für den codierten Inhalt zu groß: das Modul erzeugt den QR-Code dann ohne Logo. Versuchen Sie ein kleineres Logo oder kreuzen Sie weniger Felder an.
- Die QR-Codes werden bei Änderung der Einstellungen nicht aktualisiert
- Die Live-Vorschau benötigt JavaScript. Prüfen Sie, dass kein Skriptblocker aktiv ist.
- Der Reiter QR-Code fehlt bei manchen Datensätzen
- Prüfen Sie, dass das Modul aktiviert ist, dass das Dolibarr-Modul des Objekts ebenfalls aktiviert ist und dass der Benutzer die Berechtigung QR-Codes lesen besitzt. Nach einer Aktualisierung UltimateQRcode deaktivieren und wieder aktivieren.
- Wo ist der Reiter QR-Url der Partner geblieben?
- Er wurde entfernt. Der QR-Code der Datensatz-URL steht im Reiter QR-Code (Bereich 4), und der Einrichtungsreiter QR mit Logo erzeugt wiederverwendbare Bilder.