Aller au contenu
Installer l’app
Français

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
themeLes sélecteurs que l’app utilise pour trouver des éléments dans votre thème. Consultez Sélecteurs de thème
page.typeLe type de page Shopify — product, cart, index, collection, etc.
productLe 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
cartLe panier actuel, au format JSON panier de Shopify
customerid, name, email et tags pour un client connecté, ou false. Ce sont ces balises que les règles client utilisent
curCountryCodeLe pays du visiteur, sous forme de code à deux lettres. C’est ce que les règles de pays utilisent
money_formatLe 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.
  • GPOConfigs existe sur chaque page où l’intégration d’application s’exécute, mais product vaut false en 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é ?

Signaler un problème