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.
| Eigenschaft | Inhalt |
|---|---|
theme | Die Selektoren, mit denen die App Elemente in Ihrem Theme findet. Siehe Theme-Selektoren |
page.type | Der Shopify-Seitentyp – product, cart, index, collection usw. |
product | Das 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 |
cart | Der aktuelle Warenkorb als Shopify-Warenkorb-JSON |
customer | id, name, email und tags eines angemeldeten Kunden oder false. Anhand der Tags greifen die Kundenregeln |
curCountryCode | Das Land des Besuchers als zweistelliger Code. Anhand dessen greifen die Länderregeln |
money_format | Das 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.
GPOConfigsexistiert auf jeder Seite, auf der die App-Einbettung läuft, aberproductist außerhalb einer Produktseitefalse.- 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?
Danke für Ihr Feedback! Sagen Sie uns, was gefehlt hat
Problem melden