Minimalna ilość i sprzedaż w wielokrotnościach: dokumentacja DataFirefly Minimums

Instalacja

Zainstaluj moduł w Moduły > Menedżer modułów > Załaduj moduł za pomocą pliku ZIP albo skopiuj folder dfminimums do katalogu /modules/ sklepu i kliknij Instaluj.

Podczas instalacji moduł tworzy dwie tabele (reguły ilościowe i minima zamówienia), rejestruje swoje hooki i dodaje dwie zakładki w menu Katalog: Minima i wielokrotności oraz Minimalne zamówienie.

Ustawienia modułu

Strona konfiguracji modułu zawiera sześć ustawień.

Włącz reguły zakupu

Główny przełącznik. Po wyłączeniu żadna reguła nie jest wyświetlana ani stosowana w sklepie. Reguły pozostają zapisane.

Automatycznie dostosuj ilości

Gdy klient doda do koszyka ilość naruszającą regułę, moduł zastępuje ją najbliższą dozwoloną ilością: w górę przy dodawaniu, w dół przy usuwaniu. Dodanie 7 sztuk produktu sprzedawanego po 6 daje 12, zmiana z 12 na 11 daje 6. Pozycje personalizowane nigdy nie są zmieniane. Po wyłączeniu ilość pozostaje bez zmian, a koszyk jest zablokowany, dopóki klient jej nie poprawi.

Pokaż warunki na stronie produktu

Wyświetla pod przyciskiem dodania do koszyka ramkę z minimum, wielokrotnością i maksimum dla zalogowanego klienta. Ramka pojawia się także w szybkim podglądzie.

Pokaż etykietę na listach produktów

Dodaje krótką etykietę pod ceną miniatur produktów, na przykład „Sprzedaż po 6” lub „Min. 12”.

Pokaż warunki pod każdą pozycją koszyka

Przypomina warunek każdej pozycji i pokazuje błąd na czerwono, gdy ilość jest niedozwolona.

Klient w kilku grupach

Określa, które minimum zamówienia obowiązuje, gdy klient należy do kilku grup z własnym minimum: minimum jego grupy domyślnej, najwyższe lub najniższe.

Tworzenie reguły ilościowej

Otwórz Katalog > Minima i wielokrotności i kliknij Dodaj regułę.

Dotyczy

• Produkt: wyszukaj produkt po nazwie, indeksie, EAN lub ID, a następnie opcjonalnie wybierz kombinację. Reguła dla kombinacji ma pierwszeństwo przed regułą dla całego produktu.
• Kategoria: wybierz kategorię i określ, czy uwzględnić podkategorie. Obejmuje to wszystkie produkty przypisane do kategorii, niezależnie od ich kategorii domyślnej.
• Wszystkie produkty: reguła dotyczy całego katalogu.

Grupa klientów

Zostaw „Wszystkie grupy klientów” albo wybierz grupę. Reguła grupy dotyczy każdego klienta należącego do tej grupy, nawet jeśli nie jest to jego grupa domyślna.

Minimum, wielokrotność i maksimum

• Minimalna ilość: 0 lub 1 oznacza brak minimum. Jeśli ustawiono wielokrotność, a minimum nią nie jest, zostaje zaokrąglone w górę: minimum 10 po 6 daje 12.
• Sprzedaż w wielokrotnościach: 1 pozostawia dowolną ilość, 6 przyjmuje tylko 6, 12, 18 itd.
• Maksymalna ilość: 0 oznacza brak maksimum. Maksimum musi być wielokrotnością wybranej wielokrotności i być większe lub równe minimum.

Reguła musi ustawiać co najmniej minimum większe niż 1, wielokrotność większą niż 1 lub maksimum.

Która reguła obowiązuje

Dla każdego produktu w koszyku obowiązuje jedna reguła „na produkt”. Moduł wybiera ją w tej kolejności:

1. najwyższy priorytet;
2. przy równym priorytecie najbardziej szczegółowa reguła: kombinacja, potem produkt, potem kategoria (najgłębsza najpierw), potem wszystkie produkty;
3. przy równej szczegółowości reguła grupy klientów przed regułą dla wszystkich grup.

Przykład: reguła „Wina, sprzedaż po 6” dla wszystkich klientów i reguła „Wina, sprzedaż po 12” dla grupy Firmy. Klient firmowy zamawia po 12, klient detaliczny po 6.

Panel modułu w zakładce Moduły karty produktu wyświetla reguły dotyczące bezpośrednio produktu oraz reguły kategorii lub katalogu, które również mogą obowiązywać.

Dowolny mix w kategorii

W regule kategorii pole Sposób liczenia ma dwie wartości.

• Każdy produkt osobno: reguła dotyczy każdego produktu kategorii, jak reguła produktu.
• Wszystkie produkty kategorii razem (dowolny mix): minimum, wielokrotność i maksimum dotyczą sumy ilości wszystkich produktów kategorii w koszyku.

