Dodatkowe Pola i Opcje Produktu – Atrybuty bez Kombinacji (Custom Fields)

Usługi dodatkowe

• Pakowanie prezentowe
• Personalizacja (grawer, nadruk)
• Montaż lub instalacja
• Ekspresowa realizacja

Gwarancja i wsparcie

• Rozszerzona gwarancja (12/24/36 miesięcy)
• Ubezpieczenie przesyłki
• Priorytetowe wsparcie techniczne
• Pakiet serwisowy

Produkty wirtualne

• Licencje oprogramowania (Basic/Pro/Enterprise)
• Kursy online (dostęp 30/90/365 dni)
• E-booki z dodatkami
• Subskrypcje z różnym zakresem

Opcje dostawy

• Dostawa standardowa / ekspresowa
• Dostawa w weekend
• Dostawa o określonej godzinie
• Odbiór osobisty z montażem

1. Zarządzanie wariantami

Centralna lista wszystkich wariantów z możliwością sortowania drag & drop.

• 4 typy wyświetlania: lista rozwijana, radio, checkbox, obrazki/kolory.
• Opisy HTML: każdy wariant może mieć rozbudowany opis z formatowaniem, wyświetlany jako tooltip na froncie.
• Wielojęzyczność: nazwy i opisy wariantów tłumaczone per język sklepu.
• Multistore: warianty przypisane per sklep.

2. Wartości wariantów

Każdy wariant może mieć dowolną liczbę wartości do wyboru.

• Opisy HTML: każda wartość wariantu posiada własne pole opisu z obsługą formatowania HTML.
• Wizualizacja: kolor HEX lub obrazek dla typu „image".
• Wielojęzyczność: nazwy i opisy wartości tłumaczone per język sklepu.
• Pozycjonowanie: kolejność wartości ustalana drag & drop.

3. Konfiguracja per produkt

Panel w zakładce produktu pozwala przypisać warianty i ustawić ceny.

• Wpływ cenowy: cena netto i brutto z automatycznym przeliczaniem.
• Ceny ujemne: możliwość udzielenia rabatu za wybraną opcję.
• Wymagalność: checkbox „Required" blokuje dodanie do koszyka bez wyboru.

4. Widok zamówienia

Wybrane warianty widoczne w szczegółach zamówienia.

• Snapshot danych: nazwa i cena zapisane w momencie zamówienia.
• Per linia zamówienia: warianty przypisane do konkretnego produktu.
• Historia: zmiana nazwy wariantu nie wpływa na historyczne zamówienia.

5. Konfiguracja wyświetlania

Panel konfiguracji pozwala określić pozycję i zachowanie modułu na froncie.

• Wybór pozycji (hook): displayProductActions (wewnątrz formularza, po ilości), displayProductAdditionalInfo (wewnątrz formularza, po przycisku dodaj do koszyka).
• Custom hook: displayPPVariants – możliwość ręcznego umieszczenia w dowolnym miejscu szablonu przez dewelopera.
• Włączanie/wyłączanie opisów: osobne przełączniki dla tooltipów wariantów i tooltipów wartości – możesz wyłączyć tooltips dla całego sklepu lub włączyć tylko dla jednego typu.

1. Wyświetlanie na karcie produktu

Warianty renderowane w wybranym hooku – wewnątrz formularza dodawania do koszyka.

• Dynamiczna cena: zmiana wybranych opcji aktualizuje cenę w czasie rzeczywistym.
• Tooltips wariantów: ikona (?) przy nazwie wariantu wyświetla opis HTML zdefiniowany w Back Office.
• Tooltips wartości: ikona (?) przy każdej wartości pokazuje jej indywidualny opis HTML.
• Responsywność: kafelki obrazkowe i checkbox'y dostosowane do mobile.

2. Walidacja wymaganych wariantów

Warianty oznaczone jako wymagane blokują formularz do momentu wyboru.

• Gwiazdka (*): wizualne oznaczenie pól wymaganych.
• Modal z komunikatem: informacja o brakującym wyborze.
• Bez przeładowania: walidacja JavaScript bez wysyłania formularza.

3. Integracja z koszykiem

Wybrane warianty widoczne w każdym miejscu prezentacji koszyka.

• Linia produktu: wariant wyświetlany pod nazwą produktu.
• Modal koszyka: widoczne po dodaniu produktu.
• Podsumowanie: pełna lista opcji w checkout.

4. Szczegóły zamówienia klienta

Sekcja „Moje zamówienia" wyświetla wybrane warianty z cenami.

• Format: Nazwa wariantu: Wybrana wartość (+XX,XX).
• Historyczność: dane z momentu złożenia zamówienia.

Zwiększenie wartości koszyka

Usługi dodatkowe typu gwarancja, pakowanie czy ekspresowa dostawa podnoszą średnią wartość zamówienia. Opcje widoczne bezpośrednio na karcie produktu mają wyższy współczynnik konwersji niż osobne strony.

Ochrona marży

Dopłaty za warianty nie podlegają rabatom. Przy promocji „-30% na wszystko" koszt pakowania prezentowego pozostaje stały – nie tracisz na usługach dodatkowych.

Uproszczenie katalogów

Zamiast tworzyć osobne produkty dla każdej wersji gwarancyjnej (produkt + gwarancja 12m, produkt + gwarancja 24m), obsługujesz wszystko jednym produktem z wariantami.

Struktura SEO

Jeden URL produktu zamiast wielu wariantów. Brak duplikacji treści, konsolidacja mocy SEO na głównej stronie produktu. Brak problemów z indeksowaniem kombinacji.

Architektura modułu

• ObjectModel: klasy PPVariant, PPVariantValue, PPProductVariant zgodne ze standardem PrestaShop.
• Multilang/Multishop: pełna obsługa wielu języków i sklepów przez natywne mechanizmy PS.

Integracja z szablonem

• Custom hook:

  {hook h='displayPPVariants' product=$product}

  – umieść w dowolnym miejscu szablonu produktu.
• Gotowe hooki: moduł działa z displayProductActions i displayProductAdditionalInfo bez modyfikacji szablonu.
• Klasy CSS: wszystkie elementy mają prefiksy pp-variant-* i pp-* – brak konfliktów ze stylami motywu.

Rozszerzalność

• Customization API: warianty wykorzystują natywny system customization PS – kompatybilność z innymi modułami.
• Hooki cenowe: actionProduc... – dopłaty dodawane po rabatach.
• Brak twardych zależności: moduł nie wymaga innych modułów ani zewnętrznych bibliotek JS/CSS.

Baza danych

• 8 tabel: warianty, wartości, przypisania produktów, koszyk, zamówienia + tabele _lang i _shop.
• Indeksy: optymalizacja zapytań przez klucze na id_product, id_shop, id_pp.
• Snapshot zamówień: nazwy i ceny zapisywane w momencie zamówienia – niezależne od późniejszych zmian.