Przegląd
- Gdzie dodawać skrypty API Upcart?
- Czy muszę być programistą, aby korzystać z API Upcart?
- Czy API Upcart może integrować się z innymi aplikacjami firm trzecich?
- Jak sprawdzić, czy moje zmiany w API działają?
- Co zrobić, jeśli skrypt API nie działa?
- Jak cofnąć zmiany, jeśli dodam skrypt, który coś psuje?
Gdzie dodawać skrypty API Upcart?
Jak korzystać z Custom HTML w Upcart?
- Przejdź do Upcart → Settings → Custom HTML
- Używaj skryptów API, aby modyfikować zachowanie koszyka, np. moment otwarcia czy wyświetlanie upselli
- Dostosowuj elementy poza Upcart, np. ukrywanie przycisków na stronie produktu
Uwaga dotycząca starszych wersji: wywołania zwrotne
window.upcartOnCartLoaded nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj upcartSubscribeCartLoaded. Pamiętaj, że event.cart nie ma właściwości item_count — użyj event.cart.items.reduce((total, item) => total + item.quantity, 0), aby obliczyć łączną liczbę produktów.Czy muszę być programistą, aby korzystać z API Upcart?
Czy API Upcart może integrować się z innymi aplikacjami firm trzecich?
Uwaga dotycząca starszych wersji: wywołania zwrotne
window.upcartOnAddToCart nadal działają, ale są przestarzałe i wyświetlają ostrzeżenia w konsoli. We wszystkich nowych skryptach używaj upcartSubscribeAddedToCart. Pamiętaj, że właściwości zdarzenia znajdują się w event.item (z variantId i quantityAdded), a nie są przekazywane jako osobne parametry.Jak sprawdzić, czy moje zmiany w API działają?
- Odśwież swój sklep i dodaj produkt do koszyka.
- Wyczyść pamięć podręczną i spróbuj ponownie, aby zobaczyć najnowsze zmiany.
-
Dodaj komunikat testowy: Wstaw
console.log("The script works!");przed</script>, aby sprawdzić, czy skrypt się uruchamia. -
Sprawdź konsolę przeglądarki:
- Otwórz Dev Tools (
F12lubCtrl + Shift + Jw Windows,Cmd + Option + Jna Macu). - Przejdź do karty Console i poszukaj komunikatu „The script works!”
- Jeśli widzisz komunikat, Twój skrypt działa! Jeśli nie, skrypt może nie wykonywać się poprawnie.
- Otwórz Dev Tools (
- Przetestuj różne działania (np. usunięcie produktu), aby upewnić się, że zachowanie jest zgodne z oczekiwaniami.
Co zrobić, jeśli skrypt API nie działa?
- Sprawdź literówki – Nawet drobne błędy mogą zepsuć skrypt. Poszukaj brakujących znaków lub nieprawidłowej składni.
- Zweryfikuj umiejscowienie skryptu – Upewnij się, że skrypt znajduje się we właściwej sekcji w Upcart → Settings → Custom HTML. Upcart ma dziesięć sekcji skryptów (dziewięć punktów wstrzykiwania HTML plus jedną sekcję Scripts-before-load) — Przejrzyj te sekcje tutaj.
- Sprawdź konsolę przeglądarki – Wykonaj powyższe kroki, aby poszukać błędów.
- Przetestuj inny skrypt – Wypróbuj inny gotowy skrypt API Upcart, aby sprawdzić, czy problem leży w Twoim kodzie.
- Nadal utknęło? – Jeśli modyfikujesz motyw Shopify lub integrujesz aplikacje firm trzecich, pomóc może ekspert Shopify z katalogu partnerów Shopify.
Jak cofnąć zmiany, jeśli dodam skrypt, który coś psuje?
- Przejdź do ustawień Custom HTML w Upcart, gdzie skrypt został dodany.
-
Usuń skrypt lub tymczasowo go wyłącz, dodając
//na początku każdej linii (zamienia to linię w komentarz, co zapobiega jej wykonaniu). - Zapisz zmiany i odśwież sklep, aby sprawdzić, czy problem został rozwiązany.
🚧 Szukasz zaawansowanych personalizacji? Potrzebujesz personalizacji obejmującej cały sklep lub integracji z aplikacjami firm trzecich? Możesz potrzebować programisty, który doda API Upcart do Twojego motywu Shopify. Rozważ zatrudnienie eksperta Shopify przez katalog partnerów Shopify i udostępnij mu naszą dokumentację API, aby uzyskać pomoc