Przykład: minimum 12 i wielokrotność 6 w trybie dowolnego mixu w kategorii Wina. Klient może wziąć 4 czerwone, 4 białe i 4 różowe. Przy łącznie 13 butelkach koszyk jest zablokowany.

Reguły dowolnego mixu są sprawdzane dodatkowo obok reguły każdego produktu. Wino sprzedawane na sztuki nadal jest dostępne na sztuki, o ile suma kategorii spełnia regułę dowolnego mixu.

Minima zamówienia dla grup

Otwórz Katalog > Minimalne zamówienie i kliknij Dodaj minimum zamówienia.

• Grupa klientów: jedno minimum na grupę. Pozycja „Wszyscy klienci (domyślnie)” dotyczy klientów, których grupy nie mają własnego minimum.
• Kwota minimalna: podawana w domyślnej walucie sklepu, automatycznie przeliczana dla koszyków w innej walucie. Koszty wysyłki nigdy nie są wliczane.
• Kwota brutto: Nie porównuje kwotę z sumą produktów netto, co jest typowe w B2B.
• Odejmij kupony: Tak bierze sumę po regułach koszyka i kuponach.

Co widzi klient

Gdy koszyk narusza regułę, moduł wypełnia klucz minimalPurchaseRequired koszyka, którego PrestaShop używa dla własnej minimalnej kwoty. Przycisk zamówienia jest wyłączony, a natywny alert koszyka pokazuje „Twój koszyk nie spełnia jeszcze warunków zakupu.” oraz szczegóły każdego problemu: niedozwoloną ilość z możliwymi ilościami, sumę kategorii w trybie dowolnego mixu, brakującą kwotę do minimum zamówienia.

Kontrola jest powtarzana przy otwarciu strony zamówienia: klient, który próbuje wejść na nią bezpośrednio, wraca do koszyka.

W sklepie pola ilości stosują się do reguły. W motywie Classic przyciski TouchSpin przeskakują o wielokrotność. W Hummingbird przyciski +/- przechodzą od razu do następnej lub poprzedniej dozwolonej ilości.

Import i eksport CSV

Import znajduje się nad listą reguł. Plik akceptuje separator ; lub , i wymaga wiersza nagłówka z co najmniej kolumną scope. Rozpoznawane kolumny:

• name: nazwa wewnętrzna, generowana, gdy jest pusta;
• scope: product, category lub all;
• product_id lub product_reference;
• combination_reference: indeks kombinacji;
• category_id i include_subcategories (0 lub 1);
• apply_mode: per_product lub cumulative (dowolny mix);
• group_id: 0 dla wszystkich grup;
• min_qty, multiple, max_qty, priority, active.

Pole „Najpierw usuń wszystkie istniejące reguły tego sklepu” zastępuje cały zestaw reguł. Błędne wiersze są wymieniane z numerem i nie blokują pozostałych. Przycisk Eksportuj CSV tworzy ten sam format, przydatny do przenoszenia reguł między sklepami. Plik przykładowy można pobrać z bloku importu.

Dobre praktyki

• Zacznij od szerokiej reguły (kategoria lub katalog), a potem dodaj wyjątki dla produktów: najbardziej szczegółowa reguła wygrywa bez zmiany priorytetu.
• Używaj priorytetu tylko wtedy, gdy mniej szczegółowa reguła ma wygrać, na przykład reguła kategorii, która ma obowiązywać wszystkie jej produkty.
• Testuj na koncie klienta z każdej grupy: reguły grup nie są widoczne dla niezalogowanego gościa.
• Po zmianie wyczyść pamięć podręczną, jeśli sklep używa modułu cache całych stron.

Rozwiązywanie problemów

Klient nie może zejść poniżej pewnej ilości, choć żadna reguła tego nie wymaga

Sprawdź natywną minimalną ilość na karcie produktu (zakładka Stany magazynowe lub Ilości, zależnie od wersji) i ustaw ją z powrotem na 1.

Koszyk jest zablokowany natywnym komunikatem o minimalnej kwocie

To natywne minimum z Parametry sklepu > Ustawienia zamówień. Ustaw je na 0, jeśli mają się liczyć tylko minima dla grup.

Przyciski +/- zmieniają ilość o 1

Motyw nie używa standardowych selektorów Classic ani Hummingbird. Reguła nadal działa po stronie serwera: koszyk jest korygowany lub blokowany. Napisz do nas z nazwą motywu, aby go dostosować.

Moduł zamówienia na jednej stronie przepuszcza zamówienie

Zewnętrzny moduł ignoruje minimalPurchaseRequired. Przetestuj go na sklepie testowym i napisz do nas z jego nazwą.

Zgodność

• PrestaShop 8.0 do 9.x, ten sam ZIP dla obu gałęzi.
• Motywy Classic i Hummingbird.
• Multisklep: reguły i minima są zapisywane dla każdego sklepu.
• Architektura ModuleAdminController, bez zależności Composer, PHP 7.2 i nowszy.
• Interfejs w języku angielskim, francuskim, hiszpańskim, niemieckim, włoskim, niderlandzkim, polskim i portugalskim.