Barcodes

Über

Das Plugin fügt Produktdokumenten Barcodes und QR-Codes hinzu, deren Wert aus einem konfigurierbaren Feld stammt. Die Encoder für Code 128, EAN-13 und QR sind innerhalb des Pakets nach Spezifikation implementiert, ohne Laufzeitabhängigkeiten, ohne Bildservice und ohne externe Aufrufe. Es baut auf `@payloadcms/plugin-ecommerce` auf und fügt die Codes den angegebenen Kollektionen hinzu. Auf jeder benannten Kollektion registriert das Plugin einen `afterChange`-Hook. Der Hook läuft nach dem Schreiben des Dokuments, sodass ein transformierender Field-Hook (wie bei Slugs üblich) bereits fertig ist. Er erfasst den Wert, das Format und eine Fehlermeldung, falls der Wert nicht dargestellt werden kann. Er schreibt nur bei Änderungen und markiert die Anfrage, um eine Rekursion zu verhindern. Ein Settings-Global (Slug `barcodes`) steuert das Quellfeld, das Format (`code128` oder `ean13`), ob der QR-Code den Wert oder eine daraus generierte URL enthält, die URL-Vorlage und die Anzeige einer Beschriftung. Der Endpunkt `/api/barcodes/print` liefert eine einzelne HTML-Seite mit allen Labels in Schwarz auf Weiß. Die Seite öffnet beim Laden den Druckdialog und hält jedes Label auf einer Seite. Bilder werden nicht gespeichert. Beide Codes werden bei der Seitenanfrage gezeichnet, sodass Änderungen an den Einstellungen sofort auf allen Labels sichtbar sind und die Datenbank nicht veralten. QR ist auf Version 10 begrenzt (271 Bytes bei Level L, 213 bei M), was für Artikelnummern, SKUs oder Produkt-URLs reicht. Code 128 nutzt Set B (druckbares ASCII von Leerzeichen bis Tilde), EAN-13 wird validiert, nicht korrigiert. Mit `completeEan13` lässt sich die Prüfziffer selbst berechnen. Beim ersten Speichern eines neuen Dokuments kostet die Erfassung einen zweiten Schreibvorgang, da der Hook nach dem Schreiben läuft. Der Haupteintrag importiert kein React, was das Paket auf dem Teil der Payload-Oberfläche hält, der minor Releases übersteht. `PrintButtons` ist optional über den Eintrag `payload-barcodes/client` verfügbar und rendert nur `Print Barcode` und `Print QR Code` ohne eigenes Styling abgesehen von Abständen, erbt also das Admin-Theme. Sollten die Buttons einmal kaputtgehen, bleibt der Druck selbst davon unberührt.

Paketinformationen

Paketname

payload-barcodes

Neueste Version

1.0.0

Entpackte Größe

50 kB

Lizenz

MIT

Wöchentliche Downloads

2

Zuletzt veröffentlicht

21. Aug. 2026