Module Ultimateqrcode DE: Difference between revisions

From Dolibarr ERP CRM Wiki
Jump to navigation Jump to search
VisualWikitext
(Created page with "<!-- BEGIN interlang links --> <!-- Do NOT edit this section Links below are automatically managed by PolyglotBot You can edit links on the English source page : Mod...")
Tag: 2017 source edit
 
No edit summary
Tag: 2017 source edit
 
Line 3: Line 3:
     Links below are automatically managed by PolyglotBot
     Links below are automatically managed by PolyglotBot
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
     You can edit links on the English source page : Module_Ultimateqrcode_EN -->
[[fr:Module_Ultimateqrcode_FR]]
[[en:Module_Ultimateqrcode_EN]]
[[en:Module_Ultimateqrcode_EN]]
[[fr:Module_Ultimateqrcode_FR]]
[[es:Module_Ultimateqrcode_ES]]
[[es:Module_Ultimateqrcode_ES]]
[[it:Module_Ultimateqrcode_IT]]
[[it:Module_Ultimateqrcode_IT]]
Line 20: Line 20:
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|webbuy={{LinkToPluginDownloadDoliStore|keyword=ultimateqrcode}}
|status=stable
|status=stable
|prerequisites=
|prerequisites=PHP 8.2 mindestens, PHP-Erweiterung GD
|minversion=17.0.0
|minversion=25.0.0
|note=Kompatibel mit Dolibarr v24
|note=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 =
{| class="wikitable"
! 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 =
= Installation =


# Laden Sie das Modul herunter und legen Sie es im Verzeichnis <code>htdocs/custom/ultimateqrcode/</code> ab
# Das Archiv <code>module_ultimateqrcode-25.0.x.zip</code> im [https://www.dolistore.com DoliStore] herunterladen
# In Dolibarr: '''Home → Konfiguration → Module/Anwendungen'''
# In Dolibarr: '''Start → Einstellungen → Module/Anwendungen''', Reiter '''Externes Modul bereitstellen/installieren''', das Archiv hochladen. Andernfalls das Archiv in <code>htdocs/custom/</code> entpacken: Sie müssen <code>htdocs/custom/ultimateqrcode/</code> erhalten
# Suchen Sie das Modul '''UltimateQRcode''' im Bereich ''Atoo-Net'' und aktivieren Sie es
# Das Modul '''UltimateQRcode''' in der Liste suchen und aktivieren
# Die Rechte müssen pro Benutzergruppe konfiguriert werden (siehe [[#Rechte_und_Berechtigungen|Rechte und Berechtigungen]])
# Den Benutzern oder Gruppen die Berechtigungen zuweisen (siehe [[#Berechtigungen|Berechtigungen]])
 
: '''Aktualisierung von einer älteren Version:''' den Ordner <code>ultimateqrcode</code> ersetzen, dann das Modul '''deaktivieren und wieder aktivieren''', damit Dolibarr die Reiter und Berechtigungen neu lädt.


----
----


= Modulkonfiguration =
= Einrichtung des Moduls =


Die Konfiguration erreichen Sie über '''Home → Konfiguration → Module/Anwendungen → UltimateQRcode''' (Schraubenschlüssel-Symbol) oder direkt über das Administrationsmenü.
Die Einrichtungsseite öffnen Sie über '''Start → Einstellungen → Module/Anwendungen → UltimateQRcode''' (Zahnrad-Symbol).


Die Konfigurationsseite besteht aus drei Registerkarten.
Die Einrichtungsseite hat vier Reiter: '''QR-Codes''', '''QR mit Logo''', '''Benutzerhandbuch''' und '''Über'''.


== Registerkarte „QR-Codes" (freier Generator) ==
== Reiter „QR-Codes“ (freier Generator) ==


[[File:Ultimateqrcode-admin-qrcodes-fr.png|center|900px|Freier QR-Code-Generator]]
[[File:Ultimateqrcode-v25-admin-qrcodes-de.png|center|900px|Freier QR-Code-Generator]]


Diese Registerkarte bietet einen '''QR-Code-Generator auf Anfrage''':
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.


{| class="wikitable"
{| class="wikitable"
! Feld !! Beschreibung
! Feld !! Beschreibung
|-
|-
| '''Data''' || Der zu kodierende Inhalt: URL, E-Mail-Adresse, Freitext, vCard usw.
| '''Geben Sie hier die Daten ein, die im QR-Code codiert werden sollen''' || Der zu codierende Inhalt: URL, E-Mail-Adresse, Telefonnummer, Freitext…
|-
|-
| '''ECC''' || Fehlerkorrekturstufe:<br/>• '''L''' (≈7% — kleinste): minimale Größe<br/>• '''M''' (≈15%): übliche Verwendung<br/>• '''Q''' (≈25%): gute Widerstandsfähigkeit<br/>• '''H''' (≈30% — beste): sehr widerstandsfähig (empfohlen mit Logo)
| '''Qualität''' || Fehlerkorrekturstufe:<br/>• '''Niedrig''' (L, ≈ 7 %): kompaktester QR-Code<br/>• '''Mittel''' (M, ≈ 15 %): üblicher Einsatz<br/>• '''Mittel-Hoch''' (Q, ≈ 25 %): gute Widerstandsfähigkeit<br/>• '''Hoch''' (H, ≈ 30 %): sehr widerstandsfähig gegen Verschmutzung und Kratzer
|-
|-
| '''Size''' || Punktgröße (von 1 bis 10 Pixel pro QR-Modul)
| '''Größe''' || 1 bis 10 Pixel pro QR-Code-Modul
|-
|-
| Schaltfläche '''GENERATE''' || Erzeugt und zeigt sofort den QR-Code an
| 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|Etikettendruck]])
|}
|}


