Pular para o conteúdo
Instalar app
Português (Brasil)

API JavaScript

O objeto da loja virtual, os seletores de tema que você pode substituir e os eventos que o app dispara.

Esta página é para desenvolvedores que trabalham em um tema. Nada aqui é necessário para usar o app normalmente — ela existe para os casos em que um tema faz algo incomum o bastante para que as configurações do próprio app não deem conta.

Tudo abaixo é executado na loja virtual e precisa da incorporação do app ativada. Sem ela, nenhum desses objetos ou eventos existe.

window.GPOConfigs

O objeto do app na loja virtual. Ele é criado pela incorporação do app antes que o script do próprio app seja executado, e é isso que torna possíveis as substituições abaixo.

PropriedadeO que contém
themeOs seletores que o app usa para encontrar elementos no seu tema. Consulte Seletores de tema
page.typeO tipo de página da Shopify — product, cart, index, collection e assim por diante
productO produto atual, como o JSON de produto da Shopify, mais product.collections com os IDs das coleções às quais ele pertence. false fora de uma página de produto
cartO carrinho atual, como o JSON de carrinho da Shopify
customerid, name, email e tags de um cliente conectado, ou false. As tags são o que as regras de clientes comparam
curCountryCodeO país do visitante, como um código de duas letras. É o que as regras de países comparam
money_formatO formato monetário com que o app formata os preços, que segue as configurações de preço dos complementos
initialize()Executa o app novamente. Consulte Executar o app novamente

O restante desta seção

Executar o app novamente

GPOConfigs.initialize() executa o app novamente desde o início. Use quando algo substituir o formulário do produto depois que a página já carregou — um criador de páginas trocando seções ou um tema que renderiza o produto de novo ao mudar de variante.

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

Chame depois que a nova marcação estiver no DOM, não antes. Chamar quando nada mudou renderiza as opções de novo sem necessidade, então acione a chamada a partir do próprio sinal de “seção substituída” do seu tema, e não com um temporizador.

Observações

  • Tudo isso precisa da incorporação do app ativada no tema publicado. Consulte Ativar a incorporação do app.
  • GPOConfigs existe em todas as páginas em que a incorporação do app é executada, mas product é false fora de uma página de produto.
  • Substituir seletores não muda o que as opções coletam, apenas onde o app encontra os elementos no seu tema.
  • Se um tema precisar da mesma substituição em todas as lojas que o usam, envie para nós em vez de repetir loja por loja. Consulte Falar com o suporte.

Esta página foi útil?

Relatar um problema