API JavaScript
L’objet de la boutique en ligne, les sélecteurs de thème que vous pouvez remplacer et les événements déclenchés par l’app.
Cette page s’adresse aux développeurs qui travaillent sur un thème. Rien de ce qui suit n’est nécessaire pour une utilisation normale de l’app — elle existe pour les cas où un thème fait quelque chose d’assez inhabituel pour que les paramètres de l’app ne puissent pas l’atteindre.
Tout ce qui suit s’exécute sur la boutique en ligne et nécessite que l’intégration d’application soit activée. Sans elle, aucun de ces objets ou événements n’existe.
window.GPOConfigs
L’objet de l’app sur la boutique en ligne. Il est créé par l’intégration d’application avant l’exécution du script de l’app, ce qui rend possibles les remplacements décrits ci-dessous.
| Propriété | Contenu |
|---|---|
theme | Les sélecteurs que l’app utilise pour trouver des éléments dans votre thème. Consultez Sélecteurs de thème |
page.type | Le type de page Shopify — product, cart, index, collection, etc. |
product | Le produit actuel, au format JSON produit de Shopify, avec product.collections contenant les identifiants des collections auxquelles il appartient. false en dehors d’une page produit |
cart | Le panier actuel, au format JSON panier de Shopify |
customer | id, name, email et tags pour un client connecté, ou false. Ce sont ces balises que les règles client utilisent |
curCountryCode | Le pays du visiteur, sous forme de code à deux lettres. C’est ce que les règles de pays utilisent |
money_format | Le format monétaire avec lequel l’app met en forme les prix, qui suit vos paramètres de prix des suppléments |
initialize() | Exécute à nouveau l’app. Consultez Relancer l’app |
Le reste de cette section
Relancer l’app
GPOConfigs.initialize() exécute à nouveau l’app depuis le début. Utilisez-le lorsqu’un élément remplace le formulaire produit après le chargement de la page — un constructeur de pages qui échange des sections, ou un thème qui réaffiche le produit lors d’un changement de variante.
window.GPOConfigs && window.GPOConfigs.initialize();Appelez-le une fois le nouveau balisage présent dans le DOM, pas avant. L’appeler alors que rien n’a changé réaffiche inutilement les options : déclenchez-le donc à partir du propre signal « section remplacée » de votre thème plutôt qu’avec une minuterie.
Remarques
- Tout ceci nécessite que l’intégration d’application soit activée sur le thème publié. Consultez Activer l’intégration d’application.
GPOConfigsexiste sur chaque page où l’intégration d’application s’exécute, maisproductvautfalseen dehors d’une page produit.- Remplacer des sélecteurs ne modifie pas ce que les options recueillent, seulement l’endroit où l’app trouve les éléments dans votre thème.
- Si un thème nécessite le même remplacement sur toutes les boutiques qui l’utilisent, envoyez-le-nous au lieu de le répéter boutique par boutique. Consultez Contacter l’assistance.
Cette page vous a-t-elle aidé ?
Merci pour votre retour ! Dites-nous ce qui manquait
Signaler un problème