Klicken Sie im Hilfetext auf '''Like this''', um ein Generierungsbeispiel zu sehen.
== Reiter „QR mit Logo“ ==
 
== Registerkarte „QR mit Logo" ==


[[File:Ultimateqrcode-admin-qrwithlogo-fr.png|center|900px|QR-Generator mit eingebettetem Logo]]
[[File:Ultimateqrcode-v25-admin-qrwithlogo-de.png|center|900px|QR-Code-Generator mit Logo]]


Diese Registerkarte ermöglicht die Erstellung eines '''QR-Codes mit einem in der Mitte eingefügten 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.


{| class="wikitable"
{| class="wikitable"
! Feld !! Beschreibung
! Element !! Beschreibung
|-
| '''Geben Sie hier die Daten ein, die im QR-Code codiert werden sollen''' || URL oder zu codierender Inhalt
|-
|-
| '''Data''' || Zu kodierende URL oder Inhalt (Standard: https://www.atoo-net.com/)
| '''Größe''' || 2 bis 10, steuert die Bildauflösung
|-
|-
| '''Größe''' || Von 1 bis 10 — steuert die Auflösung des erzeugten Bildes
| '''Logo-Tabelle''' || In <code>documents/mycompany/logos/</code> verfügbare Logos, mit Größe, Datum, Vorschau (Lupe), Umbenennen und Löschen. Das Optionsfeld wählt das einzubettende Logo
|-
|-
| '''Datei auswählen''' || PNG-Logo, das in der Mitte des QR-Codes eingebettet werden soll
| Schaltfläche '''ERZEUGEN''' || Erzeugt den QR-Code mit dem gewählten Logo
|-
|-
| Schaltfläche '''GENERATE''' || Erzeugt den QR-Code mit dem Logo und speichert ihn
| '''UPLOAD''' || Fügt ein neues Logo hinzu (PNG empfohlen)
|-
|-
| '''QR-Code zur Anzeige auswählen''' || Auswahl unter bereits erzeugten QR-Codes zur Anzeige
| '''QR-Code zur Anzeige auswählen''' + '''ANZEIGEN''' || Zeigt einen zuvor erzeugten QR-Code erneut an
|-
|-
| Schaltfläche '''ANZEIGEN''' || Zeigt den ausgewählten QR-Code an
| Symbol '''Papierkorb''' || Löscht den gewählten QR-Code nach Bestätigung
|-
|-
| Symbol '''Papierkorb''' || Löscht die ausgewählte QR-Datei (mit Bestätigung)
| Schaltfläche '''ETIKETT DRUCKEN''' || Druckt den angezeigten QR-Code auf ein Etikett von 120 × 57 mm
|}
|}


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 Fehlerkorrektur wird '''auf Hoch erzwungen''', da das Logo einen Teil der Matrix verdeckt.
 
== Reiter „Benutzerhandbuch“ ==
 
[[File:Ultimateqrcode-v25-admin-guide-de.png|center|900px|Integriertes Benutzerhandbuch]]


: '''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.
Das vollständige Benutzerhandbuch ist direkt in Dolibarr lesbar, in der Sprache des Benutzers (Französisch, Englisch, Deutsch, Spanisch oder Italienisch).


