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.
| Clave | Atributo de enganche | Qué hace la app con él |
|---|---|---|
form | data-gpo-product-form | El 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 |
addToCartButton | data-gpo-product-atc | El 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 |
unitPrice | data-gpo-product-unit-price | El precio mostrado. Se reescribe a medida que el cliente elige opciones con precio |
compareAtPrice | data-gpo-product-compare-at-price | El precio de comparación, que se actualiza junto con él |
variantSelector | data-gpo-product-variant-selector | El campo oculto que contiene el ID de la variante elegida. Se lee para saber qué variante está seleccionada |
variantActivator | data-gpo-product-variant-activator | Los controles en los que el cliente hace clic para cambiar de variante. Se vigilan para que las condiciones de variante puedan reaccionar |
variantWrapper | data-gpo-product-variant-wrapper | El bloque que contiene los selectores de variantes. Se usa para posicionar el widget respecto a ellos |
imageContainer | data-gpo-product-image-container | El área de la imagen principal. Donde el Personalizador dibuja su vista previa en vivo |
image | data-gpo-product-image | La imagen principal del producto en sí |
images | data-gpo-product-images | Las imágenes de la galería, para el ajuste Aplicar a de la vista previa |
imageButton | data-gpo-product-image-button | Las miniaturas o flechas de la galería, que se vigilan para que la vista previa siga la imagen que se muestra |
sticky.atcButton | data-gpo-sticky-atc | El botón de agregar al carrito de una barra fija, para que valide igual que el botón real |
sticky.variantActivator | data-gpo-sticky-variant-activator | El control de variantes de una barra fija |
collection
Se usa para las ventanas de vista rápida en las páginas de colección.
| Clave | Atributo de enganche | Qué hace la app con él |
|---|---|---|
wrapper | data-gpo-collection-wrapper | La sección de la colección, el área que vigila la app |
item | data-gpo-collection-item | Una tarjeta de producto dentro de ella |
productLink | data-gpo-collection-productLink | El enlace al producto, que se lee para saber a qué producto corresponde una tarjeta |
quickViewActivator | data-gpo-collection-qvActivator | El control que abre la vista rápida, que se vigila para que la app sepa cuándo renderizar |
quickViewProductForm | data-gpo-collection-qvForm | El 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.
| Clave | Atributo de enganche | Qué hace la app con él |
|---|---|---|
form | data-gpo-cart-form | El formulario del carrito. Acepta un array, que se prueba en orden |
page | ver más abajo | Cómo leer una línea de artículo en la página del carrito. Acepta un array de estructuras, que se prueban en orden |
drawer | ver más abajo | Lo mismo para el carrito lateral |
page y drawer contienen cada uno un lineItem que describe las partes de una fila del carrito:
| Parte | Atributo de enganche (página del carrito) | Qué es |
|---|---|---|
key | data-gpo-cart-item-key | La propia fila, que lleva la clave de la línea de artículo |
image | data-gpo-cart-item-image | La miniatura de la fila |
details | data-gpo-cart-item-details | El bloque del título y las propiedades, donde se agrega Editar opciones |
quantity.wrapper | data-gpo-cart-item-qty-wrapper | El control de cantidad, oculto en las líneas de complementos |
quantity.input | data-gpo-cart-item-qty | El campo de cantidad |
quantity.decrease / increase | data-gpo-cart-item-qty-decrease / -increase | Los botones de menos y más |
removeButton | data-gpo-cart-item-remove-button | El 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?
¡Gracias por tu opinión! Cuéntanos qué faltaba
Informar de un problema