DataFirefly Pack Variants: dokumentacja

Co robi moduł

W PrestaShop natywny zestaw wymusza wybór jednej konkretnej kombinacji dla każdego ze swoich produktów, w zakładce Zestaw w panelu administracyjnym. Para produkt i kombinacja trafia do bazy danych, a klient nie ma jak jej zmienić. Sprzedaż zestawu z koszulką w czterech rozmiarach oznacza więc utworzenie czterech zestawów.

DataFirefly Pack Variants dodaje listę wyboru na stronie zestawu. Dla każdego produktu, który uczynisz konfigurowalnym, klient wybiera swoją kombinację. Selekcja jest weryfikowana po stronie serwera, zapisywana wraz z linią koszyka, przenoszona aż do faktury, a zdejmowany jest stan tej kombinacji, którą klient rzeczywiście wybrał.

Instalacja

1. W panelu otwórz Moduły > Menedżer modułów, kliknij Wgraj moduł i wyślij plik ZIP.
2. Moduł tworzy swoje tabele i dodaje zakładkę Kombinacje zestawów w sekcji Katalog.
3. Otwórz konfigurację modułu, aby ustawić tytuł bloku, jego pozycję i zachowanie natywnej listy.

Moduł instaluje się na PrestaShop od 8.0 do 8.x. Nie wymaga żadnej zależności Composer ani nadpisywania szablonów motywu.

Konfiguracja zestawu

Przejdź do Katalog > Kombinacje zestawów. Pole wyszukiwania u góry pokazuje wyłącznie produkty oznaczone jako zestawy: wpisz nazwę, referencję lub identyfikator, a następnie wybierz zestaw. Zestawy już skonfigurowane pojawiają się tuż poniżej.

Ekran edycji pokazuje każdy produkt zestawu wraz z ilością, zadeklarowaną kombinacją i miniaturą. Produkty bez kombinacji są oznaczone i nie oferują żadnych ustawień.

Trzy tryby

• Stała kombinacja: zachowanie natywne, bez wyboru po stronie klienta. To tryb domyślny.
• Klient wybiera dowolną kombinację: oferowane są wszystkie kombinacje produktu.
• Klient wybiera spośród wskazanych kombinacji: zaznaczasz dozwolone kombinacje na liście. Potrzebne są co najmniej dwie, w przeciwnym razie zapis zostanie odrzucony.

Ograniczenie wyboru do jednej grupy atrybutów

Produkt z Rozmiarem i Kolorem szybko tworzy dziesiątki kombinacji. Ograniczenie do grupy atrybutów rozwiązuje najczęstszy przypadek: wybierasz Rozmiar, a pozostałe atrybuty zostają na wartościach kombinacji zadeklarowanej w panelu. Klient widzi tylko listę rozmiarów, kolor pozostaje ten, który ustaliłeś dla zestawu.

Import masowy

Jeśli Twój katalog ma już dziesiątki zestawów, panel Import masowy na stronie głównej modułu stosuje tę samą regułę do wszystkich. Wybierasz:

• Zestawy do przetworzenia: tylko te jeszcze nieskonfigurowane albo wszystkie zestawy z nadpisaniem istniejących ustawień.
• Tylko aktywne zestawy: aby pominąć zestawy wyłączone.
• Konfiguracja do zastosowania: swobodny wybór na wszystkich produktach albo przywrócenie natywnych stałych kombinacji.
• Ograniczenie do grupy atrybutów: na przykład Rozmiar, stosowane wszędzie tam, gdzie ta grupa istnieje.
• Produkty bez tej grupy: zostawić je stałe albo zaproponować wszystkie ich kombinacje.

Przycisk Podgląd liczy objęte zestawy i symuluje pierwszą partię bez zapisywania czegokolwiek. Przycisk Uruchom import przetwarza następnie katalog partiami po 25, z paskiem postępu. Stronicowanie opiera się na kursorze po identyfikatorze produktu, co pozwala uniknąć przesunięć, gdy zapis zmienia zakres w trakcie, oraz timeoutów na dużych katalogach.

Ustawienia ogólne

W konfiguracji modułu:

• Tytuł bloku: nagłówek wyświetlany nad listami wyboru, tłumaczony per język.
• Pozycja bloku: pod informacjami o produkcie przez natywny hook albo tuż nad przyciskiem dodania do koszyka przez przeniesienie w JavaScript.
• Ukryj natywną listę zestawu: domyślnie włączone. Moduł sam wyświetla całą zawartość zestawu, a pozostawienie natywnej listy pokazywałoby zadeklarowane kombinacje, wbrew wyborowi klienta.
• Selektor CSS natywnej listy: .product-pack dla Classic i Hummingbird. Zmieniaj tylko wtedy, gdy Twój motyw wyświetla zawartość zestawu gdzie indziej.
• Pokaż ceny produktów: cena jednostkowa każdego produktu zestawu.
• Ukryj kombinacje niedostępne: gdy wyłączone, pozostają do wyboru, jeśli produkt pozwala zamawiać przy braku stanu.
• Ukryj natywne pole personalizacji: zostaw włączone, zobacz następną sekcję.

