# 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… - Strona: - Język: pl - Zaktualizowano: 2026-09-24 - Inne języki: [fr](https://www.datafirefly.com/documentation/dfwinespirits/index.md), [en](https://www.datafirefly.com/en/documentation/dfwinespirits/index.md), [es](https://www.datafirefly.com/es/documentation/dfwinespirits/index.md), [de](https://www.datafirefly.com/de/documentation/dfwinespirits/index.md), [it](https://www.datafirefly.com/it/documentation/dfwinespirits/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfwinespirits/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfwinespirits/index.md) - Indeks: ## 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. Przy zapisie moduł nadpisuje osiem cech produktu. Nie edytuj ich ręcznie w zakładce Cechy: zmiany zostałyby zastąpione przy kolejnym zapisie bloku. ## 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 €. Stawki zmieniają się co roku 1 stycznia. Sprawdź je w urzędzie celnym i zaktualizuj. **Wczytaj francuskie stawki 2026** zastępuje wszystkie stawki dla Francji stawkami dołączonymi do modułu. ## 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.