Seletores de tema
Todos os seletores que o app usa para encontrar elementos no seu tema e as duas formas de alterar um deles.
O app encontra o formulário do produto, o preço, o seletor de variantes e as linhas do carrinho por seletor CSS. Ele inclui um conjunto ajustado para cada tema compatível e um conjunto padrão amplo para os demais, e é por isso que funciona na maioria dos temas sem ajuda.
Um tema muito personalizado ainda pode colocar algo onde os padrões não alcançam. Há duas formas de resolver isso, e a primeira é quase sempre a melhor.
1. Adicionar o atributo do próprio app
Quase todo seletor começa com um atributo data-gpo-… que existe apenas como ponto de conexão para você. Coloque esse atributo no elemento do seu tema e o app o encontra, sem nenhum seletor para manter e nada que uma atualização do tema possa renomear.
<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. Substituir o seletor
Use esta opção quando você não puder editar a marcação — uma seção que você não controla ou um app que renderiza o formulário. Defina a substituição antes que o script do app seja 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 mesclados por cima dos valores do app, então você substitui apenas as chaves que informar.
product
Usado nas páginas de produto e nas seções de produto em destaque em outras páginas.
| Chave | Atributo de conexão | O que o app faz com ela |
|---|---|---|
form | data-gpo-product-form | O formulário do produto. É a base de todo o resto — as opções são renderizadas nele e validadas no envio. Aceita uma matriz, testada em ordem |
addToCartButton | data-gpo-product-atc | O botão de adicionar ao carrinho. Usado para posicionar 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 ele pularia o formulário |
quantity | — | O campo de quantidade. Lido para que as quantidades dos complementos possam acompanhar a quantidade do produto principal |
unitPrice | data-gpo-product-unit-price | O preço exibido. Reescrito à medida que o cliente escolhe opções com preço |
compareAtPrice | data-gpo-product-compare-at-price | O preço comparativo, atualizado junto com ele |
variantSelector | data-gpo-product-variant-selector | O campo oculto que guarda o ID da variante escolhida. Lido para saber qual variante está selecionada |
variantActivator | data-gpo-product-variant-activator | Os controles em que o cliente clica para mudar de variante. Monitorados para que as condições de variante possam reagir |
variantWrapper | data-gpo-product-variant-wrapper | O bloco que contém os seletores de variantes. Usado 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évia ao vivo |
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évia |
imageButton | data-gpo-product-image-button | As miniaturas ou setas da galeria, monitoradas para que a prévia acompanhe a imagem exibida |
sticky.atcButton | data-gpo-sticky-atc | O botão de adicionar ao carrinho em uma barra fixa, para que ele valide como o botão real |
sticky.variantActivator | data-gpo-sticky-variant-activator | O controle de variante em uma barra fixa |
collection
Usado nos pop-ups de visualização rápida das páginas de coleção.
| Chave | Atributo de conexão | O que o app faz com ela |
|---|---|---|
wrapper | data-gpo-collection-wrapper | A seção da coleção, a área que o app monitora |
item | data-gpo-collection-item | Um card de produto dentro dela |
productLink | data-gpo-collection-productLink | O link para o produto, lido para saber a qual produto o card corresponde |
quickViewActivator | data-gpo-collection-qvActivator | O controle que abre a visualização rápida, monitorado para que o app 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
Usado na página do carrinho e no carrinho lateral, para editar opções e manter as linhas de complementos vinculadas ao item principal.
| Chave | Atributo de conexão | O que o app faz com ela |
|---|---|---|
form | data-gpo-cart-form | O formulário do carrinho. Aceita uma matriz, testada em ordem |
page | veja abaixo | Como ler um item na página do carrinho. Aceita uma matriz de estruturas, testadas em ordem |
drawer | veja 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 conexão (página do carrinho) | O que é |
|---|---|---|
key | data-gpo-cart-item-key | A própria linha, que traz a chave do item |
image | data-gpo-cart-item-image | A miniatura da linha |
details | data-gpo-cart-item-details | O bloco de título e propriedades, onde o botão Editar opções é adicionado |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | O controle de quantidade, ocultado nas linhas de complementos |
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 | O link de remover, ocultado nas linhas de complementos |
O carrinho lateral usa as mesmas partes com data-gpo-drawer-item-… em vez de data-gpo-cart-item-….
Observações
- As chaves que aceitam uma matriz são testadas em ordem e a primeira correspondência vence, então você pode adicionar os seus seletores na frente dos padrões em vez de substituí-los.
- Substituir um seletor muda apenas onde o app procura. Isso não muda o que as opções coletam nem como elas são precificadas.
- Uma substituição se aplica a todas as páginas de produto da loja. Para um único produto, direcione a substituição no próprio seletor.
Esta página foi útil?
Obrigado pelo feedback! Conte o que faltou
Relatar um problema