Zestawy produktów i bundle: dokumentacja

Instalacja

Moduł instaluje się jak każdy moduł PrestaShop, przez back office lub przez FTP.

1. W sekcji Moduły i Menedżer modułów kliknij Prześlij moduł i upuść plik dfpackpro.zip.
2. Przez FTP rozpakuj archiwum do katalogu /modules/ sklepu, a następnie zainstaluj DataFirefly – Packs & Bundles z menedżera modułów.
3. Wyczyść cache w Zaawansowane i Wydajność.

Instalacja tworzy sześć tabel z prefiksem ps_dfpackpro, rejestruje wymagane hooki i dodaje zakładkę Packs & Bundles (DF) w menu Katalog.

Ustawienia ogólne

Przycisk Konfiguruj na karcie modułu otwiera ustawienia stosowane do wszystkich zestawów.

• Pozycja bloku na karcie produktu: pod blokiem zakupu, na dole karty lub oba. Blok wyświetla zestawy zawierające oglądany produkt.
• Blok zestawów aktywny: wyłącza wyświetlanie cross-sell bez odinstalowywania. Strony zestawów pozostają dostępne.
• Maksymalna liczba wyświetlanych zestawów: domyślnie 3.
• Sortowanie zestawów: pozycja, data utworzenia lub losowo.
• Pokaż ceny jednostkowe: wyszczególnia cenę każdego składnika na stronie zestawu.
• Pokaż oszczędność: znaczek i zaoszczędzona kwota, na bloku karty produktu i stronie zestawu.
• Pokaż dostępność: stan magazynowy zestawu, liczony ze stanów składników.
• Ścisły tryb koszyka: jeśli klient usunie składnik, cały zestaw i jego rabat są usuwane. Wyłączony, usunięcie jest akceptowane, a rabat zachowany na reszcie.
• Po dodaniu do koszyka: przekierowanie do koszyka lub potwierdzenie na miejscu.
• Kolor akcentu: kolor znaczków, przycisków i obramowań bloków modułu.

Tworzenie zestawu

Otwórz Katalog i Packs & Bundles (DF), a następnie kliknij Nowy zestaw.

Informacje o zestawie

• Nazwa: pole tłumaczone, wyświetlane na bloku karty produktu, stronie zestawu i znaczku w koszyku.
• Alias URL: generowany automatycznie z nazwy, gdy pole jest puste. Tworzy adres strony zestawu.
• Opis: tłumaczony tekst sformatowany, wyświetlany na stronie zestawu.
• Znaczek: krótki tłumaczony tekst na kartach bloku cross-sell. Zostaw puste, aby wyświetlić procent oszczędności.
• Tryb cenowy: cztery tryby opisane niżej. Formularz ukrywa niepotrzebne pola według wybranego trybu.
• Dziedzicz istniejące promocje: włączone, bieżące rabaty katalogowe są ceną wyjściową obliczeń zestawu.
• Daty ważności: zostaw puste dla zestawu stałego. Poza okresem zestaw znika z frontu.
• Aktywny: odpowiednik przełącznika aktywacji na liście.

Składniki

Panel Składniki zarządza zawartością zestawu.

• Wyszukiwarka produktów: wpisz co najmniej dwa znaki. Wyszukiwanie obejmuje nazwę, referencję i ID. Kliknij wynik, aby go dodać.
• Wariant: dla produktu z wariantami selektor wyświetla wersje z ich ceną. Wybrany wariant staje się domyślnym.
• Wybór wariantu przez klienta: włączone, klient wybiera swój wariant na stronie zestawu i w bloku karty produktu. Wyłączone, wariant jest narzucony.
• Ilość: liczba sztuk składnika w zestawie. Zestaw może zawierać jeden produkt w ilości, dla sprzedaży wielosztukowej.
• Ilość edytowalna: klient może dostosować ilość tego składnika na stronie zestawu.
• Opcjonalny: klient może odznaczyć ten składnik, cena się przelicza.
• Rabat na produkt: procentowy lub kwotowy, widoczny tylko w trybie Rabat na produkt. Rabat 100 % czyni składnik gratisem.
• Kolejność: strzałki w górę i w dół do porządkowania wyświetlania.

