Wina i alkohole w PrestaShop: dokumentacja DataFirefly Wine & Spirits

Instalacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł, korzystając z pliku ZIP. Moduł tworzy swoje tabele, rejestruje hooki i dodaje menu Katalog > Wina i alkohole.

Podczas instalacji tworzy też osiem natywnych cech: Rocznik, Szczep winorośli, Apelacja, Zawartość alkoholu, Kolor, Region, Kraj pochodzenia i Certyfikat. Konfiguruje Francję (wiek 18 lat, pole wieku przy płatności, obowiązkowe francuskie ostrzeżenie zdrowotne) oraz francuskie stawki akcyzy na 2026 r.

Aby zaktualizować wcześniejszą wersję, zainstaluj nowy plik ZIP: skrypty aktualizacji dodają brakujące kolumny, tabele i cechy bez naruszania Twoich danych.

Pulpit

Pierwsza zakładka menu. Pokazuje liczbę zarządzanych produktów, sprzedane sztuki, czysty alkohol i akcyzę z bieżącego miesiąca, listę kontrolną konfiguracji, kompletność danych (zawartość alkoholu, kolor, rocznik, szczepy, apelacja) oraz 30 ostatnich produktów do uzupełnienia z linkiem do ich karty. Kolor, rocznik i szczepy są sprawdzane tylko dla win.

Ustawienia

Tryb obliczania akcyzy

• Wliczona w cenę (domyślnie): Twoje ceny zawierają już akcyzę. Kwota jest pokazywana na karcie produktu („W tym akcyza”) i w koszyku, a następnie zapisywana w rejestrze.
• Doliczana przy zamówieniu: do koszyka dodawana jest pozycja „Akcyza” z akcyzą kraju dostawy. Obsługuje ją produkt techniczny ukryty w katalogu, tworzony po włączeniu tego trybu. Nie usuwaj tego produktu.
• Wyłączona: żadna kwota nie jest obliczana, rejestr zapisuje tylko objętości i czysty alkohol.

Reguła podatkowa pozycji akcyzy: w UE akcyza wchodzi do podstawy VAT. Wybierz stawkę podstawową.

Wyświetlanie

Każdy element włącza się osobno: podsumowanie wina na karcie produktu, kwota akcyzy na karcie, informacja prawna na karcie, informacja i suma akcyzy w koszyku, informacja w stopce, akcyza i informacja na fakturze PDF, zakładka Karta degustacyjna, znaczki na listach produktów.

Okno weryfikacji wieku

• Weryfikacja: przyciski Tak / Nie albo data urodzenia z obliczeniem wieku.
• Zapamiętaj na: liczba dni, przez które odwiedzający nie jest ponownie pytany. 0 pyta przy każdej sesji przeglądarki.
• Adres URL wyjścia: strona otwierana, gdy odwiedzający odpowie nie lub nie ma wymaganego wieku.
• Kolor przycisków, tytuł i tekst w każdym języku. W tekście {age} jest zastępowane wiekiem kraju odwiedzającego.

Okno nie jest pokazywane robotom wyszukiwarek, na stronach CMS ani zalogowanym klientom, których data urodzenia potwierdza wiek. Treść strony pozostaje w HTML.

Mieszany karton

Ustaw wymaganą liczbę butelek (domyślnie 6), rabat procentowy i kwalifikujące się produkty: wszystkie produkty alkoholowe zarządzane przez moduł albo tylko oznaczone w ich zakładce. Gdy koszyk osiągnie wymaganą liczbę, każda kwalifikująca się butelka dostaje rabat. Produkt, dla którego działa już własny rabat za karton, zachowuje swój rabat.

Kraje bez własnej reguły

Wartości dla krajów, których nie skonfigurowano: dostawa alkoholu dozwolona lub nie, pole wieku przy płatności, wiek uprawniający.

Domyślne wartości produktów

Pojemność (75 cl) i wielkość kartonu (6) proponowane dla nowego produktu.

Cechy do filtrowania

Tabela pokazuje stan ośmiu cech. Utwórz ponownie brakujące cechy odtwarza usuniętą cechę. Aby klienci mogli po nich filtrować, dodaj je do szablonu filtrów w ps_facetedsearch (przycisk Otwórz nawigację fasetową).