== Registerkarte „Über" ==
== Reiter „Über“ ==


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


----
----
Line 96: Line 126:
= Verwendung in den Datensätzen =
= Verwendung in den Datensätzen =


Das Modul fügt eine Registerkarte '''QR-Code''' in den Datensätzen folgender Objekte hinzu:
Das Modul fügt den Datensätzen der folgenden 16 Objekte einen Reiter '''QR-Code''' hinzu:


{| class="wikitable"
{| class="wikitable"
! Objekt !! Hinzugefügte Registerkarte(n)
! Objekt !! Hinzugefügter Reiter !! vCard-QR-Code
|-
| Kunde/Lieferant || QR-Code + QR-Url (separate Registerkarten)
|-
|-
| Kontakt || QR-Code
| Partner || QR-Code || Ja
|-
|-
| Produkt / Dienstleistung || QR-Code
| Kontakt / Adresse || QR-Code || Ja
|-
|-
| Los / Seriennummer || QR-Code
| Benutzer || QR-Code || Ja
|-
|-
| Lager || QR-Code
| Mitglied || QR-Code || Ja
|-
|-
| Angebot || QR-Code
| Benutzergruppe || QR-Code ||
|-
|-
| Kundenauftrag || QR-Code
| Produkt / Leistung || QR-Code ||
|-
|-
| Lieferantenauftrag || QR-Code
| Charge / Seriennummer || QR-Code ||
|-
|-
| Kundenrechnung || QR-Code
| Lager || QR-Code ||
|-
|-
| Lieferantenrechnung || QR-Code
| Angebot || QR-Code ||
|-
|-
| Vertrag || QR-Code
| Kundenauftrag || QR-Code ||
|-
|-
| Einsatz || QR-Code
| Lieferantenbestellung || QR-Code ||
|-
|-
| Projekt || QR-Code
| Kundenrechnung || QR-Code ||
|-
|-
| Mitglied (Verein) || QR-Code
| Lieferantenrechnung || QR-Code ||
|-
|-
| Benutzergruppe || QR-Code
| Vertrag || QR-Code ||
|-
|-
| Benutzer || QR-Code
| Serviceauftrag || QR-Code ||
|-
|-
| Projekt || QR-Code ||
|}
|}


== Gemeinsame Struktur der QR-Code-Registerkarte ==
== Gemeinsamer Aufbau des Reiters QR-Code ==


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


=== Bereich 1 — Einstellungsleiste ===
=== Bereich 1 — Einstellungsleiste ===


[[File:Ultimateqrcode-v24-settings-panel-fr.png|center|900px|Einstellungsfeld: Größe, ECC-Qualität und Logoauswahl]]
Oben im Reiter lässt sich in einer Einstellungsleiste wählen:
 
Oben auf jeder QR-Code-Registerkarte ermöglicht eine Einstellungsleiste die Konfiguration von:


