Übersicht
- Wo füge ich Upcart-API-Skripte hinzu?
- Muss ich Entwickler sein, um die Upcart-API zu nutzen?
- Kann sich die Upcart-API mit anderen Drittanbieter-Apps integrieren?
- Wie teste ich, ob meine API-Änderungen funktionieren?
- Was mache ich, wenn ein API-Skript nicht funktioniert?
- Wie mache ich Änderungen rückgängig, wenn ein Skript etwas kaputt macht?
Wo füge ich Upcart-API-Skripte hinzu?
Wie verwende ich Upcarts Custom HTML?
- Navigiere zu Upcart → Settings → Custom HTML
- Verwende API-Skripte, um das Warenkorbverhalten zu ändern, etwa den Zeitpunkt des Öffnens oder die Anzeige von Upsells
- Passe Elemente außerhalb von Upcart an, etwa das Ausblenden von Buttons auf der Produktseite
Hinweis zu Legacy-Callbacks:
window.upcartOnCartLoaded-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte upcartSubscribeCartLoaded. Beachte, dass event.cart keine item_count-Eigenschaft hat — verwende event.cart.items.reduce((total, item) => total + item.quantity, 0), um die Gesamtanzahl der Artikel zu berechnen.Muss ich Entwickler sein, um die Upcart-API zu nutzen?
Kann sich die Upcart-API mit anderen Drittanbieter-Apps integrieren?
Hinweis zu Legacy-Callbacks:
window.upcartOnAddToCart-Callbacks funktionieren weiterhin, sind aber veraltet und geben Konsolen-Warnungen aus. Verwende für alle neuen Skripte upcartSubscribeAddedToCart. Beachte, dass die Ereignis-Eigenschaften auf event.item liegen (mit variantId und quantityAdded) und nicht als separate Parameter übergeben werden.Wie teste ich, ob meine API-Änderungen funktionieren?
- Aktualisiere deinen Shop und lege einen Artikel in den Warenkorb.
- Leere deinen Cache und versuche es erneut, um die neuesten Änderungen zu sehen.
-
Füge eine Testnachricht hinzu: Füge
console.log("The script works!");vor</script>ein, um zu prüfen, ob dein Skript ausgeführt wird. -
Prüfe deine Browser-Konsole:
- Öffne die Dev Tools (
F12oderCtrl + Shift + Junter Windows,Cmd + Option + Jauf dem Mac). - Gehe zum Tab Console und suche nach “The script works!”
- Wenn du die Nachricht siehst, läuft dein Skript! Falls nicht, wird das Skript möglicherweise nicht korrekt ausgeführt.
- Öffne die Dev Tools (
- Teste verschiedene Aktionen (z. B. das Entfernen eines Artikels), um das erwartete Verhalten sicherzustellen.
Was mache ich, wenn ein API-Skript nicht funktioniert?
- Prüfe auf Tippfehler – Schon kleine Fehler können ein Skript zerstören. Suche nach fehlenden Zeichen oder falscher Syntax.
- Überprüfe die Skript-Platzierung – Stelle sicher, dass das Skript im richtigen Abschnitt unter Upcart → Settings → Custom HTML liegt. Upcart hat zehn Skript-Abschnitte (neun HTML-Einfügepunkte plus einen Scripts-before-load-Abschnitt) — Sieh dir diese Abschnitte hier an.
- Prüfe die Browser-Konsole – Folge den obigen Schritten, um nach Fehlern zu suchen.
- Teste ein anderes Skript – Probiere ein anderes vorgefertigtes Upcart-API-Skript aus, um zu sehen, ob das Problem an deinem Code liegt.
- Kommst du nicht weiter? – Wenn du dein Shopify-Theme änderst oder Drittanbieter-Apps integrierst, kann dir ein Shopify-Experte aus dem Shopify Partner Directory helfen.
Wie mache ich Änderungen rückgängig, wenn ein Skript etwas kaputt macht?
- Gehe zu Upcarts Custom-HTML-Einstellungen, wo das Skript hinzugefügt wurde.
-
Entferne das Skript oder deaktiviere es vorübergehend, indem du
//an den Anfang jeder Zeile setzt (das macht sie zu einem Kommentar und verhindert die Ausführung). - Speichere die Änderungen & aktualisiere deinen Shop, um zu prüfen, ob das Problem behoben ist.
🚧 Suchst du erweiterte Anpassungen? Brauchst du shop-weite Anpassungen oder Integrationen mit Drittanbieter-Apps? Möglicherweise benötigst du einen Entwickler, der die Upcart-API in dein Shopify-Theme einbaut. Ziehe in Betracht, einen Shopify-Experten über das Shopify Partner Directory zu beauftragen, und teile unsere API-Dokumentation mit ihm, um Unterstützung zu erhalten