Przyciski +/- ilości: kompletny przewodnik
Zainstaluj, skonfiguruj i dostosuj przyciski + oraz − ilości na karcie produktu PrestaShop 8 i 9: styl, kolory, zgodność z motywem Classic i działanie bez nadpisywania szablonów.
Prezentacja
Moduł Przyciski +/- ilości dodaje prawdziwe przyciski + i − po obu stronach pola ilości na karcie produktu. Zastępuje małe natywne pole liczbowe PrestaShop, niewygodne zarówno przy obsłudze klawiaturą, jak i palcem na urządzeniach mobilnych, dwoma szerokimi przyciskami, w które łatwo trafić.
Moduł nie modyfikuje żadnego pliku motywu: dodaje lekki arkusz stylów i skrypt, wyłącznie na karcie produktu, które opakowują istniejące pole ilości. Jest zgodny z PrestaShop 1.7, 8 i 9, zarówno z motywem Classic, jak i z większością motywów własnych.
Instalacja
- W panelu administracyjnym otwórz Moduły > Menedżer modułów.
- Kliknij Wgraj moduł i przeciągnij archiwum ZIP modułu.
- Po zakończeniu instalacji kliknij Konfiguruj (opcjonalnie: moduł działa z ustawieniami domyślnymi od razu po instalacji).
Nie jest tworzona żadna tabela SQL i nie jest modyfikowany żaden plik motywu. Moduł rejestruje jedynie hook, który ładuje jego zasoby na karcie produktu.
Konfiguracja
Strona konfiguracji zawiera cztery ustawienia. Wszystkie są opcjonalne: domyślnie przyciski są aktywne, w stylu kwadratowym, z ukrytymi natywnymi strzałkami.
Włącz przyciski
Przełącznik Włącz przyciski steruje globalnym wyświetlaniem. Wyłącz go, aby tymczasowo ukryć przyciski bez odinstalowywania modułu: karta produktu wraca wtedy do oryginalnego pola ilości.
Styl przycisków
Wybierz wygląd przycisków:
- Kwadratowy: przyciski + i − mają lekko zaokrąglone narożniki na końcach grupy (styl domyślny).
- Zaokrąglony: przyciski przyjmują kształt pigułki, z całkowicie zaokrąglonymi końcami.
Kolor tła i kolor ikon
Dwa selektory kolorów pozwalają dostosować:
- kolor tła przycisków (domyślnie jasnoszary);
- kolor ikon + i − (domyślnie ciemnoszary).
Efekt najechania kursorem jest wyprowadzany automatycznie z koloru tła, nie ma więc trzeciego ustawienia do obsługi. Kolory są stosowane poprzez zmienne CSS, co zapewnia czystą integrację z większością motywów.
Ukryj natywne strzałki pola liczbowego
Gdy ta opcja jest włączona (zalecane), małe pionowe strzałki pola liczbowego przeglądarki są ukrywane, tak aby pozostały wyłącznie przyciski + i − modułu. Wyłącz ją, jeśli wolisz zachować widoczne natywne strzałki.
Po stronie klienta
Na karcie produktu klient widzi przycisk − po lewej stronie pola ilości i przycisk + po prawej. Każde kliknięcie zwiększa lub zmniejsza ilość o jeden krok, a następnie aktualizuje cenę, ewentualne warianty i przycisk dodania do koszyka, dokładnie tak jak przy ręcznym wpisaniu wartości. Ilość pozostaje oczywiście edytowalna bezpośrednio z klawiatury w polu.
Działanie i zgodność
Brak nadpisywania szablonów
Moduł nie nadpisuje żadnego pliku motywu. Odnajduje standardowe pole ilości na karcie produktu i opakowuje je przez wstrzyknięcie JavaScript, aby dodać przyciski. Takie podejście zapewnia zgodność z szerokim wachlarzem motywów i chroni moduł przed skutkami aktualizacji PrestaShop, ponieważ żaden szablon nie jest nadpisywany.
Motyw Classic i bootstrap-touchspin
Motyw Classic wzbogaca już pole ilości o bootstrap-touchspin, który dodaje dwie małe pionowe strzałki. Moduł czysto neutralizuje te strzałki wewnątrz własnej grupy przycisków, aby pozostawić wyłącznie czytelne + i −, bez duplikatów i bez przesunięć układu.
Synchronizacja z koszykiem
Przy każdym kliknięciu moduł stosuje nową wartość, a następnie wyzwala zdarzenia oczekiwane przez PrestaShop, zarówno natywne, jak i jQuery. Cena całkowita, warianty i przycisk dodania do koszyka reagują normalnie. Po zmianie wariantu, która przebudowuje blok ilości, przyciski są automatycznie wstrzykiwane ponownie.
Poszanowanie stanu magazynowego i ograniczeń
Przyciski odczytują ilość minimalną, ilość maksymalną oraz krok zdefiniowany na polu. Klient nie może zejść poniżej wymaganego minimum (często 1) ani przekroczyć dostępnego stanu magazynowego, gdy jest on ograniczony. Zachowanie pozostaje spójne z regułami sklepu.
Rozwiązywanie problemów
Przyciski nie pojawiają się na karcie produktu
Sprawdź, czy moduł jest włączony i czy opcja Włącz przyciski jest ustawiona na Tak. Następnie wyczyść pamięć podręczną PrestaShop (Parametry zaawansowane > Wydajność) i przeładuj kartę produktu. Jeśli Twój motyw używa mocno zmodyfikowanego pola ilości, moduł może go nie wykryć. Skontaktuj się wtedy ze wsparciem, podając nazwę motywu.
Natywne strzałki motywu Classic pozostają widoczne
Upewnij się, że używasz wersji 1.1.0 lub wyższej, która neutralizuje strzałki bootstrap-touchspin, a następnie wyczyść pamięć podręczną. Sprawdź również, czy żadne nadpisanie CSS w Twoim motywie nie przywraca tych strzałek.
Ilość się zmienia, ale cena nie jest aktualizowana
To zachowanie wynika zwykle z motywu, który nie korzysta ze standardowych zdarzeń PrestaShop. Moduł wyzwala zdarzenia natywne i jQuery. Jeśli motyw nasłuchuje innego mechanizmu, skontaktuj się ze wsparciem, wskazując używany motyw.
Deinstalacja
Odinstalowanie modułu usuwa jego zasoby z karty produktu oraz kasuje konfigurację. Pole ilości wraca do pierwotnego wyglądu. Żadne dane produktów ani zamówień nie są naruszane.
FAQ
Czy moduł modyfikuje mój motyw?
Nie. Nie nadpisuje żadnego pliku motywu: dodaje arkusz stylów i skrypt wyłącznie na karcie produktu, które opakowują istniejące pole ilości.
Czy mogę zmienić kolor przycisków?
Tak. Konfiguracja pozwala ustawić kolor tła oraz kolor ikon + i −, a także styl kwadratowy lub zaokrąglony. Efekt najechania kursorem jest wyprowadzany automatycznie z koloru tła.
Czy moduł jest zgodny z PrestaShop 9?
Tak, moduł jest zgodny z PrestaShop 1.7, 8.x i 9.x, zarówno w trybie jednego sklepu, jak i multisklepu.