From 54cd5a004d57c902510769cc373fa9143991cef0 Mon Sep 17 00:00:00 2001 From: Bernd Bestel Date: Fri, 28 Feb 2025 16:14:26 +0100 Subject: [PATCH] Updated README / changelog --- README.md | 21 ++++++++++++++------- changelog/79_UNRELEASED_xx-xx-xxxx.md | 4 ++-- 2 files changed, 16 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index b24bb689..f17efe5a 100644 --- a/README.md +++ b/README.md @@ -100,6 +100,16 @@ Additionally it's also possible to use your device camera to scan a barcode by u _My personal recommendation: Use a USB barcode laser scanner. They are cheap and work 1000 % better, faster, under any lighting condition and from any angle._ +### Barcode lookup via external services + +Products can be directly added to the database via looking them up against external services by a barcode. + +This can be done in-place using the product picker workflow "External barcode lookup" (the workflow dialog is displayed when entering something unknown in any product input field) Quick video demo: + +A plugin for [Open Food Facts](https://world.openfoodfacts.org/) is included and used by default (see the `data/config.php` option `STOCK_BARCODE_LOOKUP_PLUGIN`). + +See that plugin or `plugins/DemoBarcodeLookupPlugin.php` for a commented example implementation if you want to build a plugin. + ### Input shorthands for date fields For (productivity) reasons all date (and time) input (and display) fields use the ISO-8601 format regardless of localization. @@ -123,15 +133,12 @@ The following shorthands are available: Wherever a button contains a bold highlighted letter, this is a shortcut key. Example: Button "**P** Add as new product" can be "pressed" by using the `P` key on your keyboard. -### Barcode lookup via external services +### Installable web app (PWA) -Products can be directly added to the database via looking them up against external services by a barcode. +Grocy's web frontend is responsive and an "installable web app" ([PWA](https://en.wikipedia.org/wiki/Progressive_web_app), without providing any offline usage capabilities), that provides a pretty native mobile app-like experience without the need for additional tools. -This can be done in-place using the product picker workflow "External barcode lookup" (the workflow dialog is displayed when entering something unknown in any product input field) Quick video demo: - -A plugin for [Open Food Facts](https://world.openfoodfacts.org/) is included and used by default (see the `data/config.php` option `STOCK_BARCODE_LOOKUP_PLUGIN`). - -See that plugin or `plugins/DemoBarcodeLookupPlugin.php` for a commented example implementation if you want to build a plugin. +- Quick video demo on Android/Firefox: +- Quick video demo on Android/Chrome: ### Database migrations diff --git a/changelog/79_UNRELEASED_xx-xx-xxxx.md b/changelog/79_UNRELEASED_xx-xx-xxxx.md index 3f07608d..fcb43284 100644 --- a/changelog/79_UNRELEASED_xx-xx-xxxx.md +++ b/changelog/79_UNRELEASED_xx-xx-xxxx.md @@ -60,7 +60,7 @@ ### Other - A quick reminder about official native Grocy app experiences: - - Grocy's web frontend is a responsive one and is even an "installable web app" ([PWA](https://en.wikipedia.org/wiki/Progressive_web_app), without providing offline features, [ref1](https://web.dev/articles/install-criteria), [ref2](https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Making_PWAs_installable)) which ends up in a pretty native mobile app-like experience + - Grocy's web frontend is responsive and an "installable web app" ([PWA](https://en.wikipedia.org/wiki/Progressive_web_app), without providing any offline usage capabilities), that provides a pretty native mobile app-like experience without the need for additional tools - => Quick video demo on Android/Firefox: https://www.youtube.com/watch?v=L38drVZfwHs - => Quick video demo on Android/Chrome: https://www.youtube.com/watch?v=rjLdXUFDNuk - - [Grocy Desktop](https://github.com/grocy/grocy-desktop) is a way to run Grocy without having to manage a webserver just like a normal (Windows) desktop application - available as a [classic `.msi` installation package](https://releases.grocy.info/latest-desktop) or as a [Microsoft Store App](https://apps.microsoft.com/detail/9NWB1TRNNKSF) + - [Grocy Desktop](https://github.com/grocy/grocy-desktop) is a way to run Grocy without having to manage a webserver, just like a normal (Windows) desktop application - available as a [classic `.msi` installation package](https://releases.grocy.info/latest-desktop) or as a [Microsoft Store App](https://apps.microsoft.com/detail/9NWB1TRNNKSF)