Co widzi klient

Na stronie zestawu moduł wyświetla kartę z całą zawartością: listę rozwijaną dla każdego konfigurowalnego produktu i zadeklarowaną kombinację tekstem dla pozostałych. Każdy wiersz zawiera miniaturę, ilość oraz, jeśli opcja jest włączona, cenę jednostkową.

Jeśli klient zatwierdzi bez uzupełnienia wyboru, pod blokiem pojawia się komunikat błędu, a dodanie do koszyka zostaje zablokowane. Kombinacje niedostępne są wyłączone lub ukryte zgodnie z Twoimi ustawieniami.

Koszyk, zamówienie i faktura

Selekcja zapisywana jest w natywnym mechanizmie personalizacji PrestaShop. To właśnie on pozwala dwóm identycznym zestawom o różnych kompozycjach pozostać dwiema osobnymi liniami koszyka, podczas gdy rdzeń zwykle łączy linie z tym samym produktem. Klient, który doda dwa razy dokładnie tę samą kompozycję, po prostu zobaczy wzrost ilości istniejącej linii do dwóch.

Podsumowanie wyboru pojawia się automatycznie w koszyku, potwierdzeniu zamówienia, e-mailach, historii klienta, szczegółach zamówienia w panelu i na fakturze PDF.

Stany magazynowe

Natywny zestaw zdejmuje stan kombinacji zapisanej w tabeli zestawów, a nie tej wybranej przez klienta. Przy zatwierdzeniu zamówienia moduł to koryguje: kombinacja zadeklarowana wraca na stan, wybrana zostaje zdjęta, sklep po sklepie.

Korekta dotyczy wyłącznie zestawów, których tryb zarządzania stanami zdejmuje produkty składowe. Zestaw ustawiony na zdejmowanie tylko własnego stanu nie jest objęty, a ekran edycji o tym informuje.

Rozwiązywanie problemów

Blok nie pojawia się na stronie produktu

Blok pojawia się tylko wtedy, gdy zestaw zawiera co najmniej jeden naprawdę konfigurowalny produkt: tryb inny niż stały, produkt z kombinacjami i co najmniej dwie kombinacje kandydujące po filtrowaniu listy dozwolonych, grupy atrybutów i stanu. Sprawdź też, czy hook displayProductAdditionalInfo jest zarejestrowany w Twoim motywie.

Natywna lista zestawu wciąż jest widoczna

Twój motyw nie używa .product-pack. Zbadaj stronę, odczytaj klasę lub identyfikator kontenera i wpisz go w ustawieniu selektora CSS.

Na stronie pojawia się puste pole tekstowe

To pole personalizacji modułu, wyświetlane przez niektóre motywy. Włącz przewidziane ustawienie, które je ukrywa.

Wybór nie pojawia się w koszyku

Wyczyść pamięć podręczną PrestaShop i sprawdź, czy żaden moduł zewnętrzny nie zastępuje formularza dodawania do koszyka. Moduł przechwytuje kliknięcie przycisku w fazie przechwytywania, aby zadziałać przed skryptem motywu, ale formularz całkowicie przebudowany przez inny moduł może ominąć ten punkt zaczepienia.

Znane ograniczenia

• Wpływ kombinacji na cenę jest ignorowany. Natywny zestaw sprzedawany jest w jednej cenie, której personalizacja nie może zmienić. Ekran edycji oznacza objęte produkty, abyś mógł wykluczyć te kombinacje z listy dozwolonych.
• Faktura pozostaje jedną linią ze stawką VAT zestawu, a szczegóły wyborów trafiają do podsumowania personalizacji. Jeśli każdy składnik ma być fakturowany osobno z własną stawką, spójrz na DataFirefly Pack Pro lub Pack VAT Pro.
• Ta wersja jest przeznaczona dla PrestaShop od 8.0 do 8.x. Ponieważ ekran zarządzania zestawami zmienił podstawę techniczną w PrestaShop 9, port pojawi się jako osobna wersja.

Zgodność

• PrestaShop od 8.0.0 do 8.x
• Wiele sklepów: ustawienia zapisywane są per sklep
• Wiele języków: interfejs modułu dostarczony po polsku, angielsku, francusku, hiszpańsku, niemiecku, włosku, niderlandzku i portugalsku
• Testowany na szablonie Classic