Seletores do tema
Todos os seletores que a aplicação utiliza para encontrar elementos no seu tema e as duas formas de alterar um deles.
A aplicação encontra o formulário do produto, o preço, o seletor de variantes e as linhas do carrinho através de seletores CSS. Inclui um conjunto ajustado para cada tema suportado e um conjunto predefinido abrangente para os restantes, e é por isso que funciona na maioria dos temas sem ajuda.
Um tema muito personalizado pode, ainda assim, colocar algo onde os seletores predefinidos não chegam. Há duas formas de resolver isso, e a primeira é quase sempre a melhor.
1. Adicione o atributo próprio da aplicação
Quase todos os seletores começam por um atributo data-gpo-… que existe apenas como ponto de ligação para si. Coloque esse atributo no elemento do seu tema e a aplicação encontra-o, sem nenhum seletor para manter e sem nada que uma atualização do tema possa mudar de nome.
<form action="/cart/add" method="post" data-gpo-product-form> … <button type="submit" data-gpo-product-atc>Add to cart</button></form>O atributo de cada seletor está nas tabelas abaixo.
2. Substitua o seletor
Utilize esta opção quando não consegue editar o código HTML — uma secção que não controla, ou uma aplicação que renderiza o formulário. Defina-o antes de o script da aplicação ser executado, em theme.liquid, acima de </body>:
<script> window.GPOConfigs = window.GPOConfigs || {}; window.GPOConfigs.theme = window.GPOConfigs.theme || {}; window.GPOConfigs.theme.product = { ...(window.GPOConfigs.theme.product || {}), form: ['#my-product-form'], addToCartButton: '.my-atc-button' };</script>Os seus valores são unidos sobre os da aplicação, por isso só substitui as chaves que indicar.
product
Utilizado nas páginas de produto e nas secções de produto em destaque noutras páginas.
| Chave | Atributo de ligação | O que a aplicação faz com ele |
|---|---|---|
form | data-gpo-product-form | O formulário do produto. É a âncora de tudo o resto — as opções são renderizadas nele e validadas no envio. Aceita uma matriz, testada por ordem |
addToCartButton | data-gpo-product-atc | O botão de adicionar ao carrinho. Utilizado para colocar o widget acima dele e para bloquear o envio quando a validação falha |
paymentButton | — | O botão de pagamento acelerado. Ocultado nos produtos com opções, porque ignoraria o formulário |
quantity | — | O campo de quantidade. Lido para que as quantidades dos suplementos possam acompanhar a quantidade do produto principal |
unitPrice | data-gpo-product-unit-price | O preço apresentado. Reescrito à medida que o cliente escolhe opções com preço |
compareAtPrice | data-gpo-product-compare-at-price | O preço de comparação, atualizado em conjunto com ele |
variantSelector | data-gpo-product-variant-selector | O campo oculto que contém o id da variante escolhida. Lido para saber que variante está selecionada |
variantActivator | data-gpo-product-variant-activator | Os controlos em que o cliente clica para mudar de variante. Observados para que as condições de variantes possam reagir |
variantWrapper | data-gpo-product-variant-wrapper | O bloco que contém os seletores de variantes. Utilizado para posicionar o widget em relação a eles |
imageContainer | data-gpo-product-image-container | A área da imagem principal. É onde o Personalizador desenha a pré-visualização em tempo real |
image | data-gpo-product-image | A própria imagem principal do produto |
images | data-gpo-product-images | As imagens da galeria, para a configuração Aplicar a da pré-visualização |
imageButton | data-gpo-product-image-button | As miniaturas ou setas da galeria, observadas para que a pré-visualização acompanhe a imagem apresentada |
sticky.atcButton | data-gpo-sticky-atc | O botão de adicionar ao carrinho numa barra fixa, para que seja validado como o botão real |
sticky.variantActivator | data-gpo-sticky-variant-activator | O controlo de variantes numa barra fixa |
collection
Utilizado nas janelas de visualização rápida das páginas de coleção.
| Chave | Atributo de ligação | O que a aplicação faz com ele |
|---|---|---|
wrapper | data-gpo-collection-wrapper | A secção da coleção, a área que a aplicação observa |
item | data-gpo-collection-item | Um cartão de produto dentro dela |
productLink | data-gpo-collection-productLink | A ligação para o produto, lida para saber a que produto corresponde um cartão |
quickViewActivator | data-gpo-collection-qvActivator | O controlo que abre a visualização rápida, observado para que a aplicação saiba quando renderizar |
quickViewProductForm | data-gpo-collection-qvForm | O formulário do produto dentro da visualização rápida, onde ficam as opções |
cart
Utilizado na página do carrinho e no carrinho lateral, para editar opções e para manter as linhas de suplementos associadas ao respetivo artigo principal.
| Chave | Atributo de ligação | O que a aplicação faz com ele |
|---|---|---|
form | data-gpo-cart-form | O formulário do carrinho. Aceita uma matriz, testada por ordem |
page | ver abaixo | Como ler um artigo na página do carrinho. Aceita uma matriz de estruturas, testadas por ordem |
drawer | ver abaixo | O mesmo para o carrinho lateral |
page e drawer contêm, cada um, um lineItem que descreve as partes de uma linha do carrinho:
| Parte | Atributo de ligação (página do carrinho) | O que é |
|---|---|---|
key | data-gpo-cart-item-key | A própria linha, que contém a chave do artigo |
image | data-gpo-cart-item-image | A miniatura da linha |
details | data-gpo-cart-item-details | O bloco do título e das propriedades, onde é adicionado Editar opções |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | O controlo de quantidade, ocultado nas linhas de suplementos |
quantity.input | data-gpo-cart-item-qty | O campo de quantidade |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Os botões de menos e de mais |
removeButton | data-gpo-cart-item-remove-button | A ligação de remover, ocultada nas linhas de suplementos |
O carrinho lateral utiliza as mesmas partes com data-gpo-drawer-item-… em vez de data-gpo-cart-item-….
Notas
- As chaves que aceitam uma matriz são testadas por ordem e a primeira correspondência prevalece, por isso pode adicionar as suas à frente das predefinidas em vez de as substituir.
- Substituir um seletor altera apenas onde a aplicação procura. Não altera o que as opções recolhem nem como lhes é atribuído o preço.
- Uma substituição aplica-se a todas as páginas de produto da loja. Para um só produto, direcione-a no próprio seletor.
Esta página foi útil?
Obrigado pelo seu feedback! Diga-nos o que faltou
Comunicar um problema