API JavaScript
O objeto da loja online, os seletores do tema que pode substituir e os eventos que a aplicação dispara.
Esta página destina-se a programadores que trabalham num tema. Nada aqui é necessário para utilizar a aplicação normalmente — existe para os casos em que um tema faz algo suficientemente invulgar para que as próprias configurações da aplicação não consigam lá chegar.
Tudo o que se segue é executado na loja online e precisa da incorporação da aplicação ativada. Sem ela, nenhum destes objetos ou eventos existe.
window.GPOConfigs
O objeto da aplicação na loja online. É criado pela incorporação da aplicação antes de o próprio script da aplicação ser executado, e é isso que torna possíveis as substituições abaixo.
| Propriedade | O que contém |
|---|---|
theme | Os seletores que a aplicação utiliza para encontrar elementos no seu tema. Consulte Seletores do tema |
page.type | O tipo de página da Shopify — product, cart, index, collection, etc. |
product | O produto atual, no formato JSON de produto da Shopify, mais product.collections com os ids das coleções a que pertence. false fora de uma página de produto |
cart | O carrinho atual, no formato JSON de carrinho da Shopify |
customer | id, name, email e tags de um cliente com sessão iniciada, ou false. As etiquetas são aquilo com que as regras de clientes fazem a correspondência |
curCountryCode | O país do visitante, como código de duas letras. É aquilo com que as regras de países fazem a correspondência |
money_format | O formato monetário com que a aplicação formata os preços, que segue as configurações de preço do suplemento |
initialize() | Executa a aplicação novamente. Consulte Executar a aplicação novamente |
O resto desta secção
Executar a aplicação novamente
GPOConfigs.initialize() executa a aplicação novamente desde o início. Utilize-o quando algo substitui o formulário do produto depois de a página ter carregado — um construtor de páginas que troca secções, ou um tema que volta a renderizar o produto quando a variante muda.
window.GPOConfigs && window.GPOConfigs.initialize();Chame-o depois de o novo código HTML estar no DOM, não antes. Chamá-lo quando nada mudou volta a renderizar as opções sem necessidade, por isso acione-o a partir do próprio sinal de «secção substituída» do seu tema e não com um temporizador.
Notas
- Tudo isto precisa da incorporação da aplicação ativada no tema publicado. Consulte Ativar a incorporação da aplicação.
GPOConfigsexiste em todas as páginas em que a incorporação da aplicação é executada, masproductéfalsefora de uma página de produto.- Substituir seletores não altera o que as opções recolhem, apenas onde a aplicação encontra elementos no seu tema.
- Se um tema precisar da mesma substituição em todas as lojas que o utilizam, envie-a para nós em vez de a repetir em cada loja. Consulte Contactar o suporte.
Esta página foi útil?
Obrigado pelo seu feedback! Diga-nos o que faltou
Comunicar um problema