Symulator ceny pod tabelą przelicza na żywo cenę całkowitą, cenę zestawu i oszczędność przy każdej zmianie.

Cztery tryby cenowe

Bez rabatu

Zestaw sprzedaje składniki po ich bieżącej cenie. Przydatny dla zestawu czysto wygodowego lub aby wyeksponować samą kompozycję.

Globalny rabat procentowy

Procent stosuje się do ceny każdego składnika. Zestaw z -15 % obniża każdą linię o 15 %.

Rabat na produkt

Każdy składnik ma własny rabat, procentowy lub kwotowy. To tryb ofert typu urządzenie plus gratisowy materiał: urządzenie z 0 %, materiał ze 100 %.

Cena stała

Ogłaszasz cenę zestawu, brutto w walucie domyślnej. Różnica między sumą cen bieżących a ceną ogłoszoną jest rozkładana proporcjonalnie na każdą linię, netto. Każdy produkt zachowuje swoją stawkę VAT.

Przykład: zestaw za 49 € złożony z produktu A za 40 € i produktu B za 30 €. Bieżąca suma to 70 €, rabat 21 €. A przejmuje 12 € rabatu, B 9 €, proporcjonalnie do udziału w sumie. Faktura pozostaje dokładna nawet jeśli A ma 23 % VAT, a B 8 %.

Blok na kartach produktów

Każdy produkt należący do zestawu wyświetla blok „ten produkt jest też dostępny w zestawie”. Każda karta pokazuje miniatury składników, nazwę zestawu, przekreśloną sumę, cenę zestawu, znaczek oszczędności i stan magazynowy.

• Zobacz zestaw otwiera stronę zestawu.
• Dodaj dodaje zestaw bezpośrednio do koszyka w konfiguracji domyślnej. Przycisk zmienia się w Konfiguruj, gdy zestaw zawiera wybory: wolny wariant, składnik opcjonalny lub edytowalną ilość.

Pozycję bloku, liczbę kart i ich sortowanie ustawia się w konfiguracji modułu.

Strona zestawu

Każdy zestaw ma swoją stronę pod adresem /pack/12-moj-alias, z identyfikatorem zestawu i aliasem bieżącego języka. Strona wyświetla składniki z selektorami wariantów, polami wyboru produktów opcjonalnych i polami ilości, gdy są otwarte.

Każda zmiana przelicza w Ajax cenę całkowitą, cenę zestawu, oszczędność i dostępność, bez przeładowania strony. Przycisk dodania wysyła bieżący wybór do koszyka.

Dostępność jest liczona z realnych stanów: zestaw jest sprzedawalny, gdy każdy wymagany składnik jest dostępny w żądanej ilości, z uwzględnieniem zezwoleń na zamawianie bez stanu każdego produktu.

Koszyk

Przy dodaniu zestawu każdy składnik staje się prawdziwą linią koszyka, fakturowaną w cenie pakietowej poprzez cenę specyficzną ograniczoną do tego koszyka. Nie powstaje żaden produkt widmo.

Znaczek zestawu

Każda linia należąca do zestawu pokazuje znaczek z nazwą zestawu, linkiem do jego strony i przyciskiem Usuń cały zestaw. Usunięcie kasuje wszystkie linie zestawu i ich rabaty jedną akcją.

Dodatkowe ilości

Cena pakietowa obejmuje tylko ilości zestawu. Jeśli klient zwiększy ilość linii, moduł stosuje średnią ważoną cenę jednostkową: ilość zestawu w cenie pakietowej, nadwyżka w cenie regularnej.

