Salta ai contenuti
Installa l’app
Italiano

API JavaScript

L'oggetto del negozio online, i selettori del tema che puoi sovrascrivere e gli eventi che l'app attiva.

Questa pagina è destinata agli sviluppatori che lavorano su un tema. Niente di quanto descritto qui è necessario per usare normalmente l’app: serve nei casi in cui un tema fa qualcosa di così insolito che le impostazioni dell’app non riescono a gestirlo.

Tutto ciò che segue viene eseguito nel negozio online e richiede l’incorporamento app attivato. Senza di esso, nessuno di questi oggetti o eventi esiste.

window.GPOConfigs

L’oggetto dell’app nel negozio online. Viene creato dall’incorporamento app prima che venga eseguito lo script dell’app stessa, ed è questo che rende possibili le sovrascritture descritte di seguito.

ProprietàCosa contiene
themeI selettori che l'app usa per trovare gli elementi nel tuo tema. Consulta Selettori del tema
page.typeIl tipo di pagina Shopify: product, cart, index, collection e così via
productIl prodotto corrente, come JSON del prodotto di Shopify, più product.collections con gli ID delle collezioni a cui appartiene. false al di fuori di una pagina del prodotto
cartIl carrello corrente, come JSON del carrello di Shopify
customerid, name, email e tags per un cliente che ha eseguito l'accesso, oppure false. I tag sono ciò su cui si basano le regole sui clienti
curCountryCodeIl paese del visitatore, come codice di due lettere. È ciò su cui si basano le regole sui paesi
money_formatIl formato valuta con cui l'app formatta i prezzi, che segue le impostazioni del prezzo dell'add-on
initialize()Esegue di nuovo l'app. Consulta Eseguire di nuovo l'app

Il resto di questa sezione

Eseguire di nuovo l’app

GPOConfigs.initialize() esegue di nuovo l’app dall’inizio. Usalo quando qualcosa sostituisce il modulo del prodotto dopo il caricamento della pagina: un page builder che scambia le sezioni o un tema che ridisegna il prodotto al cambio di variante.

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

Chiamalo dopo che il nuovo markup è nel DOM, non prima. Chiamarlo quando non è cambiato nulla ridisegna le opzioni inutilmente, quindi attivalo tramite il segnale «sezione sostituita» del tuo tema invece che con un timer.

Note

  • Tutto questo richiede l’incorporamento app attivato nel tema pubblicato. Consulta Attiva l’incorporamento app.
  • GPOConfigs esiste su ogni pagina in cui viene eseguito l’incorporamento app, ma product è false al di fuori di una pagina del prodotto.
  • Sovrascrivere i selettori non modifica ciò che le opzioni raccolgono, ma solo dove l’app trova gli elementi nel tuo tema.
  • Se un tema richiede la stessa sovrascrittura in ogni negozio che lo usa, inviacela invece di ripeterla negozio per negozio. Consulta Contatta l’assistenza.

Questa pagina ti è stata utile?

Segnala un problema