Uzupełnianie produktu

Otwórz kartę produktu, zakładka Moduły, blok Wine & Spirits. Zaznacz Ten produkt jest napojem alkoholowym. Blok zapisuje się własnym przyciskiem, niezależnie od formularza produktu.

Dane win i alkoholi

• Kategoria: kategoria podatkowa do obliczania akcyzy (wino spokojne, musujące, wzmacniane, inny produkt pośredni, alkohole mocne, piwo, cydr).
• Rocznik lub pole Bez rocznika.
• Zawartość alkoholu w % obj. i pojemność sztuki w cl.
• Szczepy winorośli oddzielone przecinkami: każdy staje się wartością filtra. Apelacja z podpowiedziami istniejących wartości, aby uniknąć duplikatów.

Profil i degustacja

Kolor, region, kraj pochodzenia, temperatura podawania (min. i maks.), potencjał leżakowania, oznaczenia (ekologiczne, biodynamiczne, wino naturalne, wegańskie, HVE), nagrody i oceny (jedna w wierszu). Nuty degustacyjne i połączenia z potrawami wpisuje się w każdym języku za pomocą zakładek językowych.

Sprzedaż w kartonach

• Tylko na sztuki: standardowe działanie.
• Na sztuki lub na kartony: karta produktu daje wybór między butelką a kartonem, z ceną kartonu i oszczędnością.
• Tylko na kartony: minimalna ilość to wielkość kartonu, a ilości w koszyku są zaokrąglane w górę do pełnego kartonu (w dół, gdy brakuje stanu).

Rabat za karton, procentowy lub kwotowy za karton, tworzony jest jako natywny rabat ilościowy od jednego pełnego kartonu. Pole Kwalifikuje się do mieszanego kartonu pojawia się, gdy mieszany karton jest włączony.

Pojemność według kombinacji

Dla produktu z kombinacjami (pół butelki, butelka, magnum) wpisz pojemność każdej kombinacji. Puste pole oznacza pojemność produktu. Akcyza, czysty alkohol w rejestrze i karta degustacyjna odpowiadają kombinacji.

Kraje i informacje prawne

Zakładka wyświetla aktywne kraje z wyszukiwarką. Dla każdego kraju przycisk Edytuj pozwala ustawić:

• Alkohol może być dostarczany do tego kraju: po odznaczeniu klient z alkoholem w koszyku zatrzymuje się na etapie dostawy z komunikatem, a na karcie produktu pojawia się ostrzeżenie.
• Pole wieku przy składaniu zamówienia i wiek uprawniający: pole „Potwierdzam, że mam co najmniej N lat” trafia do warunków do zaakceptowania na etapie płatności.
• Informacja prawna w każdym języku. Pusty język korzysta z domyślnego języka sklepu.

Kraj dostawy jest odczytywany z adresu dostawy koszyka, w przeciwnym razie z pierwszego adresu zalogowanego klienta, następnie z kraju odwiedzającego, a na końcu z domyślnego kraju sklepu.

Stawki akcyzy

Stawkę określa się przez kraj, kategorię, zakres zawartości alkoholu (granice włącznie, 0 jako maksimum oznacza brak limitu), podstawę obliczenia i kwotę w domyślnej walucie, bez podatku. Do jednego produktu może mieć zastosowanie kilka stawek, które się sumują.

• za hektolitr produktu: wina, wina musujące, produkty pośrednie, cydry.
• za hektolitr czystego alkoholu: alkohole mocne. Przykład: 70 cl o mocy 40% = 0,0028 hl czystego alkoholu.
• za hektolitr i za stopień: piwa.
• za litr produktu i za sprzedaną sztukę w innych przypadkach.

Dołączone francuskie stawki 2026: wina spokojne 4,19 €/hl, musujące 10,38 €/hl, cydry 1,46 €/hl, VDN i VDL 52,39 €/hl, inne produkty pośrednie 209,53 €/hl plus 52,39 €/hl składki powyżej 18% obj., alkohole 1932,42 €/hl czystego alkoholu plus 620,47 € składki na ubezpieczenie społeczne powyżej 18% obj., piwa 4,12 €/hl/stopień do 2,8% obj., powyżej 8,24 €. Butelka 70 cl o mocy 40% jest więc obciążona kwotą 7,15 €.