Przykład: zestaw 2 sztuk po 8 € przy cenie regularnej 10 €. Klient zwiększa linię do 5 sztuk. Cena jednostkowa wynosi (2 x 8 + 3 x 10) / 5 = 9,20 €, razem 46 €. Rabat pozostaje ograniczony do 2 sztuk zestawu.

Tryb ścisły

Włączony, skasowanie składnika usuwa cały zestaw i jego rabat. To uniemożliwia zachowanie rabatu przy zwrocie części pakietu. Wyłączony, usunięcie jest akceptowane, a rabat zachowany na pozostałych liniach.

Zamówienia i księgowość

Każdy produkt zestawu trafia na własną linię zamówienia, w cenie pakietowej. Faktury, dokumenty dostawy, korekty i zwroty częściowe działają natywnie, pozycja po pozycji. Eksporty księgowe i ERP widzą tylko realne referencje z katalogu.

Szczegóły każdego zamówienia w back office pokazują podsumowanie zamówionych zestawów. Lista zestawów pokazuje licznik sprzedaży per zestaw.

Multistore i wielojęzyczność

Każdy zestaw jest przypisany do sklepów kontekstu utworzenia i może być zarządzany sklep po sklepie. Pola Nazwa, Alias URL, Opis i Znaczek są tłumaczone na zainstalowane języki. Front podąża za językiem klienta, łącznie z aliasem strony zestawu.

Dostosowanie wyświetlania do motywu

Trzy szablony można nadpisać. Skopiuj je z /modules/dfpackpro/views/templates/ do /themes/twoj-motyw/modules/dfpackpro/views/templates/ zachowując podkatalogi.

• hook/product_packs.tpl: blok cross-sell kart produktów
• front/pack.tpl: strona zestawu
• hook/cart_line_badge.tpl: znaczek zestawu w koszyku

CSS jest izolowany pod prefiksem dfpackpro, a kolor akcentu niesie zmienna CSS --dfpackpro-accent. Dla drobnej korekty celuj w klasy z arkusza stylów motywu zamiast edytować views/css/front.css, który zostałby nadpisany przy aktualizacji.

Rozwiązywanie problemów

Blok nie pojawia się na karcie produktu

1. Sprawdź, czy zestaw jest aktywny i czy dzisiejsza data mieści się w okresie ważności.
2. Sprawdź, czy oglądany produkt faktycznie należy do składników zestawu.
3. Skontroluj ustawienie Blok zestawów aktywny i wybraną pozycję w konfiguracji.
4. Wyczyść cache Smarty i cache serwera.

Zestaw pokazuje się jako niedostępny

Dostępność to minimum stanów wymaganych składników podzielonych przez ich ilość w zestawie. Jeden wyczerpany składnik bez zezwolenia na zamawianie bez stanu wystarczy, aby zestaw był niedostępny. Odznaczone składniki opcjonalne się nie liczą.

Znaczek w koszyku pojawia się w złym miejscu

Motyw renderuje znaczek w kolumnie akcji, potem JavaScript przenosi go do bloku informacji o produkcie. W mocno spersonalizowanym motywie bez standardowych kontenerów znaczek pozostaje na pierwotnej pozycji. Nadpisz cart_line_badge.tpl, aby dopasować go do swojej struktury.

Cena pakietowa stosuje się do zbyt wielu sztuk

Ten przypadek pokrywa średnia ważona cena: sprawdź cenę jednostkową na linii, musi mieścić się między ceną pakietową a regularną, gdy ilość przekracza tę z zestawu. Jeśli tak nie jest, wyczyść cache i zmień ilość, aby wymusić przeliczenie.

Strona zestawu zwraca 404

Sprawdź, czy zestaw jest aktywny i w okresie ważności. Po zmianie aliasu stary adres przekierowuje 301 na nowy, o ile identyfikator zestawu jest poprawny.

Odinstalowanie

Odinstalowanie usuwa sześć tabel modułu, jego klucze konfiguracji i zakładkę menu Katalog. Złożone zamówienia zachowują swoje linie i ceny, historia księgowa nie jest zmieniana.