README.md
1[![Latest Release](https://gitlab.com/MatthiasLohr/dokuwiki-barcodes/-/badges/release.svg)](https://gitlab.com/MatthiasLohr/dokuwiki-barcodes/-/releases/permalink/latest/downloads/dokuwiki-barcodes.zip)
2
3# Barcodes for DokuWiki
4
5*Barcodes (1D & 2D) for DokuWiki*
6
7## Installation
8
9The recommended way to install this plugin is to use the [DokuWiki Extension Manager](https://www.dokuwiki.org/plugin:extension).
10Search for `barcodes` and lick on *Install*.
11
12Alternatively, you can [download the latest version here](https://gitlab.com/MatthiasLohr/dokuwiki-barcodes/-/releases/permalink/latest/downloads/dokuwiki-barcodes.zip) and manually upload and install it to your DokuWiki.
13Please take a look [here](https://www.dokuwiki.org/plugins) to learn how to install plugins manually.
14
15
16## Usage
17
18Create a [QR code](https://en.wikipedia.org/wiki/QR_code), pointing to https://dokuwiki.org:
19```xml
20<barcode type="QRCODE" value="https://dokuwiki.org" />
21```
22
23Alternatively, put the same URL in [Data Matrix](https://en.wikipedia.org/wiki/Data_Matrix):
24```xml
25<barcode type="DATAMATRIX" value="https://dokuwiki.org" />
26```
27
28### Options
29
30The following tables contains a list of attributes, which can be used to modify the different types of supported barcodes.
31
32| Option | QR Code | Data Matrix | Other Barcodes | Description | Example |
33|--------------------|-----------------|--------------------|----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------------------------------------------------|
34| `type` | `type="QRCODE"` | `type="DATAMATRIX` | `type=...` | One of: `C39`, `C39+`, `C39E`, `C39E+`, `C93`, `S25`, `S25+`, `I25`, `I25+`, `C128`, `C128A`, `C128B`, `C128C`, `EAN2`, `EAN5`, `EAN8`, `EAN13`, `UPCA`, `UPCE`, `MSI`, `MSI+`, `POSTNET`, `PLANET`, `RMS4CC`, `KIX`, `IMB`, `CODABAR`, `CODE11`, `PHARMA`, `PHARMA2T`. | `type="QRCODE"` `type="DATAMATRIX"` `type="EAN13"` |
35| `value` | required | required | required | Value to be represented by the Barcode. | `value="https://dokuwiki.org"` `value="42"` |
36| `img-type` | optional | optional | optional | Type of the image to be created. Must be one of `svg` (default) or `png` | `img-type="png"` |
37| `color` | optional | optional | optional | Base color of the barcode. | `color="#FF0000"` |
38| `background-color` | optional | optional | optional | Background color of the barcode. Leave empty for transparent. | `background-color="#FFFFFF"` |
39| `size` | optional | optional | optional | Set the size in px (width and height for QR code and Data Matrix, height for other barcodes). | `size="64px"` |
40| `scale ` | *N.A.* | *N.A.* | optional | Scale the width of the barcode. | `scale="1.5"` |
41| `padding` | optional | optional | optional | Padding of the barcode in px. | `padding="10px"` |
42
43## Development
44
45This plugin is fairly new and therefore does not yet have all the features you might want.
46If you are missing a feature, feel invited to submit a [feature request](https://gitlab.com/MatthiasLohr/dokuwiki-barcodes/-/issues/new).
47
48
49## Change Log
50
51The Changelog is available here: https://gitlab.com/MatthiasLohr/dokuwiki-barcodes/-/blob/main/CHANGELOG.md.
52
53
54## License
55
56This DokuWiki plugin is published under the [GNU General Public License v3.0](LICENSE.md).
57
58DokuWiki barcodes Plugin
59Copyright (C) 2023 by [Matthias Lohr](https://mlohr.com/) <[mail@mlohr.com](mailto:mail@mlohr.com)>
60
61This program is free software: you can redistribute it and/or modify
62it under the terms of the GNU General Public License as published by
63the Free Software Foundation, either version 3 of the License, or
64(at your option) any later version.
65
66This program is distributed in the hope that it will be useful,
67but WITHOUT ANY WARRANTY; without even the implied warranty of
68MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
69GNU General Public License for more details.
70
71You should have received a copy of the GNU General Public License
72along with this program. If not, see <http://www.gnu.org/licenses/>.
73
74
75## Attributions
76
77This DokuWiki plugin makes use of the [php-barcode](https://github.com/jucksearm/php-barcode) library from [Jucksearm](https://github.com/jucksearm).
78