DokuWiki

It's better when it's simple

User Tools

Site Tools


plugin:barcode

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
plugin:barcode [2019-02-24 15:05] eIrOcAplugin:barcode [2024-02-13 04:02] (current) – [Requests] 77.116.87.77
Line 3: Line 3:
  
 ---- plugin ---- ---- plugin ----
-description: Create 2D-Barcodes using different providers+description: Create 2D-Barcodes using different providers. See 'Fork' below for maintained version.
 author     : eIrOcA author     : eIrOcA
 email      : staff@eiroca.net email      : staff@eiroca.net
Line 16: Line 16:
 bugtracker : https://github.com/eiroca/dokuwiki-plugin-barcode/issues bugtracker : https://github.com/eiroca/dokuwiki-plugin-barcode/issues
 sourcerepo : https://github.com/eiroca/dokuwiki-plugin-barcode sourcerepo : https://github.com/eiroca/dokuwiki-plugin-barcode
-donationurl: https://www.paypal.com/donate/?token=5QGrMcI4S-JmQkAcAOsNWcLmMCKd8bjkJaUuhOH3si5gU8Aqlv58VGbKOn8pQg__5MAem0+donationurl: https://www.eiroca.net/
 ---- ----
  
Line 26: Line 26:
 Last version can be found on [[https://github.com/eiroca/dokuwiki-plugin-barcode/releases|GitHub]], including project tracking. Last version can be found on [[https://github.com/eiroca/dokuwiki-plugin-barcode/releases|GitHub]], including project tracking.
  
 +**Fork 2024-02-13** with ability to use **local qrencode or zint library** and compatibility for **PHP 8.2** and DokuWiki version **2024-06-04a "Kaos"** by Runout:
 +^  Repository |[[https://gitlab.com/dokuwiki-plugins/barcode]]|
 ===== Documentation =====  ===== Documentation ===== 
 +
 Barcode generates 2D barcodes using different providers, currently: Barcode generates 2D barcodes using different providers, currently:
 +
   * Google Charts   * Google Charts
   * I-nigma    * I-nigma 
   * Kaywa   * Kaywa
   * QRServer   * QRServer
 +  * qrencode (only available in Fork of Runout)
 +  * zint (only available in Fork of Runout)
 +
 +[[https://www.zint.org.uk/|Zint]] supports a lot of different [[https://www.zint.org.uk/manual/chapter/6/1|barcode types]]. Lookup the [[https://www.zint.org.uk/manual/chapter/4|manpage]]!
 +
 Layout of the barcode can be defined by CSS styles. Layout of the barcode can be defined by CSS styles.
  
 Full documentation and examples [[http://www.eiroca.net/doku_barcode|here]] (English & Italian). Full documentation and examples [[http://www.eiroca.net/doku_barcode|here]] (English & Italian).
 +
 +==== Usage ====
 +
 +<file>
 +~~BARCODE~attribute1=value1~attribute2=value2~~
 +</file>
 +
 +=== Attributes ===
 +
 +Only one attribute of type payload can be specified. \\ If no payload attribute is given a barcode pointing to the containing page is generated. 
 +
 +^Attribute^Description^Type^
 +|id|Id to assign to the barcode img tag. \\ Control for rendering via CSS.|optional|
 +|class|Class to assign to the barcode img tag. \\ Control for rendering via CSS. \\ Possible values: \\ barcode_left -> barcode is left aligned \\ barcode_right -> barcode is right aligned \\ barcode_center -> barcode is centered|optional|
 +|mode|Only for I-nigma provider. 0 is QR-Code, 1 is DataMatrix |optional|
 +|size|Size of the barcode. Allowed values: S, M, L, XL|optional|
 +|url|payload is an URL, e.g. //url=[[https://example.org]]//|payload|
 +|sms|payload is a SMS, e.g. //sms=+391234567890=A Message//|payload|
 +|tel|payload is a telephone number, e.g. //tel=+391234567890//|payload|
 +|contact|payload is a contact, e.g. //contact=Name=+123432324=my@example.org//|payload|
 +|text|payload is a text, e.g. //text=MAILTO:my@example.org//|payload|
 +|caption|caption to be used on the bottom of the barcode. \\ Only for 'I-nigma'|optional|
 +|bgcolor|Background color of the barcode. \\ Only for ''qrencode'' and ''QRServer''. \\ For usage with ''qrencode'' see attribute ''background''|optional|
 +|foreground|color  in  hexadecimal  notation: //RRGGBB[AA]// \\ 6-digit  (RGB) or 8-digit (RGBA). \\ Color output support available only in PNG, EPS and SVG.|optional \\ Runout fork only|
 +|background|color  in  hexadecimal  notation: //RRGGBB[AA]// \\ 6-digit  (RGB) or 8-digit (RGBA). \\ Color output support available only in PNG, EPS and SVG.|optional \\ Runout fork only|
 +|level|Error  correction level. Allowed values: L, M, Q, H|optional \\ Runout fork only|
 +|margin|Width of margin. (default=4)|optional \\ Runout fork only|
 +|dpi|DPI of the generated PNG. (default=72)|optional \\ Runout fork only|
 +
 +=== Examples ===
 +
 +<file>
 +~~BARCODE~class=barcode_left~url=http://www.eiroca.net/dokuwiki~size=S~~
 +~~BARCODE~class=barcode_right~url=http://www.eiroca.net/dokuwiki~size=S~~
 +~~BARCODE~class=barcode_center~size=M~~
 +</file>
 +
 +For Zint (Runout fork only) use the long form parameters of the cli.
 +
 +//size// is a synonym for //scale//.
 +
 +<file>
 +~~BARCODE~class=barcode_left~url=https://www.example.org~fg=AA0000~size=S~~
 +~~BARCODE~barcode=aztec~scale=L~~
 +</file>
  
 ===== History ===== ===== History =====
Line 78: Line 132:
  
   * :?: Would it be possible to create barcodes without any external provider and dependency? This would be helpful for intranets without internet access. Perhaps a library like [[http://www.phpqrcode.sourceforge.net|phpbarcode]] could be used.   * :?: Would it be possible to create barcodes without any external provider and dependency? This would be helpful for intranets without internet access. Perhaps a library like [[http://www.phpqrcode.sourceforge.net|phpbarcode]] could be used.
 +    * You can try runout's fork (updated for PHP 8.2) which uses the //qrencode// or //zint// library: https://gitlab.com/dokuwiki-plugins/barcode
  
plugin/barcode.1551017142.txt.gz · Last modified: 2019-02-24 15:05 by eIrOcA

Except where otherwise noted, content on this wiki is licensed under the following license: CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki