Wein und Spirituosen mit PrestaShop: Dokumentation DataFirefly Wine & Spirits

Installation

Installieren Sie das Modul über Module > Modulverwaltung > Modul hochladen mit der ZIP-Datei. Das Modul legt seine Tabellen an, registriert seine Hooks und fügt das Menü Katalog > Weine & Spirituosen hinzu.

Bei der Installation legt es außerdem acht native Merkmale an: Jahrgang, Rebsorte, Herkunftsbezeichnung, Alkoholgehalt, Farbe, Region, Herkunftsland und Zertifizierung. Frankreich wird vorkonfiguriert (Mindestalter 18, Alters-Checkbox im Checkout, französischer Pflicht-Gesundheitshinweis), ebenso die französischen Verbrauchsteuersätze 2026.

Für ein Update von einer früheren Version installieren Sie einfach die neue ZIP-Datei: Die Update-Skripte ergänzen fehlende Spalten, Tabellen und Merkmale, ohne Ihre Daten anzutasten.

Dashboard

Erster Tab des Menüs. Er zeigt die Zahl der verwalteten Produkte, die verkauften Stück, den reinen Alkohol und die Verbrauchsteuern des laufenden Monats, eine Konfigurations-Checkliste, die Vollständigkeit der Daten (Alkoholgehalt, Farbe, Jahrgang, Rebsorten, Herkunftsbezeichnung) und die letzten 30 zu ergänzenden Produkte mit Link zur Produktseite. Farbe, Jahrgang und Rebsorten werden nur bei Weinen geprüft.

Einstellungen

Berechnungsmodus der Verbrauchsteuern

• Im Preis enthalten (Standard): Ihre Preise enthalten die Verbrauchsteuern bereits. Der Betrag wird auf der Produktseite („Darin enthaltene Verbrauchsteuern“) und im Warenkorb angezeigt und im Register erfasst.
• Beim Bestellabschluss hinzugefügt: Eine Zeile „Verbrauchsteuern“ mit den Steuern des Lieferlandes wird dem Warenkorb hinzugefügt. Sie wird von einem technischen, im Katalog ausgeblendeten Produkt getragen, das beim Aktivieren dieses Modus angelegt wird. Löschen Sie dieses Produkt nicht.
• Deaktiviert: Es wird kein Betrag berechnet, das Register erfasst nur Volumen und reinen Alkohol.

Steuerregel der Verbrauchsteuerzeile: In der EU gehören Verbrauchsteuern zur MwSt.-Bemessungsgrundlage. Wählen Sie Ihren Regelsatz.

Anzeige

Jedes Element wird einzeln aktiviert: Weinübersicht auf der Produktseite, Verbrauchsteuerbetrag auf der Produktseite, Pflichthinweis auf der Produktseite, Hinweis und Steuersumme im Warenkorb, Hinweis in der Fußzeile, Steuern und Hinweis auf PDF-Rechnungen, Tab Verkostungsblatt, Badges in Produktlisten.

Altersabfrage-Popup

• Prüfung: Schaltflächen Ja / Nein oder Geburtsdatum mit Altersberechnung.
• Merken für: Anzahl Tage, in denen der Besucher nicht erneut gefragt wird. 0 fragt bei jeder Browsersitzung erneut.
• Ausstiegs-URL: Seite, die geöffnet wird, wenn der Besucher mit Nein antwortet oder zu jung ist.
• Schaltflächenfarbe, Titel und Text je Sprache. Im Text wird {age} durch das Mindestalter des Besucherlandes ersetzt.

Das Popup wird Suchmaschinen-Robots, auf CMS-Seiten und angemeldeten Kunden, deren Geburtsdatum ihr Alter belegt, nicht angezeigt. Der Seiteninhalt bleibt im HTML.

Mischkarton

Legen Sie die erforderliche Flaschenzahl (Standard 6), den Rabatt in Prozent und die berechtigten Produkte fest: alle vom Modul verwalteten alkoholischen Produkte oder nur die in ihrem Tab markierten. Sobald der Warenkorb die erforderliche Zahl erreicht, erhält jede berechtigte Flasche den Rabatt. Ein Produkt, dessen eigener Kartonrabatt bereits greift, behält seinen Rabatt.

Länder ohne eigene Regel

Werte für die Länder, die Sie nicht konfiguriert haben: Lieferung von Alkohol erlaubt oder nicht, Alters-Checkbox im Checkout, Mindestalter.

Produkt-Standardwerte

Volumen (75 cl) und Kartongröße (6), die für ein neues Produkt vorgeschlagen werden.

Filterbare Merkmale

