DataFirefly Allergens & Ingredients — Vollständige Anleitung

Überblick

DataFirefly Allergens & Ingredients bringt Ihren PrestaShop 8 oder 9 Shop in Konformität mit der EU-Verordnung 1169/2011 (LMIV): Anzeige der 14 Allergene aus Anhang II, strukturierte Zutatenliste mit automatischer Allergen-Hervorhebung (Artikel 21) und Informationen, die vor dem Kauf verfügbar sind, wie es Artikel 14 für den Fernabsatz verlangt.

Das Modul fügt zudem zwei Unterscheidungsmerkmale hinzu: ein persönliches Allergenprofil für jeden Kunden mit Echtzeit-Warnungen auf den Produktseiten und eine automatische Schema.org JSON-LD-Anreicherung für SEO.

Voraussetzungen und Kompatibilität

• PrestaShop 8.0.0 bis 9.99.99
• PHP 8.0 minimum
• MySQL 5.7+ oder MariaDB 10.3+
• Multi-Shop- und mehrsprachig kompatibel
• Enthaltene Sprachen: Französisch, Englisch, Spanisch, Deutsch

Installation

1. Öffnen Sie im Back Office Module → Modul-Manager.
2. Klicken Sie auf Modul hochladen und wählen Sie die Datei dfallergens-1.0.0.zip.
3. Klicken Sie auf Installieren. Das Modul erstellt 5 Tabellen mit dem Präfix df_ und lädt die 14 Allergene aus Anhang II in den 4 Sprachen vor.
4. Ein neuer Tab DataFirefly Allergens erscheint im Modulmenü zur Verwaltung der Allergen-Taxonomie.

Konfiguration

Öffnen Sie Module → Modul-Manager → DataFirefly Allergens & Ingredients → Konfigurieren. Sechs Einstellungen sind verfügbar:

• Hervorhebungsstil — wie Allergene in der Zutatenliste markiert werden: fett (empfohlen), Großbuchstaben, unterstrichen oder farbig. Fettdruck ist der gängigste Stil auf physischen Etiketten.
• Symbole anzeigen — aktiviert oder deaktiviert die SVG-Piktogramme neben jedem Allergennamen.
• Spuren anzeigen — zeigt oder verbirgt den Abschnitt „Kann Spuren enthalten“ (Artikel 36 Absatz 3).
• JSON-LD-Auszeichnung — fügt die Schema.org-Auszeichnung in das head-Tag der betreffenden Produktseiten ein.
• Kundenprofil — aktiviert die Allergenprofil-Funktion im Kundenkonto und die Warnungen auf den Produktseiten.
• Anzeigeposition — dedizierter Tab auf der Produktseite, nach der Beschreibung oder nach dem Preis.

Allergene eines Produkts deklarieren

1. Öffnen Sie die Produktseite im Back Office und gehen Sie zum Tab Module (PrestaShop 8) oder zum Modulbereich (PrestaShop 9).
2. Im Panel DataFirefly Allergens bietet jedes Allergen drei Zustände: nicht zutreffend (Standard), Enthält oder Spuren.
3. Wählen Sie Enthält für Allergene, die im Rezept vorhanden sind, Spuren für mögliche Kreuzkontaminationen.
4. Geben Sie die Zutatenliste in natürlicher Sprache ein, in absteigender Reihenfolge der Menge, wie es die Verordnung verlangt. Das Modul erkennt und hebt Allergene und ihre Synonyme automatisch hervor.
5. Optional können Sie die Herkunft und die Lagerhinweise ausfüllen.
6. Speichern Sie das Produkt.

Automatische Synonymerkennung

Die Hervorhebung beschränkt sich nicht auf den offiziellen Allergennamen. Das interne Wörterbuch erkennt gängige Varianten in allen vier Sprachen:

• Milch → Milch, Butter, Sahne, Kasein, Molke, Laktose
• Gluten → Weizen, Dinkel, Gerste, Roggen, Hafer, Kamut, Malz
• Sulfite → SO2, Schwefeldioxid, E220 bis E228
• Schalenfrüchte → Mandel, Haselnuss, Walnuss, Cashew, Pekannuss, Pistazie, Macadamia

Die Erkennung verwendet Unicode-fähige Wortgrenzen: „Weizen“ wird in „Weizenmehl“ erkannt, aber nicht innerhalb längerer, nicht verwandter Wörter.

Kunden-Allergenprofil

Wenn die Option aktiviert ist, verfügt jeder angemeldete Kunde über einen Bereich Meine Allergene in seinem Kundenkonto. Dort wählt er seine Allergene und einen Schweregrad aus: vermeiden, Unverträglichkeit, schwer oder anaphylaktisch.

Auf jeder Produktseite vergleicht das Modul die deklarierten Allergene des Produkts mit dem Profil des Kunden. Im Konfliktfall erscheint ein rotes Warnbanner über dem Preis, das das betreffende Allergen und den registrierten Schweregrad angibt.

Schema.org JSON-LD-Auszeichnung

Wenn ein Produkt mindestens ein deklariertes Allergen oder eine Zutatenliste hat, fügt das Modul automatisch ein JSON-LD-Script in das head-Tag ein, das Folgendes enthält:

• ingredients — die Zutatenliste als reiner Text
• suitableForDiet — die abgeleiteten kompatiblen Diäten (z.B. GlutenFreeDiet, wenn kein Gluten-Allergen deklariert ist)
• additionalProperty — jedes Allergen mit der propertyID INCO-1169-2011 und seinem Niveau (enthält oder Spuren)

Die Auszeichnung wird serverseitig in PHP generiert, ohne Template, mit Injektionsschutz.

Verwaltung der Allergen-Taxonomie

Das Back-Office-Menü DataFirefly Allergens ermöglicht es, die Namen und Beschreibungen der 14 Allergene in jeder Sprache zu bearbeiten, sie einzeln zu aktivieren oder zu deaktivieren und ihre Anzeigereihenfolge anzupassen. Die Standardreihenfolge folgt der Nummerierung von Anhang II.

Fehlerbehebung

• Der Allergenblock wird nicht angezeigt — prüfen Sie, ob das Produkt mindestens ein deklariertes Allergen oder eine Zutatenliste hat und ob die konfigurierte Anzeigeposition einem von Ihrem Theme unterstützten Hook entspricht.
• Alle Allergene erscheinen als „Enthält“ — stellen Sie sicher, dass Sie die finale Version 1.0.0 des Moduls verwenden; bereinigen Sie die Testproduktdaten, indem Sie alle Auswahlfelder auf „nicht zutreffend“ zurücksetzen und speichern.
• Die Hervorhebung funktioniert bei einem Begriff nicht — der Begriff fehlt möglicherweise im Synonymwörterbuch; verwenden Sie den offiziellen Allergennamen in der Zutatenliste.
• JSON-LD erscheint nicht — prüfen Sie, ob die Option in der Konfiguration aktiviert ist, und untersuchen Sie den Quellcode der Produktseite (suchen Sie nach INCO-1169-2011).

Deinstallation

Die Deinstallation entfernt die 5 Tabellen des Moduls und alle zugehörigen Allergen-, Zutaten- und Kundenprofildaten. Exportieren Sie Ihre Daten vorher bei Bedarf.

Rechtliche Verantwortung

Das Modul stellt die technischen Anzeigewerkzeuge bereit. Gemäß Artikel 8 der LMIV-Verordnung liegt die Verantwortung für die Richtigkeit der Lebensmittelinformationen beim Lebensmittelunternehmer, d.h. beim Händler.