Rejestr akcyzy

Każde zatwierdzone zamówienie zapisuje dla każdego produktu alkoholowego kraj dostawy, kategorię, kombinację, sztuki, objętość, zawartość alkoholu, czysty alkohol i kwotę akcyzy według stawki z danego dnia. Zakładka Rejestr filtruje według okresu, kraju i zatwierdzonych zamówień, z dwoma eksportami CSV: podsumowaniem według kraju i kategorii oraz pozycjami zamówień. Strona każdego zamówienia pokazuje też panel Akcyza.

Import i eksport CSV

Eksportuj produkty alkoholowe lub Eksportuj cały katalog tworzy plik w formacie importu. Uzupełnij go w arkuszu kalkulacyjnym i zaimportuj ponownie.

• Separator ; lub , wykrywany automatycznie. Produkt znajdowany po id_product, w przeciwnym razie po reference.
• Brak kolumny lub pusta komórka zachowuje bieżącą wartość. - czyści rocznik, szczepy, apelację i pola tekstowe.
• vintage: rok lub 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, oddzielone przecinkami. origin_country: kod ISO (PL, FR…). awards: jedna nagroda na wartość, oddzielone znakiem |.
• Kolumny w każdym języku: tasting_notes_pl, food_pairing_pl, tasting_notes_en…

Przy pierwszym przebiegu pozostaw zaznaczone Tylko symulacja: raport pokazuje odczytane wiersze, produkty, które zostałyby zaktualizowane, i błędy z numerem wiersza, niczego nie zapisując.

Co widzi klient

• Karta produktu: podsumowanie wina, wybór butelki lub kartonu, oferta mieszanego kartonu, kwota akcyzy, wiek i informacja prawna, ostrzeżenie przy zablokowanym kraju dostawy.
• Zakładka Karta degustacyjna: karty cech, oznaczenia, nuty degustacyjne, połączenia z potrawami i nagrody.
• Listy produktów: znaczki koloru, rocznika, oznaczeń, nagród i mieszanego kartonu.
• Koszyk: „2 x karton po 6” pod pozycjami, postęp mieszanego kartonu, suma akcyzy i informacja prawna.
• Płatność: pole wieku, pozycja akcyzy w trybie doliczanym.
• Faktura PDF: kwota akcyzy, czysty alkohol i informacja prawna.

Rozwiązywanie problemów

Filtry się nie pojawiają

Dodaj cechy do szablonu filtrów ps_facetedsearch i przypisz szablon do odpowiednich kategorii. Wartości pojawiają się dopiero po zapisaniu co najmniej jednego produktu z danymi.

Zakładka Karta degustacyjna lub znaczki się nie wyświetlają

Sprawdź opcje wyświetlania oraz to, czy produkt jest oznaczony jako napój alkoholowy. Znaczki korzystają z hooka displayProductListReviews, a zakładka z displayProductExtraContent: motyw, który ich nie wywołuje, ich nie wyświetli.

Pozycja akcyzy nie pojawia się w koszyku

Sprawdź tryb Doliczana przy zamówieniu, czy kraj dostawy ma stawki dla kategorii produktu i czy istnieje produkt techniczny pozycji akcyzy (jego ID jest widoczne w ustawieniach).

Okno wieku pojawia się na każdej stronie

Przeglądarka blokuje plik cookie dfws_age_ok. Upewnij się, że menedżer plików cookie go nie usuwa: to plik funkcjonalny.

Zgodność

• PrestaShop 8.0 do 9.x, ten sam plik ZIP obsługuje obie gałęzie.
• Filtry przez natywne cechy, zgodne z ps_facetedsearch.
• Architektura ModuleAdminController, bez zależności Composer, PHP 7.2 lub nowszy.
• Interfejs po francusku, angielsku, hiszpańsku, niemiecku, włosku, niderlandzku, polsku i portugalsku.