Instrukcja krok po kroku

Od instalacji do szybkiego koszyka na liście produktów

GrowQty ma jeden ekran konfiguracji. Ustawiasz ilość, koszyk, stan, zakres i wygląd, a podgląd pokazuje efekt na produkcie pobranym z Twojego sklepu.

Krok 1

Pierwsze uruchomienie

  1. Zainstaluj GrowQty z Shoper App Store i zaakceptuj uprawnienia do odczytu produktów, wariantów oraz kategorii.
  2. Otwórz aplikację z panelu Shoper. Pulpit pokaże stan działania, liczbę produktów i ostatnią synchronizację.
  3. Wybierz Otwórz konfigurację. Po prawej stronie zobaczysz podgląd produktu pobranego ze sklepu.
Pierwsze pobranie danych produktów może potrwać kilka minut. Nie musisz pozostawiać aplikacji otwartej. Synchronizacja ponawia się automatycznie.
Konfiguracja GrowQty z podglądem produktu i przyciskiem Zapisz i opublikuj
Podgląd reaguje od razu, a panel po prawej jasno pokazuje, czy sklep używa już tych ustawień.
Krok 2

Włącz szybki zakup na listach produktów

Przełącznik Włącz szybki zakup na listach produktów steruje całym szybkim zakupem GrowQty. Domyślnie pozostaje wyłączony, więc możesz najpierw przygotować konfigurację i sprawdzić podgląd.

Po włączeniu GrowQty działa na obsługiwanych kafelkach kategorii, list, bestsellerów i innych sekcji produktowych. Nie zastępuje głównego formularza zakupu na karcie produktu.

Natywny przycisk koszyka znika dopiero po poprawnym zamontowaniu kontrolki GrowQty. Gdy aplikacja jest wyłączona, konfiguracja jest niedostępna albo produkt nie może być bezpiecznie obsłużony, sklep zachowuje natywne działanie.
Krok 3

Wybierz sposób zmiany ilości

W sekcji Zmiana ilości są trzy tryby:

TrybCo widzi klient
Przyciski i poleMinus, edytowalna liczba oraz plus. Najbardziej elastyczny wariant.
Tylko - / +Minus, bieżąca liczba i plus. Klient nie wpisuje wartości ręcznie.
Tylko poleJedno pole liczbowe bez dodatkowych przycisków.

Krok, minimum i maksimum

  • Zmiana o określa skok, np. 6 dla produktów sprzedawanych po sześć sztuk.
  • Minimum jest pierwszą dostępną ilością.
  • Maksimum ogranicza liczbę sztuk w jednym dodaniu do koszyka.

GrowQty dopasowuje wpisaną wartość do poprawnej wielokrotności kroku i nie pozwala wyjść poza ustawione granice.

Krok 4

Ustaw działanie koszyka i wariantów

Tekst przycisku pozwala dopasować komunikat do języka sklepu. Pusta wartość używa domyślnego „Dodaj do koszyka”. Na bardzo wąskich kafelkach domyślna etykieta skraca się wizualnie do „Dodaj”, ale pełny opis pozostaje dostępny dla czytnika ekranu.

Po udanym dodaniu

  • Małe potwierdzenie pokazuje krótki komunikat na ekranie.
  • Otwórz mini-koszyk pozostawia potwierdzenie natywnemu mechanizmowi sklepu.
  • Bez komunikatu aktualizuje koszyk bez dodatkowej warstwy wizualnej.

Wariant na kafelku

Włącz Pozwól wybrać wariant na kafelku, aby klient mógł wskazać dostępny rozmiar lub kolor bez otwierania produktu. Jeżeli aplikacja nie ma kompletnego wariantu do bezpiecznego dodania, prowadzi na kartę produktu zamiast zgadywać.

Krok 5

Kontroluj ilość według stanu magazynowego

Opcja Ogranicz ilość do ostatnio pobranego stanu zmniejsza maksimum do liczby dostępnych sztuk produktu lub wybranego wariantu. Dane odświeżają się automatycznie mniej więcej co 15 minut.

Możesz dodatkowo włączyć komunikat Ostatnie X szt. i ustawić próg, np. 5. Komunikat pojawi się wyłącznie przy dodatnim, znanym stanie nieprzekraczającym progu.

