Kreator Zestawów (Mix and Match): kompletny przewodnik
Instalacja, konfiguracja i prowadzenie kreatora zestawów „Mix and Match": źródła produkt/kategoria, 4 modele cenowe, sloty kategorii, gotowe szablony, funkcja niespodzianki, zapis i udostępnianie, grywalizacja i statystyki dla PrestaShop 8 i 9.
Wprowadzenie
Moduł Kreator Zestawów (Mix and Match) (dfboxbuilder) dodaje stronę, na której klienci komponują własny zestaw z wybranej przez Ciebie selekcji produktów. Wybierają artykuły z siatki, śledzą pasek postępu, widzą cenę aktualizowaną na żywo, po czym jednym kliknięciem dodają cały zestaw do koszyka. Idealny dla zestawów delikatesowych, boxów beauty, koszy prezentowych, pakietów „3 produkty w cenie”, subskrypcji odkrywczych i podobnych ofert.
Tworzysz dowolną liczbę zestawów, każdy z własnymi produktami, regułami (minimalna i maksymalna liczba artykułów) oraz modelem cenowym. Ten sam katalog może zasilać kilka zupełnie różnych zestawów.
Kompatybilność
- PrestaShop 1.7.6 do 8.x i 9.x
- PHP 7.4 do 8.x
- Jeden sklep i multisklep
- 5 języków: FR, EN, ES, DE, IT (przetłumaczone w 100%, bez fallbacku)
- Motyw Classic i motywy niestandardowe (kreator w natywnym JavaScript, bez zależności od jQuery)
- Zero zależności (ani Composer, ani framework)
Instalacja
- W panelu administracyjnym otwórz Moduły > Menedżer modułów.
- Kliknij Zainstaluj moduł i wybierz plik
dfboxbuilder.zip. - Po instalacji otwórz dodaną do menu zakładkę Box Builder, aby utworzyć pierwszy zestaw.
Podczas instalacji moduł tworzy tabele, rejestruje hooki (displayHeader, actionFrontControllerSetMedia, displayHome oraz actionValidateOrder) i dodaje zakładkę administracyjną Box Builder. Przy pierwszym zapisie zestawu automatycznie generowany jest ukryty produkt kontenerowy: to on niesie pozycję zestawu w koszyku i nie jest widoczny w katalogu.
Konfiguracja zestawu
Formularz edycji zestawu podzielony jest na pięć zakładek.
Zakładka Ogólne
- Nazwa, opis, etykieta przycisku: tłumaczone w 5 językach.
- Artykuły min / max: granice kompozycji. Maksimum steruje celem paska postępu.
- Zezwól na duplikaty oraz maksymalna liczba sztuk na artykuł: pozwalają (lub nie) dodać ten sam produkt kilka razy, z limitem na produkt.
- Ukryj produkty niedostępne: usuwa z siatki produkty bez stanu (z uwzględnieniem ustawień braku towaru każdego produktu).
- Włącz „Zaskocz mnie” oraz Włącz zapis i udostępnianie: pokazują lub ukrywają te akcje po stronie klienta.
- Aktywny: publikuje zestaw lub nie.
Zakładka Cennik
Dostępne są cztery modele cenowe:
- Cena stała: jedna cena zestawu, niezależnie od zawartości.
- Progi ilościowe: cena zmienia się według liczby artykułów (np. 3 artykuły = 25 €, 6 artykułów = 45 €). Definiujesz dowolną liczbę progów „od X artykułów”.
- Suma produktów z rabatem: cena to suma produktów wchodzących w skład zestawu, pomniejszona o procent rabatu.
- Cena według slotu: każdy slot wnosi stałą cenę jednostkową; suma zależy od wypełnionych slotów.
Ta zakładka steruje też grywalizacją: prezent za skompletowanie zestawu (wybór darmowego produktu dodawanego do koszyka) oraz darmowa dostawa przy komplecie.
Cenę bazową / stałą wpisuje się netto. Moduł stosuje następnie podatek produktu kontenerowego i pokazuje klientowi cenę brutto.
Zakładka Kompozycja (źródła i sloty)
Definiujesz produkty kwalifikujące się do siatki kreatora poprzez dwa typy źródeł:
- Produkty: dodawane pojedynczo dzięki wyszukiwarce z autouzupełnianiem.
- Kategorie: wszystkie aktywne produkty kategorii stają się dostępne.
Opcja Użyj slotów według kategorii włącza kompozycję „krokową”. Każdy slot ma własną nazwę, granice min / max, ewentualną cenę slotu i własne źródła. Możesz więc wymagać na przykład „2 dania + 3 dodatki + 1 deser”. Bez slotów klient wybiera swobodnie z globalnej listy.
Zakładka Szablony (gotowe zestawy)
Proponujesz zestawy „gotowe do użycia”, które klient wybiera jednym kliknięciem, a potem dowolnie modyfikuje. Każdy szablon ma nazwę, opis i listę produktów (dodawanych przez wyszukiwarkę z autouzupełnianiem). Idealne do prowadzenia niezdecydowanego klienta lub promowania bestsellerowego asortymentu.
Zakładka Ograniczenia
Deklarujesz pary produktów niekompatybilnych, które nie mogą znaleźć się razem w tym samym zestawie. Kreator blokuje wtedy ich wspólny wybór, a walidacja serwerowa go odrzuca.
Użycie po stronie klienta
Interaktywny kreator
Strona kompozycji wyświetla siatkę produktów (zdjęcie, nazwa, w razie potrzeby ostrzeżenie „niski stan”) oraz przyklejony panel podsumowania: pasek postępu, listę wybranych artykułów, cenę liczoną na żywo (zoptymalizowane wywołanie AJAX) i komunikaty walidacji. Przycisk dodania do koszyka aktywuje się dopiero wtedy, gdy kompozycja spełnia wszystkie reguły.
Sloty kategorii
Gdy sloty są włączone, zakładki prowadzą klienta od slotu do slotu, a każda pokazuje swój licznik (na przykład „Dania 2/3″) i własną selekcję produktów.
Zaskocz mnie
Przycisk Zaskocz mnie automatycznie wypełnia zestaw kwalifikującymi się produktami, respektując maksymalną liczbę artykułów, granice każdego slotu i niekompatybilności. Klient może potem dopasować zaproponowany wybór.
Zapisz i udostępnij
Klient może zapisać swoją kompozycję i otrzymać link do udostępnienia. Każdy, kto otworzy ten link, zobaczy wstępnie wypełniony zestaw, gotowy do modyfikacji i zamówienia.
Dodanie do koszyka i zamówienie
Przy dodaniu do koszyka kompozycja jest zapisywana jako personalizacja pozycji (i pozostaje widoczna w koszyku, a potem na zamówieniu), a obliczona cena zestawu zostaje zastosowana. Jeśli grywalizacja jest włączona, prezent jest dodawany bezpłatnie. Przy walidacji zamówienia moduł zdejmuje stan każdego produktu składowego zestawu i rejestruje sprzedaż na potrzeby statystyk.
Statystyki (panel administracyjny)
Zakładka Statystyki agreguje zamówione zestawy: obrót, liczbę zamówień, średnią liczbę artykułów na zestaw, wyniki według zestawu oraz najpopularniejsze kombinacje. Wszystko, czego potrzebujesz, aby zidentyfikować wygrywające asortymenty i dopracować źródła.
Wyświetlanie na stronie głównej (opcjonalne)
Opcjonalny blok na stronie głównej wypisuje aktywne zestawy z bezpośrednim linkiem do ich kreatora. Strona zestawu jest też dostępna bezpośrednio pod adresem: index.php?fc=module&module=dfboxbuilder&controller=builder&id_dfbox=ID. Możesz podlinkować ją z menu, strony CMS lub banera.
Działanie techniczne
Dla każdego zestawu ukryty produkt kontenerowy (widoczność „nigdzie”, niedostępny w nawigacji) niesie pozycję w koszyku. Cena zestawu jest stosowana przez cenę specyficzną ograniczoną do koszyka klienta, więc cena katalogowa kontenera nigdy nie jest pokazywana. Kompozycja jest przechowywana jako personalizacja, a stany składników są zdejmowane przy walidacji zamówienia.
W modelu Suma z rabatem, jeśli klient doda dwa zestawy tego samego zestawu o różnych cenach kompozycji, do obu pozycji zastosowana zostanie ostatnia obliczona cena (cenę specyficzną niesie produkt kontenerowy). Przy cenie stałej, progowej lub według slotu przy równej liczbie artykułów nie ma to żadnego wpływu.
Usunięcie zestawu nie usuwa automatycznie jego ukrytego produktu kontenerowego (v1). Jeśli usuwasz zestaw testowy, możesz ręcznie skasować powiązany produkt kontenerowy z katalogu.
FAQ i rozwiązywanie problemów
Kreator się nie wyświetla albo przyciski nie reagują
Wyczyść pamięć podręczną PrestaShop (Zaawansowane > Wydajność), a na czas testów wyłącz łączenie i kompresję plików (CCC). Upewnij się, że zestaw jest aktywny i ma co najmniej jedno źródło produktów.
Siatka jest pusta
Sprawdź, czy źródła (produkty lub kategorie) zawierają produkty aktywne dla bieżącego sklepu. Jeśli włączono „Ukryj produkty niedostępne”, produkty bez stanu się nie pojawiają.
Wyświetlana cena nie odpowiada oczekiwaniom
Sprawdź wybrany model cenowy: cena stała ignoruje zawartość, progi zależą od liczby artykułów, suma z rabatem zależy od cen produktów, a cena według slotu od wypełnionych slotów. Cenę bazową wpisuje się netto.
Stany składników nie są zdejmowane
Zdejmowanie następuje przy walidacji zamówienia (hook actionValidateOrder), a nie przy dodaniu do koszyka. Sprawdź, czy zamówienie faktycznie osiąga prawidłowy status.
Czy mogę wymusić dokładną strukturę (według kategorii)?
Tak: włącz sloty i zdefiniuj dla każdego minimum / maksimum oraz źródła. Otrzymasz prowadzoną kompozycję typu „2 + 3 + 1″.
Czy moduł jest zgodny z PrestaShop 9?
Tak. Moduł jest zgodny z PrestaShop 8 i 9, w multisklepie i w wersji wielojęzycznej (FR, EN, ES, DE, IT).