OFF to Grocy

About

🚀 Funktionen
Produkt-Import: Übernimmt Produktname und Kalorien automatisch.
Bilder-Import: Lädt das Produktbild von OFF herunter und speichert es direkt in Grocy.
Barcode-Management:
Erstellt neue Produkte, wenn der Barcode unbekannt ist.
Verknüpft neue Barcodes mit existierenden Produkten, falls das Produkt bereits vorhanden ist.
Intelligentes Einheiten-Mapping: Unterscheidet automatisch zwischen Gewichts- (g, kg) und Volumeneinheiten (ml, l) und ordnet sie deinen Grocy-Einheiten zu.
Standort-Zuweisung: Legt neue Produkte automatisch in deinem gewünschten Standard-Lagerplatz ab.
Einkaufsliste: Optionales Feature, um importierte Produkte direkt auf die Einkaufsliste zu setzen.
Mehrsprachigkeit: Wähle deine bevorzugte Sprache (z.B. Deutsch), damit Produktnamen korrekt lokalisiert werden (z.B. "Nuss-Nougat-Creme" statt "Hazelnut Spread").
📦 Installation
Da diese Erweiterung (noch) nicht im Chrome Web Store verfügbar ist, muss sie als "entpackte Erweiterung" installiert werden.

- Lade dieses Repository herunter oder klone es.
- Öffne deinen Browser (Chrome, Edge, Brave, etc.).
- Gehe zu den Erweiterungen (chrome://extensions/).
- Aktiviere oben rechts den Entwicklermodus.
- Klicke auf "Entpackte Erweiterung laden".
- Wähle den Ordner grocy-off-widget aus.

⚙️ Konfiguration
Nach der Installation musst du das Plugin einmalig mit deinem Grocy verbinden:

Klicke auf das Erweiterungs-Icon und wähle "Einstellungen" (oder Rechtsklick auf das Icon -> Optionen).
Grocy URL: Die Adresse deiner Grocy-Instanz (z.B. https://grocy.meinserver.de).
API Key: Erstelle in Grocy unter "Manage API Keys" einen neuen Schlüssel und füge ihn hier ein.
Klicke auf 1. Verbindung testen & Daten laden.
Konfiguriere die Mappings:
Standard Lagerplatz: Wo sollen neue Produkte landen?
Einheiten: Wähle die passenden Grocy-Einheiten für Gewicht (z.B. "Gramm"), Volumen (z.B. "Milliliter") und Stück/Packung.
Sprache: Wähle die Sprache, in der Produktnamen importiert werden sollen.
Klicke auf 2. Einstellungen speichern.


📖 Bedienung
Navigiere auf Open Food Facts zu einem Produkt.
Klicke auf das Grocy-Icon in deiner Browser-Leiste.
Das Popup zeigt den erkannten Barcode an.
Wähle optional:
☑️ Bild importieren
☑️ Auf Einkaufsliste
Klicke auf Importieren.
Das Plugin prüft nun im Hintergrund, ob das Produkt existiert, legt es an oder aktualisiert es und gibt dir eine Erfolgsmeldung zurück.

🛠️ Fehlerbehebung
Import schlägt fehl? Prüfe in den Einstellungen das Logbuch (ganz unten). Dort stehen detaillierte Fehlermeldungen der Grocy API.
Bild fehlt? Manchmal blockiert Grocy den Upload, wenn Dateinamen Sonderzeichen enthalten. Das Plugin korrigiert dies automatisch, aber schau ins Log, falls es dennoch hakt.
Falsche Sprache? Stelle sicher, dass in den Einstellungen die korrekte "Bevorzugte Sprache" gewählt ist.




Haftungsausschluss (Disclaimer)

Die Nutzung dieser Browser-Erweiterung erfolgt auf eigene Gefahr.

Keine Gewährleistung: Diese Software wird "wie besehen" (as-is) zur Verfügung gestellt, ohne jegliche ausdrückliche oder stillschweigende Gewährleistung für die Funktion, Genauigkeit oder Zuverlässigkeit.

Haftungsbeschränkung: Der Entwickler übernimmt keine Haftung für Schäden, die durch die Nutzung oder Unmöglichkeit der Nutzung dieser Erweiterung entstehen. Dies schließt insbesondere, aber nicht ausschließlich, den Verlust von Daten, Browser-Abstürze oder Fehlfunktionen anderer Software ein.

Open Source & Beiträge: Dies ist ein Open-Source-Projekt. Verbesserungsvorschläge, Fehlerberichte oder Code-Änderungen sind ausdrücklich erwünscht. Bitte reichen Sie diese als Pull Request (PR) oder Issue auf GitHub ein. Durch das Einreichen eines Beitrags erklären Sie sich damit einverstanden, dass Ihr Code unter der gleichen Lizenz wie das Projekt veröffentlicht wird.