Die Tabelle zeigt den Status der acht Merkmale. Fehlende Merkmale neu anlegen legt ein gelöschtes Merkmal wieder an. Damit Kunden danach filtern können, fügen Sie die Merkmale Ihrer Filtervorlage in ps_facetedsearch hinzu (Schaltfläche Facettennavigation öffnen).

Ein Produkt erfassen

Öffnen Sie die Produktseite, Tab Module, Block Wine & Spirits. Aktivieren Sie Dieses Produkt ist ein alkoholisches Getränk. Der Block wird mit einer eigenen Schaltfläche gespeichert, unabhängig vom Produktformular.

Wein- und Spirituosendaten

• Kategorie: Steuerkategorie für die Verbrauchsteuer (Stillwein, Schaumwein, Likörwein, sonstiges Zwischenerzeugnis, Spirituosen, Bier, Apfelwein).
• Jahrgang oder Checkbox Ohne Jahrgang.
• Alkoholgehalt in % vol und Volumen pro Stück in cl.
• Rebsorten durch Kommas getrennt: Jede wird zu einem Filterwert. Herkunftsbezeichnung mit Vorschlägen aus vorhandenen Werten, um Dubletten zu vermeiden.

Profil und Verkostung

Farbe, Region, Herkunftsland, Serviertemperatur (min. und max.), Lagerpotenzial, Siegel (Bio, biodynamisch, Naturwein, vegan, HVE), Auszeichnungen und Bewertungen (eine pro Zeile). Verkostungsnotizen und Speiseempfehlungen werden je Sprache über die Sprach-Tabs erfasst.

Verkauf im Karton

• Nur einzeln: Standardverhalten.
• Einzeln oder kartonweise: Die Produktseite bietet die Wahl zwischen Flasche und Karton, mit Kartonpreis und Ersparnis.
• Nur kartonweise: Die Mindestmenge entspricht der Kartongröße und Warenkorbmengen werden auf den nächsten vollen Karton aufgerundet (abgerundet, wenn der Bestand fehlt).

Der Kartonrabatt, in % oder als Betrag je Karton, wird als nativer Mengenrabatt ab einem vollen Karton angelegt. Die Checkbox Für den gemischten Karton berechtigt erscheint, wenn der Mischkarton aktiviert ist.

Volumen je Kombination

Bei einem Produkt mit Kombinationen (halbe Flasche, Flasche, Magnum) tragen Sie das Volumen jeder Kombination ein. Leer übernimmt die Kombination das Produktvolumen. Verbrauchsteuern, reiner Alkohol im Register und das Verkostungsblatt folgen der Kombination.

Länder und Pflichthinweise

Der Tab listet die aktiven Länder mit einer Suche. Für jedes Land können Sie unter Bearbeiten festlegen:

• Alkohol darf in dieses Land geliefert werden: Deaktiviert wird ein Kunde mit Alkohol im Warenkorb im Lieferschritt mit einer Meldung gestoppt, und auf der Produktseite erscheint ein Hinweis.
• Checkbox Mindestalter im Checkout und Mindestalter: Die Checkbox „Ich bestätige, mindestens N Jahre alt zu sein“ wird den zu akzeptierenden Bedingungen im Zahlungsschritt hinzugefügt.
• Pflichthinweis je Sprache. Eine leere Sprache übernimmt die Standardsprache des Shops.

Das Lieferland wird aus der Lieferadresse des Warenkorbs gelesen, sonst aus der ersten Adresse des angemeldeten Kunden, dann aus dem Land des Besuchers, dann aus dem Standardland des Shops.

Verbrauchsteuersätze

Ein Satz wird durch Land, Kategorie, Bereich des Alkoholgehalts (Grenzen inklusive, 0 als Maximum für keine Grenze), Berechnungsgrundlage und Betrag in der Standardwährung ohne Steuern definiert. Mehrere Sätze können für dasselbe Produkt gelten und werden addiert.

• pro Hektoliter Erzeugnis: Weine, Schaumweine, Zwischenerzeugnisse, Apfelwein.
• pro Hektoliter reinen Alkohols: Spirituosen. Beispiel: 70 cl mit 40 % = 0,0028 hl reiner Alkohol.
• pro Hektoliter und Grad: Biere.
• pro Liter Erzeugnis und pro verkauftem Stück für andere Fälle.

