Pular para o conteúdo
Instalar app
Português (Brasil)

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.

ChaveAtributo de conexãoO que o app faz com ela
formdata-gpo-product-formO 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
addToCartButtondata-gpo-product-atcO 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
unitPricedata-gpo-product-unit-priceO preço exibido. Reescrito à medida que o cliente escolhe opções com preço
compareAtPricedata-gpo-product-compare-at-priceO preço comparativo, atualizado junto com ele
variantSelectordata-gpo-product-variant-selectorO campo oculto que guarda o ID da variante escolhida. Lido para saber qual variante está selecionada
variantActivatordata-gpo-product-variant-activatorOs controles em que o cliente clica para mudar de variante. Monitorados para que as condições de variante possam reagir
variantWrapperdata-gpo-product-variant-wrapperO bloco que contém os seletores de variantes. Usado para posicionar o widget em relação a eles
imageContainerdata-gpo-product-image-containerA área da imagem principal. É onde o Personalizador desenha a prévia ao vivo
imagedata-gpo-product-imageA própria imagem principal do produto
imagesdata-gpo-product-imagesAs imagens da galeria, para a configuração Aplicar a da prévia
imageButtondata-gpo-product-image-buttonAs miniaturas ou setas da galeria, monitoradas para que a prévia acompanhe a imagem exibida
sticky.atcButtondata-gpo-sticky-atcO botão de adicionar ao carrinho em uma barra fixa, para que ele valide como o botão real
sticky.variantActivatordata-gpo-sticky-variant-activatorO controle de variante em uma barra fixa

collection

Usado nos pop-ups de visualização rápida das páginas de coleção.

ChaveAtributo de conexãoO que o app faz com ela
wrapperdata-gpo-collection-wrapperA seção da coleção, a área que o app monitora
itemdata-gpo-collection-itemUm card de produto dentro dela
productLinkdata-gpo-collection-productLinkO link para o produto, lido para saber a qual produto o card corresponde
quickViewActivatordata-gpo-collection-qvActivatorO controle que abre a visualização rápida, monitorado para que o app saiba quando renderizar
quickViewProductFormdata-gpo-collection-qvFormO 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.

ChaveAtributo de conexãoO que o app faz com ela
formdata-gpo-cart-formO formulário do carrinho. Aceita uma matriz, testada em ordem
pageveja abaixoComo ler um item na página do carrinho. Aceita uma matriz de estruturas, testadas em ordem
drawerveja abaixoO mesmo para o carrinho lateral

page e drawer contêm cada um um lineItem que descreve as partes de uma linha do carrinho:

ParteAtributo de conexão (página do carrinho)O que é
keydata-gpo-cart-item-keyA própria linha, que traz a chave do item
imagedata-gpo-cart-item-imageA miniatura da linha
detailsdata-gpo-cart-item-detailsO bloco de título e propriedades, onde o botão Editar opções é adicionado
quantity.wrapperdata-gpo-cart-item-qty-wrapperO controle de quantidade, ocultado nas linhas de complementos
quantity.inputdata-gpo-cart-item-qtyO campo de quantidade
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseOs botões de menos e de mais
removeButtondata-gpo-cart-item-remove-buttonO 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?

Relatar um problema