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 [2014-06-22 23:09] – Moved comment to discussion section 93.104.139.23plugin:barcode [2024-02-13 04:02] (current) – [Requests] 77.116.87.77
Line 1: Line 1:
-====== barcode (2D-Barcodes) ======+====== barcode (2D-Barcodes) Plugin ======
  
  
 ---- 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
 type       : syntax type       : syntax
-lastupdate : 2013-06-29 +lastupdate : 2019-02-24 
-compatible : Weatherwax, Adora Belle+compatible : Greebo
 depends    :  depends    : 
 conflicts  conflicts 
-similar    : QRCode +similar    : QRCode, QRCode2 
-tags       : media, images, barcode +tags       : media, images, barcode, qrcode 
-downloadurl: http://www.eiroca.net/apps/dokuwiki/barcode.zip +downloadurl: https://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-barcode.zip 
-bugtracker : http://sourceforge.net/projects/eirocasoftware/support +bugtracker : https://github.com/eiroca/dokuwiki-plugin-barcode/issues 
-sourcerepo : http://sourceforge.net/p/eirocasoftware/code+sourcerepo : https://github.com/eiroca/dokuwiki-plugin-barcode 
-donationurl: http://sourceforge.net/project/project_donations.php?group_id=253562+donationurl: https://www.eiroca.net/
 ---- ----
  
 ===== Download and Installation ===== ===== Download and Installation =====
-Download and install the plugin using the [[plugin:plugin|Plugin Manager]] using the following URL. Refer to [[:Plugins]] on how to install plugins manually.+Search and install the plugin using the [[plugin:extension|Extension Manager]] or manually with the download from the [[https://github.com/eiroca/dokuwiki-plugin-barcode/releases|GitHub Mirror]]. Refer to [[:Plugins]] on how to install plugins manually. 
  
-^  Download | [[http://www.eiroca.net/apps/dokuwiki/barcode.zip]] |+^  Download | [[https://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-barcode.zip]] |
  
-Last version can be found on [[http://sourceforge.net/projects/eirocasoftware/files/DokuWiki/plugin/|Source forge]], 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_bar|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 =====
 +=== version 19.02 ===
 +  * dokuwiki "Greebo" compatibility
 +  * PHP 7.x compatibility
 === 2013/06/29 === === 2013/06/29 ===
   * Added support fol translation plugin   * Added support fol translation plugin
Line 56: Line 113:
 Plugin is based upon [[plugin:qrcode|QRCode]] Plugin is based upon [[plugin:qrcode|QRCode]]
  
-Copyright © 2010-2011 eIrOcA (eNrIcO Croce & sImOnA Burzio)+Copyright © 2010-2019 eIrOcA (eNrIcO Croce & sImOnA Burzio)
  
 This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Line 65: Line 122:
  
 ===== Discussion ===== ===== Discussion =====
-==== Requests ==== +==== FAQ ==== 
-  :?: Is possible to draw a QR code of current page? //[[l.micco@tiscali.it|mluigi]] 2010/01/17 11:21// +**Is possible to draw a QR code of current page?**
-  :?: 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.+
  
 From version 2010/01/20 without specifying the payload, e.g.  From version 2010/01/20 without specifying the payload, e.g. 
   ~~BARCODE~~   ~~BARCODE~~
 +  
 +==== Requests ====
 +Please raise request [[https://github.com/eiroca/dokuwiki-plugin-barcode/issues|here]].
 +
 +  * :?: 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.1403471358.txt.gz · Last modified: 2014-06-22 23:09 by 93.104.139.23

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