Mitgelieferte französische Sätze 2026: Stillweine 4,19 €/hl, Schaumweine 10,38 €/hl, Apfelwein 1,46 €/hl, VDN und VDL 52,39 €/hl, sonstige Zwischenerzeugnisse 209,53 €/hl plus 52,39 €/hl Abgabe über 18 % vol, Spirituosen 1 932,42 €/hl reiner Alkohol plus 620,47 € Sozialversicherungsabgabe über 18 % vol, Biere 4,12 €/hl/Grad bis 2,8 % vol, darüber 8,24 €. Eine 70-cl-Flasche mit 40 % trägt damit 7,15 €.

Verbrauchsteuerregister

Jede bestätigte Bestellung erfasst für jedes alkoholische Produkt Lieferland, Kategorie, Kombination, Stückzahl, Volumen, Alkoholgehalt, reinen Alkohol und den Steuerbetrag zum Tagessatz. Der Tab Register filtert nach Zeitraum, Land und bestätigten Bestellungen, mit zwei CSV-Exporten: Zusammenfassung je Land und Kategorie sowie Bestellpositionen. Jede Bestellseite zeigt zudem ein Panel Verbrauchsteuern.

CSV-Import und -Export

Alkoholische Produkte exportieren oder Gesamten Katalog exportieren erzeugt eine Datei im Importformat. Füllen Sie sie in einer Tabellenkalkulation aus und importieren Sie sie wieder.

• Trennzeichen ; oder , wird automatisch erkannt. Produkt über id_product gefunden, sonst über reference.
• Eine fehlende Spalte oder leere Zelle behält den aktuellen Wert. - leert Jahrgang, Rebsorten, Herkunftsbezeichnung und Textfelder.
• vintage: Jahr oder NV. product_type: still_wine, sparkling_wine, vdn_vdl, intermediate, spirits, beer, cider. sale_mode: unit, both, case_only. color: red, white, rose, orange, amber, clear. labels: organic, biodynamic, natural, vegan, hve, durch Kommas getrennt. origin_country: ISO-Code (DE, FR…). awards: eine Auszeichnung pro Wert, getrennt durch |.
• Spalten je Sprache: tasting_notes_de, food_pairing_de, tasting_notes_en…

Lassen Sie Nur Simulation für einen ersten Durchlauf aktiviert: Der Bericht zeigt die gelesenen Zeilen, die Produkte, die aktualisiert würden, und die Fehler mit Zeilennummer, ohne etwas zu speichern.

Was der Kunde sieht

• Produktseite: Weinübersicht, Wahl Flasche oder Karton, Mischkarton-Angebot, Verbrauchsteuerbetrag, Mindestalter und Pflichthinweis, Warnung bei gesperrtem Lieferland.
• Tab Verkostungsblatt: Merkmalskarten, Siegel, Verkostungsnotizen, Speiseempfehlung und Auszeichnungen.
• Produktlisten: Badges für Farbe, Jahrgang, Siegel, Auszeichnungen und Mischkarton.
• Warenkorb: „2 x Karton à 6“ unter den Zeilen, Fortschritt des Mischkartons, Steuersumme und Pflichthinweis.
• Checkout: Checkbox Mindestalter, Verbrauchsteuerzeile im Modus hinzugefügt.
• PDF-Rechnung: Steuerbetrag, reiner Alkohol und Pflichthinweis.

Fehlerbehebung

Die Filter erscheinen nicht

Fügen Sie die Merkmale der Filtervorlage von ps_facetedsearch hinzu und weisen Sie die Vorlage den betreffenden Kategorien zu. Werte erscheinen erst, wenn mindestens ein Produkt mit seinen Daten gespeichert wurde.

Der Tab Verkostungsblatt oder die Badges werden nicht angezeigt

Prüfen Sie die Anzeigeoptionen und ob das Produkt als alkoholisches Getränk markiert ist. Die Badges nutzen den Hook displayProductListReviews, der Tab displayProductExtraContent: Ein Theme, das sie nicht aufruft, zeigt sie nicht an.

Die Verbrauchsteuerzeile erscheint nicht im Warenkorb

Prüfen Sie den Modus „Beim Bestellabschluss hinzugefügt“, ob das Lieferland Sätze für die Produktkategorie hat und ob das technische Produkt der Steuerzeile existiert (seine ID steht in den Einstellungen).

Das Altersabfrage-Popup erscheint auf jeder Seite erneut

Der Browser blockiert das Cookie dfws_age_ok. Stellen Sie sicher, dass kein Cookie-Manager es löscht: Es ist ein funktionales Cookie.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei deckt beide Versionen ab.
• Filter über native Merkmale, kompatibel mit ps_facetedsearch.
• Architektur ModuleAdminController, ohne Composer-Abhängigkeit, PHP 7.2 oder höher.
• Oberfläche auf Französisch, Englisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.