Pular para o conteúdo
Instalar aplicação
Português (Portugal)

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.

PropriedadeO que contém
themeOs seletores que a aplicação utiliza para encontrar elementos no seu tema. Consulte Seletores do tema
page.typeO tipo de página da Shopify — product, cart, index, collection, etc.
productO 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
cartO carrinho atual, no formato JSON de carrinho da Shopify
customerid, 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
curCountryCodeO país do visitante, como código de duas letras. É aquilo com que as regras de países fazem a correspondência
money_formatO 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.
  • GPOConfigs existe em todas as páginas em que a incorporação da aplicação é executada, mas product é false fora 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?

Comunicar um problema