Ir al contenido
Instalar la app
Español

Selectores del tema

Todos los selectores que usa la app para encontrar elementos en tu tema, y las dos formas de cambiar uno.

La app encuentra el formulario del producto, el precio, el selector de variantes y las líneas del carrito mediante selectores CSS. Incluye un conjunto ajustado para cada tema compatible y un conjunto predeterminado amplio para el resto, por eso funciona en la mayoría de los temas sin ayuda.

Aun así, un tema muy personalizado puede colocar algo donde los valores predeterminados no llegan. Hay dos formas de solucionarlo, y la primera casi siempre es la mejor.

1. Agrega el atributo propio de la app

Casi todos los selectores empiezan por un atributo data-gpo-… que existe únicamente como punto de enganche para ti. Coloca ese atributo en el elemento de tu tema y la app lo encuentra, sin ningún selector que mantener y sin nada que una actualización del tema pueda renombrar.

<form action="/cart/add" method="post" data-gpo-product-form>
…
<button type="submit" data-gpo-product-atc>Add to cart</button>
</form>

El atributo de cada selector aparece en las tablas de abajo.

2. Sobrescribe el selector

Usa esta opción cuando no puedas editar el marcado: una sección que no controlas o una app que renderiza el formulario. Defínelo antes de que se ejecute el script de la app, en theme.liquid, encima 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>

Tus valores se combinan sobre los de la app, así que solo sobrescribes las claves que indiques.

product

Se usa en las páginas de producto y en las secciones de producto destacado de otras páginas.

ClaveAtributo de engancheQué hace la app con él
formdata-gpo-product-formEl formulario del producto. Es el ancla de todo lo demás: las opciones se renderizan dentro de él y se validan al enviarlo. Acepta un array, que se prueba en orden
addToCartButtondata-gpo-product-atcEl botón de agregar al carrito. Se usa para colocar el widget encima de él y para bloquear el envío cuando la validación falla
paymentButton—El botón de pago acelerado. Se oculta en los productos con opciones, porque se saltaría el formulario
quantity—El campo de cantidad. Se lee para que las cantidades de los complementos puedan seguir la cantidad del producto principal
unitPricedata-gpo-product-unit-priceEl precio mostrado. Se reescribe a medida que el cliente elige opciones con precio
compareAtPricedata-gpo-product-compare-at-priceEl precio de comparación, que se actualiza junto con él
variantSelectordata-gpo-product-variant-selectorEl campo oculto que contiene el ID de la variante elegida. Se lee para saber qué variante está seleccionada
variantActivatordata-gpo-product-variant-activatorLos controles en los que el cliente hace clic para cambiar de variante. Se vigilan para que las condiciones de variante puedan reaccionar
variantWrapperdata-gpo-product-variant-wrapperEl bloque que contiene los selectores de variantes. Se usa para posicionar el widget respecto a ellos
imageContainerdata-gpo-product-image-containerEl área de la imagen principal. Donde el Personalizador dibuja su vista previa en vivo
imagedata-gpo-product-imageLa imagen principal del producto en sí
imagesdata-gpo-product-imagesLas imágenes de la galería, para el ajuste Aplicar a de la vista previa
imageButtondata-gpo-product-image-buttonLas miniaturas o flechas de la galería, que se vigilan para que la vista previa siga la imagen que se muestra
sticky.atcButtondata-gpo-sticky-atcEl botón de agregar al carrito de una barra fija, para que valide igual que el botón real
sticky.variantActivatordata-gpo-sticky-variant-activatorEl control de variantes de una barra fija

collection

Se usa para las ventanas de vista rápida en las páginas de colección.

ClaveAtributo de engancheQué hace la app con él
wrapperdata-gpo-collection-wrapperLa sección de la colección, el área que vigila la app
itemdata-gpo-collection-itemUna tarjeta de producto dentro de ella
productLinkdata-gpo-collection-productLinkEl enlace al producto, que se lee para saber a qué producto corresponde una tarjeta
quickViewActivatordata-gpo-collection-qvActivatorEl control que abre la vista rápida, que se vigila para que la app sepa cuándo renderizar
quickViewProductFormdata-gpo-collection-qvFormEl formulario del producto dentro de la vista rápida, donde van las opciones

cart

Se usa en la página del carrito y en el carrito lateral, para editar opciones y para mantener las líneas de complementos vinculadas a su artículo principal.

ClaveAtributo de engancheQué hace la app con él
formdata-gpo-cart-formEl formulario del carrito. Acepta un array, que se prueba en orden
pagever más abajoCómo leer una línea de artículo en la página del carrito. Acepta un array de estructuras, que se prueban en orden
drawerver más abajoLo mismo para el carrito lateral

page y drawer contienen cada uno un lineItem que describe las partes de una fila del carrito:

ParteAtributo de enganche (página del carrito)Qué es
keydata-gpo-cart-item-keyLa propia fila, que lleva la clave de la línea de artículo
imagedata-gpo-cart-item-imageLa miniatura de la fila
detailsdata-gpo-cart-item-detailsEl bloque del título y las propiedades, donde se agrega Editar opciones
quantity.wrapperdata-gpo-cart-item-qty-wrapperEl control de cantidad, oculto en las líneas de complementos
quantity.inputdata-gpo-cart-item-qtyEl campo de cantidad
quantity.decrease / increasedata-gpo-cart-item-qty-decrease / -increaseLos botones de menos y más
removeButtondata-gpo-cart-item-remove-buttonEl enlace para eliminar, oculto en las líneas de complementos

El carrito lateral usa las mismas partes con data-gpo-drawer-item-… en lugar de data-gpo-cart-item-….

Notas

  • Las claves que aceptan un array se prueban en orden y gana la primera coincidencia, así que puedes agregar las tuyas delante de las predeterminadas en lugar de reemplazarlas.
  • Sobrescribir un selector solo cambia dónde busca la app. No cambia lo que recopilan las opciones ni cómo se calculan sus precios.
  • Una sobrescritura se aplica a todas las páginas de producto de la tienda. Para un solo producto, apúntalo en el propio selector.

¿Te ha sido útil?

Informar de un problema