Zum Inhalt springen
App installieren
Deutsch

JavaScript-API

Das Storefront-Objekt, die Theme-Selektoren, die Sie überschreiben können, und die Events, die die App auslöst.

Diese Seite richtet sich an Entwickler, die an einem Theme arbeiten. Für die normale Nutzung der App brauchen Sie nichts davon – sie ist für Fälle gedacht, in denen ein Theme etwas so Ungewöhnliches tut, dass die eigenen Einstellungen der App es nicht erreichen.

Alles Folgende läuft im Shop und erfordert eine aktivierte App-Einbettung. Ohne sie existiert keines dieser Objekte oder Events.

window.GPOConfigs

Das Storefront-Objekt der App. Es wird von der App-Einbettung erstellt, bevor das eigene Skript der App läuft. Das ermöglicht die unten beschriebenen Überschreibungen.

EigenschaftInhalt
themeDie Selektoren, mit denen die App Elemente in Ihrem Theme findet. Siehe Theme-Selektoren
page.typeDer Shopify-Seitentyp – product, cart, index, collection usw.
productDas aktuelle Produkt als Shopify-Produkt-JSON, zusätzlich product.collections mit den IDs der Kollektionen, zu denen es gehört. false außerhalb einer Produktseite
cartDer aktuelle Warenkorb als Shopify-Warenkorb-JSON
customerid, name, email und tags eines angemeldeten Kunden oder false. Anhand der Tags greifen die Kundenregeln
curCountryCodeDas Land des Besuchers als zweistelliger Code. Anhand dessen greifen die Länderregeln
money_formatDas Geldformat, mit dem die App Preise formatiert. Es richtet sich nach Ihren Add-on-Preiseinstellungen
initialize()Führt die App erneut aus. Siehe Die App erneut ausführen

Der Rest dieses Abschnitts

Die App erneut ausführen

GPOConfigs.initialize() führt die App von Anfang an erneut aus. Verwenden Sie es, wenn etwas das Produktformular ersetzt, nachdem die Seite geladen wurde – ein Page Builder, der Abschnitte austauscht, oder ein Theme, das das Produkt bei einem Variantenwechsel neu rendert.

window.GPOConfigs && window.GPOConfigs.initialize();

Rufen Sie es auf, nachdem das neue Markup im DOM ist, nicht vorher. Ein Aufruf, obwohl sich nichts geändert hat, rendert die Optionen unnötig neu. Lösen Sie es daher über das eigene Signal Ihres Themes für einen ersetzten Abschnitt aus, nicht über einen Timer.

Hinweise

  • All das erfordert eine aktivierte App-Einbettung im veröffentlichten Theme. Siehe App-Einbettung aktivieren.
  • GPOConfigs existiert auf jeder Seite, auf der die App-Einbettung läuft, aber product ist außerhalb einer Produktseite false.
  • Das Überschreiben von Selektoren ändert nicht, was die Optionen erfassen, sondern nur, wo die App Elemente in Ihrem Theme findet.
  • Wenn ein Theme in jedem Shop, der es nutzt, dieselbe Überschreibung braucht, senden Sie sie uns, statt sie in jedem Shop zu wiederholen. Siehe Support kontaktieren.

War diese Seite hilfreich?

Problem melden