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.
| Propriedade | O que contém |
|---|---|
theme | Os seletores que o app usa para encontrar elementos no seu tema. Consulte Seletores de tema |
page.type | O tipo de página da Shopify — product, cart, index, collection e assim por diante |
product | O 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 |
cart | O carrinho atual, como o JSON de carrinho da Shopify |
customer | id, name, email e tags de um cliente conectado, ou false. As tags são o que as regras de clientes comparam |
curCountryCode | O país do visitante, como um código de duas letras. É o que as regras de países comparam |
money_format | O 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.
GPOConfigsexiste em todas as páginas em que a incorporação do app é executada, masproductéfalsefora 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?
Obrigado pelo feedback! Conte o que faltou
Relatar um problema