MOQ Limits for WooCommerce

Wymagania

MOQ Limits for WooCommerce pozwala ustawić minimalne i maksymalne limity zamówień w sklepie WooCommerce. Wtyczka sprawdza koszyk oraz checkout i blokuje złożenie zamówienia, jeśli nie spełnia ono skonfigurowanych reguł.

Do działania wtyczki wymagane są:

• WordPress 5.0 lub nowszy
• WooCommerce 3.0 lub nowszy
• PHP 7.4 lub nowszy
• aktywna wtyczka WooCommerce
• dostęp administratora lub użytkownika z uprawnieniem do zarządzania WooCommerce

Wtyczka nie wymaga konta zewnętrznego, klucza API ani połączenia z usługami zewnętrznymi.

Jeśli WooCommerce nie jest aktywne, ustawienia i logika limitów nie będą dostępne. Przed konfiguracją upewnij się, że WooCommerce jest zainstalowane i włączone.

Instalacja

1. Przejdź w panelu WordPress do Wtyczki → Dodaj nową.
2. Kliknij Wyślij wtyczkę na serwer.
3. Wybierz plik ZIP z wtyczką.
4. Kliknij Zainstaluj teraz.
5. Po instalacji kliknij Włącz wtyczkę.
6. Przejdź do WooCommerce → MOQ Limits.

Po aktywacji możesz od razu rozpocząć konfigurację limitów. Wtyczka nie wymaga dodatkowego kreatora startowego ani importu danych.

WooCommerce → MOQ Limits

Wszystkie ustawienia wtyczki znajdują się w jednym ekranie administracyjnym: WooCommerce → MOQ Limits.

Na tym ekranie możesz skonfigurować:

• Język komunikatów
• Globalną minimalną i maksymalną kwotę zamówienia
• Limity ilości produktu
• Limity ilości kategorii
• Regionalne limity kwoty zamówienia

Po zmianie ustawień zapisz konfigurację, aby limity zaczęły działać w koszyku i na checkout.

Język komunikatów

Język komunikatów określa język informacji wyświetlanych klientowi, gdy koszyk nie spełnia limitów.

Dostępne wartości:

• Polski
• Angielski

Aby zmienić język komunikatów:

1. Przejdź do WooCommerce → MOQ Limits.
2. Wybierz język komunikatów.
3. Kliknij Zapisz zmiany.

Wybrany język dotyczy komunikatów widocznych dla klienta w koszyku i na stronie finalizacji zamówienia.

Globalna minimalna i maksymalna kwota zamówienia

Globalna minimalna i maksymalna kwota zamówienia pozwala ustawić ogólny limit wartości koszyka dla całego sklepu.

Możesz skonfigurować:

• Minimalną kwotę zamówienia — klient nie złoży zamówienia poniżej tej wartości.
• Maksymalną kwotę zamówienia — klient nie złoży zamówienia powyżej tej wartości.

Każde pole jest opcjonalne. Jeśli zostawisz pole puste, dany limit nie będzie używany.

Aby ustawić globalny limit kwoty:

1. Przejdź do WooCommerce → MOQ Limits.
2. W sekcji Globalna minimalna i maksymalna kwota zamówienia wpisz wartość minimalną lub maksymalną.
3. Zapisz ustawienia.
4. Dodaj produkty do koszyka i sprawdź, czy reguła działa poprawnie.

Limit jest porównywany z wartością produktów w koszyku, bez kosztów wysyłki, podatków i dodatkowych opłat.

Limity ilości produktu

Limity ilości produktu pozwalają ustawić minimalną lub maksymalną liczbę sztuk konkretnego produktu w koszyku.

Dla każdego produktu możesz ustawić:

• Minimum — najmniejszą liczbę sztuk, jaką klient musi kupić.
• Maksimum — największą liczbę sztuk, jaką klient może kupić.

Aby dodać limit produktu:

1. Przejdź do sekcji Limity ilości produktu.
2. Dodaj nowy wiersz reguły.
3. Wybierz produkt WooCommerce.
4. Wpisz wartość w polu Minimum lub Maksimum.
5. Zapisz ustawienia.

Jeśli ustawisz tylko Minimum, klient będzie mógł kupić więcej sztuk, ale nie mniej niż wskazana wartość.

Jeśli ustawisz tylko Maksimum, klient będzie mógł kupić mniej sztuk, ale nie więcej niż wskazana wartość.

Jeśli ustawisz oba pola, klient musi zmieścić się w określonym zakresie.

Limity produktu działają także dla wariantów produktu. Jeśli limit jest ustawiony dla produktu nadrzędnego, obejmuje również jego warianty.

Limity ilości kategorii

Limity ilości kategorii pozwalają kontrolować łączną liczbę produktów z danej kategorii w koszyku.

To oznacza, że limit nie dotyczy jednego produktu, ale sumy wszystkich produktów należących do wybranej kategorii.

Dla kategorii możesz ustawić:

• Minimum — minimalną łączną liczbę produktów z kategorii.
• Maksimum — maksymalną łączną liczbę produktów z kategorii.

Aby dodać limit kategorii:

1. Przejdź do sekcji Limity ilości kategorii.
2. Dodaj nową regułę.
3. Wybierz kategorię WooCommerce.
4. Wpisz wartość w polu Minimum lub Maksimum.
5. Zapisz ustawienia.

Przykład: jeśli ustawisz Minimum dla kategorii na 5, klient może kupić 2 sztuki jednego produktu i 3 sztuki innego produktu z tej samej kategorii. Razem daje to 5 sztuk, więc limit zostanie spełniony.

