1,953
edits
(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]] | ||
[[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= | |minversion=25.0.0 | ||
|note=Kompatibel mit Dolibarr | |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 = | ||
# | # Das Archiv <code>module_ultimateqrcode-25.0.x.zip</code> im [https://www.dolistore.com DoliStore] herunterladen | ||
# In Dolibarr: ''' | # 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 | ||
# | # Das Modul '''UltimateQRcode''' in der Liste suchen und aktivieren | ||
# | # 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. | |||
---- | ---- | ||
= | = Einrichtung des Moduls = | ||
Die | Die Einrichtungsseite öffnen Sie über '''Start → Einstellungen → Module/Anwendungen → UltimateQRcode''' (Zahnrad-Symbol). | ||
Die | Die Einrichtungsseite hat vier Reiter: '''QR-Codes''', '''QR mit Logo''', '''Benutzerhandbuch''' und '''Über'''. | ||
== | == Reiter „QR-Codes“ (freier Generator) == | ||
[[File:Ultimateqrcode-admin-qrcodes- | [[File:Ultimateqrcode-v25-admin-qrcodes-de.png|center|900px|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. | |||
{| class="wikitable" | {| class="wikitable" | ||
! Feld !! Beschreibung | ! 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:<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 | ||
|- | |- | ||
| ''' | | '''Größe''' || 1 bis 10 Pixel pro QR-Code-Modul | ||
|- | |- | ||
| Schaltfläche ''' | | 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]]) | |||
|} | |} | ||
== Reiter „QR mit Logo“ == | |||
== | |||
[[File:Ultimateqrcode-admin-qrwithlogo- | [[File:Ultimateqrcode-v25-admin-qrwithlogo-de.png|center|900px|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. | |||
{| class="wikitable" | {| class="wikitable" | ||
! | ! 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 <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 | ||
|- | |- | ||
| ''' | | 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''' || | | '''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“ == | |||
[[File:Ultimateqrcode-v25-admin-guide-de.png|center|900px|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 | 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 | Das Modul fügt den Datensätzen der folgenden 16 Objekte einen Reiter '''QR-Code''' hinzu: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Objekt !! | ! 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 === | === Bereich 1 — Einstellungsleiste === | ||
Oben im Reiter lässt sich in einer Einstellungsleiste wählen: | |||
Oben | |||
{| class="wikitable" | {| class="wikitable" | ||
! Einstellung !! Beschreibung | ! Einstellung !! Beschreibung | ||
|- | |- | ||
| '''Größe''' || Auflösung des QR-Codes | | '''Größe''' || Auflösung des QR-Codes, 2 bis 10 Pixel pro Modul | ||
|- | |- | ||
| '''Qualität | | '''Qualität''' || Fehlerkorrektur: Niedrig (L), Mittel (M), Mittel-Hoch (Q) oder Hoch (H) | ||
|- | |- | ||
| '''Logo''' || | | '''Logo''' || In der Mitte des QR-Codes eingebettetes Logo, gewählt in der Tabelle von Bereich 2 | ||
|} | |} | ||
: '''Hinweis:''' | : '''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 ''' | 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 | Die Tabelle listet die Logos des Ordners <code>documents/mycompany/logos/</code> auf: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Spalte !! Beschreibung | ! Spalte !! Beschreibung | ||
|- | |- | ||
| ''' | | '''Optionsfeld''' || Wählt das Logo oder „''Kein Logo''“ | ||
|- | |- | ||
| '''Logo''' || | | '''Logo''' || Dateiname | ||
|- | |- | ||
| '''Größe''' || Dateigröße in Byte | | '''Größe''' || Dateigröße in Byte | ||
|- | |- | ||
| '''Datum''' || Datum des | | '''Datum''' || Datum des Uploads | ||
|- | |- | ||
| '''Vorschau''' || | | '''Vorschau''' || Lupe zum Anzeigen des Logos | ||
|- | |- | ||
| '''Aktionen''' || | | '''Aktionen''' || Umbenennen und Löschen | ||
|} | |} | ||
Ein | Ein Formular unten auf der Seite lädt neue Logos hoch. | ||
: '''Sicherheit:''' | : '''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 | === Bereich 3 — Daten-QR-Code === | ||
[[File:Ultimateqrcode-thirdparty-qrcode- | [[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]] | ||
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: | |||
{| class="wikitable" | {| class="wikitable" | ||
! Objekt !! Verfügbare Felder | ! 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:''' | : '''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 === | === 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) === | |||
[[File:Ultimateqrcode-v25-contact-vcard-de.png|center|900px|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 === | === Live-Vorschau === | ||
Die QR-Codes werden '''in Echtzeit''' aktualisiert, wenn Sie Folgendes ändern: | |||
* die Größe | * die Größe; | ||
* die | * die Qualität; | ||
* das | * das Logo; | ||
* die | * die angekreuzten Felder. | ||
'''Kein Neuladen der Seite | '''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 | === Automatische Vorauswahl der Felder === | ||
Bei der ersten Anzeige | 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 === | ||
Felder an- oder abwählen, dann auf '''SPEICHERN''' klicken. Die Auswahl gilt für '''alle Objekte desselben Typs''' (eine Konfiguration pro Objekttyp). | |||
---- | ---- | ||
= QR-Code | = Reiter QR-Code — Beispiele je Objekt = | ||
== Kundenrechnung == | == Kundenrechnung == | ||
[[File:Ultimateqrcode-v25-invoice-qrcode-de.png|center|900px|Reiter QR-Code einer Rechnung mit eingebettetem Logo]] | |||
[[File:Ultimateqrcode- | |||
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- | [[File:Ultimateqrcode-v25-product-qrcode-de.png|center|900px|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 == | == Lager == | ||
[[File:Ultimateqrcode-stock-qrcode- | [[File:Ultimateqrcode-v25-stock-qrcode-de.png|center|900px|Reiter QR-Code eines Lagers]] | ||
Nützlich | Nützlich, um Lagerorte physisch zu kennzeichnen. Das Feld '''Kurzname des Lagerorts''' gibt den Bereich an (Gang, Regal…). | ||
== Benutzer == | == 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. | |||
Der Benutzer-QR-Code | |||
: '''Hinweis:''' | : '''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. | |||
Der | : '''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- | [[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. | |||
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 | Das Fenster öffnet automatisch den Druckdialog des Browsers. | ||
: '''Hinweis:''' | : '''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 = | ||
[[File:Ultimateqrcode-permissions- | [[File:Ultimateqrcode-v25-permissions-de.png|center|900px|Berechtigungen des Moduls UltimateQRcode]] | ||
Das Modul definiert zwei | Das Modul definiert zwei Berechtigungen, die pro Benutzer oder Gruppe unter '''Benutzer & Gruppen''' vergeben werden: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Berechtigung | ! 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:''' | : '''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 | = 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 | |||
|} | |||
== Historie v24 == | |||
== Neue Funktionen == | === Neue Funktionen in v24 === | ||
{| class="wikitable" | {| class="wikitable" | ||
! Funktion !! Beschreibung | ! Funktion !! Beschreibung | ||
|- | |- | ||
| ''' | | '''Einstellungen pro Datensatz''' || Größe, Qualität und Logo direkt in jedem Reiter QR-Code einstellbar | ||
|- | |- | ||
| '''Eingebettetes Logo''' || | | '''Eingebettetes Logo''' || PNG-Logo in der Mitte jedes QR-Codes, auf allen Seiten | ||
|- | |- | ||
| '''Live-Vorschau''' || | | '''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 Partner, Kontakte, Benutzer und Mitglieder | ||
|- | |- | ||
| ''' | | '''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- | | '''Modul-Picto''' || Endung <code>.png</code> in der Eigenschaft <code>$this->picto</code> des Deskriptors ergänzt | ||
|- | |- | ||
| '''Währung''' || | | '''Währung''' || <code>getDolCurrency()</code> statt <code>$conf->currency</code> (veraltet) | ||
|- | |- | ||
| '''Konstanten''' || | | '''Konstanten''' || <code>dolibarr_set_const()</code> statt direktem Schreiben in <code>$conf->global</code> | ||
|} | |} | ||
== | === Fehlerbehebungen in v24 === | ||
{| class="wikitable" | {| class="wikitable" | ||
! Fehler !! Korrektur | ! Fehler !! Korrektur | ||
|- | |- | ||
| | | Rechnungsreiter nicht gefunden || Groß-/Kleinschreibung des Reiterschlüssels im Deskriptor korrigiert | ||
|- | |- | ||
| Veralteter | | Veralteter Einrichtungsparameter || „Anzeigegröße der QR-Codes (in Pixel)“ entfernt, ersetzt durch die Größeneinstellung jedes Datensatzes | ||
|- | |- | ||
| Logo | | Logo zu groß || Automatischer Rückfall auf „ohne Logo“ statt eines Fehlers | ||
|} | |} | ||
== Übersetzungen == | === Übersetzungen in v24 === | ||
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 | ; '''Der QR-Code ist leer oder zeigt „Keine Daten“''' | ||
: Kein Feld ist | : 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''' | ||
: | : 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 | ; '''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''' | ; '''Der QR-Code mit Logo ist nicht lesbar''' | ||
: Das Logo | : 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 | ; '''Der QR-Code erscheint ohne Logo, obwohl ich eines gewählt habe''' | ||
: Das Logo ist | : 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 | : 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. | ||
---- | ---- | ||
| Line 426: | Line 475: | ||
= Siehe auch = | = Siehe auch = | ||
* [[Module_Ultimateqrcode_FR|Français]] | |||
* [[Module_Ultimateqrcode_EN|English]] | * [[Module_Ultimateqrcode_EN|English]] | ||
* [[Module_Ultimateqrcode_ES|Español]] | * [[Module_Ultimateqrcode_ES|Español]] | ||
* [[Module_Ultimateqrcode_IT|Italiano]] | * [[Module_Ultimateqrcode_IT|Italiano]] | ||
* [https://www.dolistore.com | * [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] | ||