Skip to main content

bx:barcode

Mit dem Tag barcode können verschiedene 1D und 2D-Codes erzeugt werden (Beispiele siehe unten). Ein Check auf Fehler ist mit bx:if möglich. Die Größe ist frei wählbar. Das erzeugte Format ist PNG (ggf. mit Transparenz)

Allgemeine Syntax

<bx:barcode.qr width="250" height="250" [type="path"] [rotate="90"]> Inhalt </bx:barcode.qr>

Parameter für alle Typen
width und height geben die Größe des Barcodes anein weißer Rand ist teilweise automatisch enthalten und kann bei manchen Typen auch beeinflusst werden
type image: (Standard) es wird ein img-Tag erzeugt, Parameter wie style oder class im Barcode-Tag werden in das img-Tag übernommenpath: es wird nur der Pfad zum Bild ab "/" zurückgegeben (ohne Host, falls Haupthost-Haken im Projekt nicht gesetzt wurde)url: es wird eine komplette URL zum Bild zurückgegeben (aufgerufener Host oder Projekt-Haupthost)
rotate positive Werte drehen das erzeugte Bild im Uhrzeigersinn, negative Werte entgegen (in Grad, z.B. 90)die Größe des erzeugten Bildes wird neu berechnet, um den rotierten Barcode unterzubringen (Hintergrund ggf. transparent)

Es ist generell empfehlenswert einen minimalen Kontrast-Rand (z.B. in weiß) zu setzen, damit Barcodeleser den Code einfacher identifizieren können.

Es kann weitere Einschränkungen, je nach offizieller Spezifikation des jeweiligen Barcode-Types, geben, die hier nicht extra aufgeführt sind.Die Ausgabegröße des Barcode-Bilds musst nicht exakt der angegebenen `width` / `height` entsprechen (liegt aber zumindest nicht darüber). Falls eine pixelgenaue Ausgabe benötigt wird, sollte ein Container um das Bild gepackt werden.

Typ-spezifische Informationen

Die gezeigten Beispiele müssen nicht unbedingt den Anforderungen des jeweiligen Standards entsprechen! Es können also auch potentiell invalide Barcodes entstehen. Es ist die Spezifikation des jeweiligen Types zu Rate zu ziehen!

1-Dimensionale Codes

Bei allen 1-dimensionalen Codes kann der parameter margin verwendet werden. Dieser legt die Größe des Randes links und rechts fest (0 für keinen Rand, Standard ist 10).

Typ
 Ausgabe Einschränkungen
<bx:barcode.codabar> image2015-11-27 9:48:1.png"12345" beginnt und endet mit einem Guard-Zeichen aus: ABCDODER beginnt und endet mit einem Guard-Zeichen aus: TN*Efalls keine Guards gesetzt sind, wird automatisch A genommenenthält nur Zeichen aus: 0123456789-$:/.+
<bx:barcode.code_39> image2015-11-27 9:54:42.png"BATIX" maximal 80 Zeichen aus: 0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-. *$/+%
<bx:barcode.code_93> image2015-11-27 10:23:18.png"BATIX" maximal 80 Zeichen aus:0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ-. $/+%abcd*
<bx:barcode.code_128> image2015-11-27 10:26:21.png"BATIX" maximal 80 Zeichen
<bx:barcode.itf>
(Interleaved Two of Five)		 image2015-11-27 10:32:32.png"123456" weniger als 80 Ziffern, gerade Anzahlam besten 6, 10, 12, 14, 16, 24, oder 44 Ziffern
<bx:barcode.ean_8> image2015-11-27 10:34:44.png"12345678" genau 8 Ziffern
<bx:barcode.ean_13> image2015-11-27 10:36:37.png"1234567891118" genau 13 ZiffernPrüfziffer muss stimmen
<bx:barcode.upc_a> image2015-11-27 10:40:2.png"12345678910" genau 11 Ziffern (ohne Prüfziffer, wird automatisch berechnet)ODER genau 12 Ziffern (mit Prüfziffer)
<bx:barcode.upc_e> image2015-11-27 10:43:3.png"12345678" genau 8 Ziffern

2-Dimensionale Codes

<bx:barcode.qr>

Ausgabe

Ausgabe: image2015-11-27 9:45:35.png
"http://batix.de"

Parameter: ecl, margin, charset

Parameter

ecl
gibt das ErrorCorrectionLevel an:

  • L ~7% (Standard)
  • M ~15%
  • Q ~25%
  • H ~30%
Einschränkungen:nkungen

Die Länge des verschlüsselten Strings kann die Ausgabe beeinflussen.


<bx:barcode.datamatrix>

Ausgabe

Ausgabe: image2015-11-27 11:45:10.png image2015-11-27 11:50:45.png "http:/batix.de" (rechts mit shape=square)
image2015-11-27 11:47:0.png image2015-11-27 11:50:0.png "Lorem ipsum dolor sit amet" (rechts mit shape=rectangle)

Parameter

Parameter:shape

shape
    —
  • none (Standard, wird automatisch je nach Inhalt gewählt),
  • square (Quadrat erzwingen),
  • rectangle (Rechteck erzwingen)


<bx:barcode.aztec>

Ausgabe

Ausgabe: image2015-11-27 12:35:47.png
"http://batix.de"

Parameter

Parameter:ecl
eclgibt das ErrorCorrectionLevel an (in %, layers(0 - 100)), 25 sollte Minimum sein.

layers
gibt die Anzahl der Aztec-Layer an

  • 0 (Standard): Minimum benutzen
  • -1, -2, -3, -4: kompakter Modus
  • 1 - 32: selbst angeben (nicht-kompakter Modus)

charset
gibt den Zeichensatz an, der zur Codierung des Inhaltes verwendet werden soll.
Standard ist utf-8.


<bx:barcode.pdf_417>

Ausgabe

Ausgabe: image2015-11-27 12:50:36.png
"BATIX"

Parameter

Parameter:margin
margin,legt die Größe des Randes rundherum fest

ecl,
gibt das ErrorCorrectionLevel an.
0 - 8, Standard ist 2.

charset,
gibt den Zeichensatz an, der zur Codierung des Inhaltes verwendet werden soll.
Standard ist utf-8.

compact,
kompakten Modus benutzen? true oder false.
Standard ist false.

compaction,
welcher Verdichtungsmodus benutzt werden soll.

  • auto (Standard)
  • text
  • byte
  • numeric

dimensions

  • minimale und maximale Spalten- (Cols) und Zeilenanzahl (Rows)
  • kommagetrennte Zahlen
  • Reihenfolge: minCols,maxCols,minRows,maxRows
  • Standard: 2,30,2,30

Fehlerabfrage

<bx:if><bx:barcode.ean_8>1234</bx:barcode.ean_8><bx:if.else>Es konnte leider kein Barcode erzeugt werden!</bx:if.else></bx:if>

Da bx:barcode im Fehlerfall nichts ausgibt, kann ein alternativer Text mittels bx:if ausgegeben werden.

Beispiele

Beispiel Titel

<bx:barcode.qr>Hallo</bx:barcode.qr>
 
<bx:barcode.datamatrix shape="rectangle">Hallo</bx:barcode.datamatrix>
Back to top