configure(config) ustawia sposób działania koszyka. To wywołanie konfiguracyjne, więc jest bezpieczne na samej górze Twojego skryptu, zanim koszyk się załaduje.
Kontroluje, czy drawer otwiera się, gdy klient dodaje produkt.
Jeśli po prostu chcesz to włączyć dla całego sklepu, to już jest ustawienie: Cart settings → Content → Behavior → Open cart when an item is added. Użyj
configure, gdy odpowiedź zależy od strony, klienta lub czegoś, co zna tylko Twój kod.true, aby otwierać drawer także przy dodaniach w tle — takich, które Aftersell wykrył, ale sam nie obsłużył.
Dodanie liczy się jako dodanie w tle, gdy:
- przyszło przez standardowe zdarzenia koszyka Shopify (zawsze traktowane jako tło, niezależnie od tego, co je wywołało), lub
- Aftersell zobaczył żądanie koszyka w sieci bez zaufanego kliknięcia lub naciśnięcia klawisza w poprzedzających ~3 sekundach — np. inna aplikacja lub skrypt zapisujący do koszyka.
open_on_add_to_cart, bez potrzeby tej opcji.
open_on_add_to_cart również by na to pozwoliło. Przy open_on_add_to_cart: 'never' ta opcja nic nie robi.
Uruchamia natywną walidację formularza przeglądarki (reportValidity()) przed dodaniem i anuluje dodanie, jeśli formularz jest nieprawidłowy. Użyj tego, gdy formularz produktu ma wymagane pola (tekst graweru, notatka do prezentu, wymagany checkbox), które klienci mogą obecnie pomijać.
required gdzieś w formularzu produktu zacząłby inaczej po cichu blokować add-to-cart.
Całkowicie wyłącza przechwytywanie add-to-cart przez Aftersell. Aby dowiedzieć się, co robi przechwytywanie i jakie są wszystkie sposoby, by z niego zrezygnować, zobacz Przechwytywanie add-to-cart.
Motyw wykonuje wtedy dodanie samodzielnie, a każdy skrypt nasłuchujący na tym submicie znów się uruchamia. Aftersell nadal śledzi żądanie koszyka w sieci, więc drawer otwiera się jak zwykle. Rezygnując z przechwytywania, nie tracisz tego. Na motywach, które Aftersell rozpoznaje, jego własny koszyk pozostaje bezczynny, więc nie zobaczysz dwóch koszyków. Na motywie, którego Aftersell nie rozpoznaje, motyw może otworzyć swój koszyk obok Twojego; zobacz Czy otworzy się też koszyk motywu?.
registerSkipAddToCartRule:
true, aby przestać wyciszać kliknięcie:
/cart.
W przeciwieństwie do skip_add_to_cart_interceptor ta opcja jest odczytywana przy każdym kliknięciu, więc możesz ją ustawić w dowolnym momencie i zadziała natychmiast: z ready(), z handlera zdarzenia lub warunkowo per strona.
Niektóre motywy również reagują na kliknięcie ikony koszyka samodzielnie. Gdy Aftersell przestanie je wyciszać, motyw, który otwiera własny drawer, zrobi to obok Twojego. Jeśli po włączeniu tej opcji widzisz dwa koszyki, dodaj klasę
aftersell-cart-wont-open-cart do ikony motywu i otwieraj koszyk z własnego handlera przy pomocy actions.open().formatMoney. Domyślnie to format Twojego sklepu; jeśli jest niedostępny, ceny wracają do $X.XX.
configure scala wartości, a formatMoney odczytuje bieżącą wartość, możesz zmieniać format w czasie działania, np. gdy zadziała przełącznik waluty:
To zmienia sposób, w jaki SDK i koszyk wyświetlają ceny. Nie zmienia waluty, w której klient jest obciążany; za to odpowiada Shopify Markets.
- Akcje: odczytuj i zmieniaj koszyk.
- Hooki: kontrola per formularz i per pozycja, gdy
configurejest zbyt szerokie. - Przypadki użycia: kompletne rozwiązania typowych potrzeb.