{| class="wikitable"
{| class="wikitable"
! Einstellung !! Beschreibung
! 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.
| '''Größe''' || Auflösung des QR-Codes, 2 bis 10 Pixel pro Modul
|-
|-
| '''Qualität (ECC)''' || Fehlerkorrekturstufe: Niedrig (L ≈ 7%), Mittel (M ≈ 15%), Viertel (Q ≈ 25%), Hoch (H ≈ 30%).
| '''Qualität''' || Fehlerkorrektur: Niedrig (L), Mittel (M), Mittel-Hoch (Q) oder Hoch (H)
|-
|-
| '''Logo''' || PNG-Logo, das in der Mitte des QR-Codes eingebettet wird, auswählbar aus den hochgeladenen Logos.
| '''Logo''' || In der Mitte des QR-Codes eingebettetes Logo, gewählt in der Tabelle von Bereich 2
|}
|}


: '''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.
: '''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 '''unabhängig pro Objekttyp''' (Rechnung, Angebot, Auftrag usw.) gespeichert und gelten für beide angezeigten QR-Codes (Daten und URL).
Diese Einstellungen werden '''pro Objekttyp''' gespeichert (Rechnungen, Angebote, Aufträge…) und gelten für alle QR-Codes des Reiters.


=== Bereich 2 — Logo-Auswahltabelle ===
=== Bereich 2 — Logo-Auswahltabelle ===


Die Tabelle listet die im Verzeichnis <code>documents/mycompany/logos/</code> verfügbaren Logos auf:
Die Tabelle listet die Logos des Ordners <code>documents/mycompany/logos/</code> auf:


