2471e78188
* Grocycode: Productpicker, StockService * Grocycode: Datamatrix generation * Grocycode: Display in UI, make Images downloadable * Grocycode: Do not show on product card * Grocycode: Stockentry Label view * Grocycode: Webhooks & Labelprinter Feature * Grocycode: Manual Label printing * Grocycode: Print Label from product form * Quagga2: use zxing for DataMatrix recognition * Grocycode: Default settings for label printing * Prepare merge of master * Grocycode: docs * Docs: label printing webhook * Review - "grocy" is currently written lower-case everywhere, so let's do this also for "grocycode" - Unified phrases / capitalization - Minor UI adjustments (mainly context menu item ordering / ordering/spacing on product edit page) - Documented API changes for Swagger UI (grocy.openapi.json) - Reverted German localizations (those are managed via Transifex; would cause conflicts when manually edited - will import them later there) - Reverted a somehow messed up localization string (productform/help text for `cumulate_min_stock_amount_of_sub_products`) - Suppress deprecation warnings when generating Datamatrix PNG (otherwise the PNG is invalid, https://github.com/jucksearm/php-barcode/issues/3) - Default `FEATURE_FLAG_LABELPRINTER` to disabled Co-authored-by: Bernd Bestel <bernd@berrnd.de>
2.2 KiB
grocycode
grocycode is, in essence, a simple way to reference to arbitrary grocy entities. Each grocycode includes a magic, an entitiy identifier, an id and an ordered set of extra data. It is supported to be entered anywhere grocy expects one to read a barcode, but can also reference grocy-internal properties like specific stock entries, or specific batteries.
Serialization
There are three mandatory parts in a grocycode:
- The magic
grcy - An entity identifer matching the regular expression
[a-z]+(that is, lowercase english alphabet without any fancy accents, minimum length 1 character). - An object identifer matching the regular expression
[0-9]+
Optionally, any number of further data without format restrictions besides not containing any double colons [0] may be appended.
These parts are then linearly appended, seperated by a double colon :.
Entity Identifers
Currently, there are three different entity types defined:
pfor Productsbfor Batteriescfor Chores
Example
In this example, we encode a Product with ID 13, which results in grcy:p:13 when serialized.
Product grocycodes
Product grocycodes extend the data format to include an optional stock id, thus may reference a specific stock entry directly.
Example: grcy:p:13:60bf8b5244b04
Battery grocycodes
Currently, Battery grocycodes do not define any extra fields.
Chore grocycodes
Currently, Chore grocycodes do not define any extra fields.
Visual Encoding
Grocy uses DataMatrix 2D Barcodes to encode grocycodes into a visual representation. In principle, there is no problem with using other encoding formats like QR codes; however DataMatrix uses less space for the same information and redundancy and is a bit easier read by 2D barcode scanners, especially on non-flat surfaces.
You can pick up cheap-ish used scanners from ebay (about 45€ in germany). Make sure to set them to the correct keyboard emulation, so that the double colons get entered correctly.
Notes
[0]: Obviously, it needs to be encoded into some usable visual representation and then read. So probably you only want to encode stuff that can be typed on a keyboard.