Regionalne limity kwoty zamówienia

Regionalne limity kwoty zamówienia pozwalają ustawić inną minimalną lub maksymalną wartość zamówienia dla wybranego kraju, regionu lub kodu pocztowego.

Reguła regionalna może uwzględniać:

• Kraj
• Stan / województwo
• Kod pocztowy
• Minimalną kwotę zamówienia
• Maksymalną kwotę zamówienia

Aby dodać regionalny limit zamówienia:

1. Przejdź do sekcji Regionalne limity kwoty zamówienia.
2. Dodaj nową regułę.
3. Wybierz kraj.
4. Opcjonalnie wybierz stan lub województwo.
5. Opcjonalnie wpisz kod pocztowy lub początek kodu pocztowego.
6. Wpisz minimalną lub maksymalną kwotę zamówienia.
7. Zapisz ustawienia.

Wtyczka sprawdza najpierw adres wysyłki klienta. Jeśli adres wysyłki nie jest dostępny, używa adresu rozliczeniowego.

Kod pocztowy działa jako prefiks. Oznacza to, że wpisanie części kodu pozwala objąć większy obszar.

Reguły regionalne mają pierwszeństwo przed globalnymi limitami kwoty zamówienia. Jeśli klient pasuje do reguły regionalnej, to właśnie ta reguła decyduje o limicie.

Kolejność sprawdzania limitów

Wtyczka sprawdza limity w określonej kolejności. Dzięki temu reguły bardziej szczegółowe mogą mieć pierwszeństwo przed ogólnymi.

Kolejność walidacji:

1. Regionalne limity kwoty zamówienia
2. Globalna minimalna kwota zamówienia
3. Globalna maksymalna kwota zamówienia
4. Limity ilości produktu
5. Limity ilości kategorii

Jeżeli koszyk nie spełnia którejś reguły, klient zobaczy komunikat błędu WooCommerce i nie będzie mógł złożyć zamówienia.

Komunikaty w koszyku i checkout

Komunikaty w koszyku i checkout informują klienta, dlaczego zamówienie nie może zostać złożone.

Komunikaty mogą dotyczyć między innymi:

• zbyt niskiej wartości zamówienia,
• zbyt wysokiej wartości zamówienia,
• zbyt małej liczby sztuk produktu,
• zbyt dużej liczby sztuk produktu,
• zbyt małej łącznej liczby produktów z kategorii,
• zbyt dużej łącznej liczby produktów z kategorii,
• regionalnego minimum lub maksimum zamówienia.

Komunikaty są wyświetlane w standardowym miejscu powiadomień WooCommerce, dlatego wyglądają spójnie z motywem sklepu i pozostałymi komunikatami checkout.

Jak działa wtyczka przy zakupie

MOQ Limits for WooCommerce sprawdza koszyk automatycznie podczas korzystania ze sklepu. Klient nie musi wykonywać żadnych dodatkowych działań.

Logika działania:

1. Klient dodaje produkty do koszyka.
2. Wtyczka sprawdza ustawione limity.
3. Jeśli koszyk spełnia reguły, klient może przejść dalej.
4. Jeśli koszyk nie spełnia reguł, wtyczka wyświetla komunikat błędu.
5. Klient poprawia ilości produktów lub wartość koszyka.
6. Po spełnieniu limitów checkout zostaje odblokowany.

Walidacja działa w koszyku i na checkout, zarówno przy klasycznym układzie WooCommerce, jak i przy blokach Koszyka i Checkoutu.

Bloki WooCommerce i HPOS

MOQ Limits for WooCommerce jest przygotowana do działania z nowoczesnymi funkcjami WooCommerce.

Wtyczka obsługuje:

• HPOS — High-Performance Order Storage, czyli niestandardowe tabele zamówień WooCommerce.
• Bloki Koszyka i Checkoutu — limity ilości produktu są respektowane także w blokowym koszyku i checkout.
• Klasyczny koszyk i checkout — walidacja działa również przy tradycyjnych shortcode WooCommerce.

Przechowywanie danych

MOQ Limits for WooCommerce zapisuje konfigurację lokalnie w WordPressie. Wtyczka nie wysyła ustawień do zewnętrznych usług.

W ustawieniach zapisywane są:

• język komunikatów,
• globalna minimalna kwota zamówienia,
• globalna maksymalna kwota zamówienia,
• limity ilości produktów,
• limity ilości kategorii,
• regionalne limity kwoty zamówienia.

Dane adresowe klienta są używane tylko do sprawdzenia, czy pasuje do reguły regionalnej. Wtyczka nie wysyła tych danych poza sklep.

Rozwiązywanie problemów

Nie widzę menu MOQ Limits

Sprawdź, czy WooCommerce jest aktywne oraz czy Twoje konto ma uprawnienia do zarządzania WooCommerce.

Limit nie blokuje zamówienia

Sprawdź, czy ustawienia zostały zapisane oraz czy koszyk rzeczywiście narusza wybraną regułę.

Limit regionalny nie działa

Sprawdź kraj, stan lub województwo oraz kod pocztowy klienta. Pamiętaj, że wtyczka najpierw sprawdza adres wysyłki, a dopiero potem adres rozliczeniowy.

Limit kategorii działa inaczej niż oczekuję

Limit kategorii sumuje wszystkie produkty z danej kategorii. Nie dotyczy osobno każdego produktu.

Limit produktu nie działa dla wariantu

Sprawdź, czy limit jest ustawiony dla produktu nadrzędnego. Warianty są uwzględniane przez regułę produktu nadrzędnego.