{| class="wikitable"
{| class="wikitable"
! Spalte !! Beschreibung
! Spalte !! Beschreibung
|-
|-
| '''Radio''' || Optionsfeld zur Auswahl des Logos (oder „''Kein Logo''")
| '''Optionsfeld''' || Wählt das Logo oder „''Kein Logo''“
|-
|-
| '''Logo''' || PNG-Dateiname mit Vorschausymbol
| '''Logo''' || Dateiname
|-
|-
| '''Größe''' || Dateigröße in Byte
| '''Größe''' || Dateigröße in Byte
|-
|-
| '''Datum''' || Datum des letzten Uploads
| '''Datum''' || Datum des Uploads
|-
|-
| '''Vorschau''' || Lupensymbol zur Logovorschau
| '''Vorschau''' || Lupe zum Anzeigen des Logos
|-
|-
| '''Aktionen''' || Symbole zum Umbenennen und Löschen
| '''Aktionen''' || Umbenennen und Löschen
|}
|}


Ein Upload-Formular am Ende der Seite ermöglicht das Hinzufügen neuer PNG-Logos.
Ein Formular unten auf der Seite lädt neue Logos hoch.


: '''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.
: '''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 — QR-Code mit konfigurierbaren Daten ===
=== Bereich 3 — Daten-QR-Code ===


[[File:Ultimateqrcode-thirdparty-qrcode-top-fr.png|center|900px|QR-Code-Registerkarte eines Kunden/Lieferanten — Feldauswahl]]
[[File:Ultimateqrcode-v25-thirdparty-qrcode-de.png|center|900px|Reiter QR-Code eines Partners: Felder, Daten-QR-Code, URL-QR-Code und vCard-QR-Code]]


Der Benutzer wählt über Kontrollkästchen die '''in den QR-Code aufzunehmenden Felder''' aus:
Sie wählen die '''zu codierenden Felder''' durch Ankreuzen:


* Die linke Spalte enthält das Kontrollkästchen
* das Kontrollkästchen nimmt das Feld auf oder schließt es aus;
* Die mittlere Spalte zeigt die Feldbezeichnung und ihren aktuellen Wert (grau, wenn nicht angehakt)
* die mittlere Spalte zeigt die Bezeichnung und den aktuellen Wert des Feldes (ausgegraut, wenn nicht angekreuzt);
* Die rechte Spalte zeigt den '''erzeugten QR-Code''' (mit oder ohne Logo, je nach Auswahl)
* der erzeugte QR-Code erscheint neben der Tabelle, mit oder ohne Logo, zusammen mit der Schaltfläche '''ETIKETT DRUCKEN'''.


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


{| class="wikitable"
{| class="wikitable"
! Objekt !! Verfügbare Felder
! Objekt !! Verfügbare Felder
|-
|-
| Kunde/Lieferant || Firma, Adresse, Postleitzahl, Ort, Land, Telefon, E-Mail, URL + Zusatzfelder
| 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
|-
|-
| Produkt || Ref., Bezeichnung, Beschreibung, Preis netto, Preis brutto, Barcode, Gewicht, Volumen, URL + Zusatzfelder
| Angebot || Ref., Kundenref., Firma, E-Mail, Telefon, Datum, Gültig bis, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL
|-
|-
| Lager || Bezeichnung, Kurzname des Standorts, Beschreibung, Adresse, Postleitzahl, Ort, Land, URL + Zusatzfelder
| Kundenauftrag || Ref., Kundenref., Firma, E-Mail, Telefon, Datum, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL
|-
|-
| Benutzer || Login, Vorname, Nachname, Telefon, Mobiltelefon, E-Mail, Adresse, Postleitzahl, Ort, Land, URL + Zusatzfelder
| Lieferantenbestellung || Ref., Lieferantenref., Firma, E-Mail, Telefon, Datum, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL
|-
|-
| Kontakt || Anrede, Vorname, Nachname, Firma, Position, Telefon, Mobiltelefon, E-Mail, Adresse usw.
| Kundenrechnung || Ref., Kundenref., Firma, E-Mail, Telefon, Rechnungsdatum, Zahlungsfrist, Gesamt netto, Gesamt brutto, Öffentliche Notiz, URL
|-
|-
| Rechnung || 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
|-
|-
| (weitere) || Objektspezifische Felder
| 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:''' In Dolibarr definierte '''Zusatzfelder''' (ergänzende Attribute) werden automatisch zur Liste der verfügbaren Felder hinzugefügt.
: '''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.
 
Der angezeigte QR-Code ist '''anklickbar''': ein Klick öffnet das Fenster zum [[#Etikettendruck|Etikettendruck]].


=== Bereich 4 — QR-Code der Datensatz-URL ===
=== Bereich 4 — QR-Code der Datensatz-URL ===


[[File:Ultimateqrcode-thirdparty-qrcode-bottom-fr.png|center|900px|QR-Code-Registerkarte — unterer Bereich mit URL-QR und Schaltflächen Save/Cancel]]
Rechts (oder je nach Bildschirmbreite unter der Tabelle) zeigt der Reiter:
 
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 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'''.


[[File:Ultimateqrcode-v24-contact-vcard-fr.png|center|900px|vCard-QR-Code auf einem Kontaktdatensatz]]
=== Bereich 5 — vCard-QR-Code (Partner, Kontakt, Benutzer, Mitglied) ===


Die Datensätze '''Kontakt''', '''Benutzer''', '''Kunde/Lieferant''' (Firma) und '''Mitglied''' verfügen über einen zusätzlichen '''vCard-QR-Code''' am Ende der Seite.
[[File:Ultimateqrcode-v25-contact-vcard-de.png|center|900px|vCard-QR-Code auf einem Kontaktdatensatz]]


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.
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 ===
=== Live-Vorschau ===


'''[Neu in v24]''' Die QR-Codes werden '''in Echtzeit''' aktualisiert, wenn der Benutzer Folgendes ändert:
Die QR-Codes werden '''in Echtzeit''' aktualisiert, wenn Sie Folgendes ändern:
* die Größe des QR-Codes
* die Größe;
* die ECC-Qualitätsstufe
* die Qualität;
* das ausgewählte Logo
* das Logo;
* die angehakten Felder (Daten-QR)
* die angekreuzten Felder.


'''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.
'''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 Standardfeldauswahl ===
=== Automatische Vorauswahl der Felder ===


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.
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 ===
=== 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).
Felder an- oder abwählen, dann auf '''SPEICHERN''' klicken. Die Auswahl gilt für '''alle Objekte desselben Typs''' (eine Konfiguration pro Objekttyp).


----
----


= QR-Code-Registerkarte — Beispiele nach Objekt =
= Reiter QR-Code — Beispiele je Objekt =


== Kundenrechnung ==
== Kundenrechnung ==


'''[Neu in v24]'''
[[File:Ultimateqrcode-v25-invoice-qrcode-de.png|center|900px|Reiter QR-Code einer Rechnung mit eingebettetem Logo]]
 
[[File:Ultimateqrcode-v24-invoice-qr-complete-fr.png|center|900px|QR-Code-Registerkarte einer Rechnung mit eingebettetem Logo]]


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.
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 ==
== Produkt ==


[[File:Ultimateqrcode-product-qrcode-fr.png|center|900px|QR-Code-Registerkarte eines Produkts]]
[[File:Ultimateqrcode-v25-product-qrcode-de.png|center|900px|Reiter QR-Code eines Produkts]]


Beispielkonfiguration für ein Produkt: '''Ref.''' und '''Bezeichnung''' angehakt, zusammen mit den Zusatzfeldern '''Ecotax''' und '''ControlHistoryLink'''. Der QR-Code kodiert diese vier verketteten Werte.
Bei einem Produkt kann der QR-Code Referenz, Bezeichnung, Preise, Barcode, Gewicht und Volumen codieren: praktisch für die Regal- oder Lagerkennzeichnung.


== Lager ==
== Lager ==


[[File:Ultimateqrcode-stock-qrcode-fr.png|center|900px|QR-Code-Registerkarte eines Lagers]]
[[File:Ultimateqrcode-v25-stock-qrcode-de.png|center|900px|Reiter QR-Code eines Lagers]]


Nützlich für die physische Kennzeichnung von Lagerorten. Das Feld '''Kurzname des Standorts''' ermöglicht die Angabe des Lagerbereichs.
Nützlich, um Lagerorte physisch zu kennzeichnen. Das Feld '''Kurzname des Lagerorts''' gibt den Bereich an (Gang, Regal…).


== Benutzer ==
== Benutzer ==


[[File:Ultimateqrcode-user-qrcode-fr.png|center|900px|QR-Code-Registerkarte eines Benutzers]]
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.
 
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.
: '''Hinweis:''' der Reiter QR-Code eines Benutzers ist nur für den Benutzer selbst oder für Benutzer mit Leserecht auf Benutzerdatensätze sichtbar.


----
----


= Registerkarte QR-Url (nur Kunden/Lieferanten) =
= Wiederverwendbares QR-Code-Bild (QR mit Logo) =
 
[[File:Ultimateqrcode-thirdparty-qrurl-fr.png|center|900px|QR-Url-Registerkarte eines Kunden/Lieferanten mit Logo]]
 
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:
Um ein '''QR-Code-Bild mit Logo''' anderswo zu verwenden (Website, Broschüre, E-Mail-Signatur), nutzen Sie den Einrichtungsreiter '''QR mit Logo''':


{| class="wikitable"
# die URL des Datensatzes oder einen anderen Inhalt in das Eingabefeld eingeben;
! Element !! Funktion
# 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.
| '''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.
: '''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.


----
----
Line 316: Line 336:
= Etikettendruck =
= Etikettendruck =


[[File:Ultimateqrcode-label-print-fr.png|center|700px|Etikettendruckfenster 120×57mm]]
[[File:Ultimateqrcode-v25-label-print-de.png|center|466px|Etikett 120 × 57 mm]]
 
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.


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


Das Etikett enthält:
Die Generatoren der Reiter '''QR-Codes''' und '''QR mit Logo''' drucken den soeben erzeugten QR-Code auf die gleiche Weise.
* '''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.
Das Fenster öffnet automatisch den Druckdialog des Browsers.


: '''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.
: '''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.


----
----


= Rechte und Berechtigungen =
= Berechtigungen =


[[File:Ultimateqrcode-permissions-fr.png|center|700px|Berechtigungen des Moduls UltimateQRcode]]
[[File:Ultimateqrcode-v25-permissions-de.png|center|900px|Berechtigungen des Moduls UltimateQRcode]]


Das Modul definiert zwei Berechtigungsstufen, die pro Benutzergruppe unter '''Konfiguration → Benutzer & Gruppen''' zugewiesen werden:
Das Modul definiert zwei Berechtigungen, die pro Benutzer oder Gruppe unter '''Benutzer & Gruppen''' vergeben werden:


{| class="wikitable"
{| class="wikitable"
! Berechtigung !! Beschreibung !! Wirkung
! Berechtigung !! Wirkung
|-
|-
| '''Read qrcode outcomes''' || QR-Codes lesen || Ermöglicht das Anzeigen der QR-Code-Registerkarten und der erzeugten QR-Codes
| '''QR-Codes lesen''' || Zeigt die Reiter QR-Code und die erzeugten QR-Codes an
|-
|-
| '''Create/Modify qrcode outcomes''' || Erstellen / Ändern || Ermöglicht das An-/Abhaken der Felder und das Speichern der Konfiguration
| '''QR-Codes erstellen / ändern''' || Erlaubt das An- und Abwählen 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.
: '''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 mit v24 =
= Neuerungen und Kompatibilität v25 =
 
Version 25.0.0 passt UltimateQRcode an Dolibarr 25 an.
 
{| class="wikitable"
! Ä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 <code>php -l</code> unter PHP 8.4 und 8.5 geprüft
|}


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


== Neue Funktionen ==
=== Neue Funktionen in v24 ===


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


== Kompatibilität mit Dolibarr v24 ==
=== Kompatibilität mit Dolibarr v24 ===


{| class="wikitable"
{| class="wikitable"
! Korrektur !! Detail
! Korrektur !! Detail
|-
|-
| '''Modul-Symbol''' || Hinzufügen der Erweiterung <code>.png</code> in der Eigenschaft <code>$this->picto</code> des Moduldeskriptors, gemäß der Dolibarr v23+-Warnung.
| '''Modul-Picto''' || Endung <code>.png</code> in der Eigenschaft <code>$this->picto</code> des Deskriptors ergänzt
|-
|-
| '''Währung''' || Ersetzen von <code>$conf->currency</code> (veraltet) durch <code>getDolCurrency()</code>.
| '''Währung''' || <code>getDolCurrency()</code> statt <code>$conf->currency</code> (veraltet)
|-
|-
| '''Konstanten''' || Ersetzen der direkten Zuweisung <code>$conf->global->XXX = value</code> (veraltet) durch <code>dolibarr_set_const()</code>.
| '''Konstanten''' || <code>dolibarr_set_const()</code> statt direktem Schreiben in <code>$conf->global</code>
|}
|}


== Fehlerkorrekturen ==
=== Fehlerbehebungen in v24 ===


{| class="wikitable"
{| class="wikitable"
! Fehler !! Korrektur
! Fehler !! Korrektur
|-
|-
| Rechnungs-Registerkarte nicht gefunden || Korrektur der Groß-/Kleinschreibung des Registerkarten-Schlüssels im Moduldeskriptor.
| Rechnungsreiter nicht gefunden || Groß-/Kleinschreibung des Reiterschlüssels im Deskriptor korrigiert
|-
|-
| Veralteter Admin-Parameter || Entfernung des Parameters „Anzeigegröße der QR-Codes (in Pixel)", der durch die seitenweise Größeneinstellung überflüssig geworden ist.
| Veralteter Einrichtungsparameter || „Anzeigegröße der QR-Codes (in Pixel)“ entfernt, ersetzt durch die Größeneinstellung jedes Datensatzes
|-
|-
| 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.
| Logo zu groß || Automatischer Rückfall auf „ohne Logo“ statt eines Fehlers
|}
|}


== Übersetzungen ==
=== Übersetzungen in v24 ===


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.
Fehlende Übersetzungsschlüssel in den 5 Sprachen (FR, EN, DE, ES, IT) ergänzt: Qualität, Logo-Verwaltung und alle Objekttypen.


----
----
Line 401: Line 447:
= FAQ =
= FAQ =


; '''Der QR-Code ist leer oder zeigt „Keine Daten"'''
; '''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.
: 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'''
; '''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.
: 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.


; '''Zusatzfelder werden nicht angezeigt'''
; '''Die Zusatzfelder erscheinen nicht'''
: Die ergänzenden Attribute müssen unter '''Konfiguration → Ergänzende Attribute''' für das betreffende Objekt definiert sein.
: 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'''
; '''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.
: 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 wird ohne Logo angezeigt, obwohl ich eines ausgewählt habe'''
; '''Der QR-Code erscheint ohne Logo, obwohl ich eines gewä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.
: 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 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 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.


; '''Die QR-Code-Registerkarte erscheint bei manchen Datensätzen nicht'''
; '''Wo ist der Reiter QR-Url der Partner geblieben?'''
: Überprüfen, ob das Modul aktiviert ist und der Benutzer über die Berechtigung '''Read qrcode outcomes''' verfügt.
: 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.


----
----
Line 426: Line 475:
= Siehe auch =
= Siehe auch =


* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_EN|English]]
* [[Module_Ultimateqrcode_FR|Français]]
* [[Module_Ultimateqrcode_ES|Español]]
* [[Module_Ultimateqrcode_ES|Español]]
* [[Module_Ultimateqrcode_IT|Italiano]]
* [[Module_Ultimateqrcode_IT|Italiano]]
* [https://www.dolistore.com Dolistore]
* [https://www.dolistore.com/search.php?search_query=ultimateqrcode UltimateQRcode im DoliStore]
* [https://www.atoo-net.com Atoo-Net]
* [https://www.atoo-net.com Atoo-Net]

Latest revision as of 19:41, 29 September 2026

Retour index
Documentation développeur

File Doc dev.png

Retour index
Documentation Utilisateur
File Doc user.png

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

  1. Das Archiv module_ultimateqrcode-25.0.x.zip im DoliStore herunterladen
  2. In Dolibarr: Start → Einstellungen → Module/Anwendungen, Reiter Externes Modul bereitstellen/installieren, das Archiv hochladen. Andernfalls das Archiv in htdocs/custom/ entpacken: Sie müssen htdocs/custom/ultimateqrcode/ erhalten
  3. Das Modul UltimateQRcode in der Liste suchen und aktivieren
  4. Den Benutzern oder Gruppen die Berechtigungen zuweisen (siehe Berechtigungen)
Aktualisierung von einer älteren Version: den Ordner ultimateqrcode ersetzen, 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)

Freier QR-Code-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“

QR-Code-Generator 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“

Integriertes 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

Reiter QR-Code eines Partners: Felder, Daten-QR-Code, URL-QR-Code und vCard-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)

vCard-QR-Code auf einem Kontaktdatensatz

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

Reiter QR-Code einer Rechnung mit eingebettetem Logo

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

Reiter QR-Code eines Produkts

Bei einem Produkt kann der QR-Code Referenz, Bezeichnung, Preise, Barcode, Gewicht und Volumen codieren: praktisch für die Regal- oder Lagerkennzeichnung.

Lager

Reiter QR-Code eines Lagers

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:

  1. die URL des Datensatzes oder einen anderen Inhalt in das Eingabefeld eingeben;
  2. Größe und Logo wählen, dann auf ERZEUGEN klicken;
  3. 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

Etikett 120 × 57 mm

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

Berechtigungen des Moduls UltimateQRcode

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.

Siehe auch

Retrieved from "https://wiki.dolibarr.org/index.php?title=Module_Ultimateqrcode_DE&oldid=67546"