Stan w panelu pomaga klientowi wybrać poprawną ilość, ale ostateczną dostępność przy dodaniu zawsze weryfikuje Shoper. To chroni sklep przy zakupach wykonywanych równocześnie.
Krok 6

Wybierz produkty objęte aplikacją

W sekcji Gdzie pokazać wybierz:

  • Wszystkie produkty, aby włączyć GrowQty na wszystkich obsługiwanych listach produktów.
  • Wybrane kategorie, aby zaznaczyć kategorie po czytelnej nazwie.

Pole Produkty wykluczone wyszukuje po nazwie. Zaznaczony produkt nie otrzyma kontrolki nawet wtedy, gdy należy do wybranej kategorii.

Jeżeli nowego produktu lub kategorii nie ma na liście, użyj Odśwież dane produktów w dolnej części ekranu. Znak ? obok przycisku wyjaśnia, że ta czynność tylko pobiera aktualne dane i niczego nie zmienia w produktach Shopera.

Krok 7

Dopasuj wygląd i sprawdź podgląd

  • Położenie na kafelku: pod ceną, pod nazwą albo na dole kafelka.
  • Kolor przycisku: akcent głównej akcji.
  • Tło ilości: tło pola i przycisków minus/plus.
  • Przycisk: pełny, konturowy lub delikatny.

Podgląd korzysta z produktu pobranego z Twojego sklepu i zmienia się od razu podczas edycji. Samo strojenie niczego nie zmienia na listach produktów. Bursztynowy komunikat Masz niezapisane zmiany oznacza, że sklep nadal używa poprzedniej wersji.

Dopiero przycisk Zapisz i opublikuj zapisuje całą konfigurację oraz udostępnia ją klientom. Znak ? obok podaje dokładny skutek tej akcji, a podczas publikacji przycisk pokazuje lokalny stan pracy. Po sukcesie panel wraca do komunikatu Wszystko opublikowane.

Jeżeli zamkniesz kartę z niezapisanymi zmianami, przeglądarka poprosi o potwierdzenie. Dzięki temu można bezpiecznie porównać kilka ustawień w podglądzie i opublikować dopiero wybrany wariant.
Zakres produktów, wykluczenia i podgląd na żywo w GrowQty
Kategorie i wykluczenia wybierasz po nazwach, cały czas widząc ten sam podgląd i stan publikacji.
Krok 8

Jak GrowQty działa na RWD i Storefront

  • RWD / Modern 3.0: kontrolka używa natywnego `frontAPI` i identyfikatora stanu dostępnego na kafelku.
  • Storefront / Modern 3.1: kontrolka używa `basketUpdaterApi`, reaguje na dynamiczną nawigację i ponownie montowane karuzele.

Nie dodawaj ręcznie drugiego skryptu aplikacji. Instalacja App Store dostarcza właściwy loader dla technologii sklepu.

GrowQty na liście bestsellerów Shoper Storefront
Storefront: GrowQty zastępuje tylko działające akcje zakupu, a produkty niedostępne zachowują własny komunikat.

Gdy kontrolki nie widać

  1. Sprawdź główny przełącznik i aktywny plan lub trial.
  2. Sprawdź wybrane kategorie oraz listę produktów wykluczonych.
  3. Odśwież dane produktów, wybierz Zapisz i opublikuj i odczekaj do 30 sekund.
  4. Sprawdź, czy produkt jest dostępny i ma wariant możliwy do dodania.
  5. Jeżeli problem pozostaje, prześlij adres listy produktów i informację RWD/Storefront do wsparcia.
Krok 9

Plan, wyłączenie i wsparcie

Pełny trial trwa 14 dni od pierwszej instalacji. Później GrowQty kosztuje 29 zł netto miesięcznie albo 290 zł netto rocznie. Planem i rezygnacją zarządzasz w Shoper App Store.

Wyłączenie głównego przełącznika zachowuje konfigurację i przywraca natywne akcje sklepu. Odinstalowanie wyłącza elementy GrowQty oraz usuwa ustawienia i lokalnie pobrane dane produktów przypisane do sklepu.

Wsparcie po polsku: support@app.growcommerce.pl. W zgłoszeniu podaj domenę sklepu, technologię RWD/Storefront, adres strony oraz krótki opis kroków.