API de JavaScript
El objeto de la tienda online, los selectores del tema que puedes sobrescribir y los eventos que emite la app.
Esta página está dirigida a desarrolladores que trabajan en un tema. Nada de esto es necesario para usar la app con normalidad: existe para los casos en que un tema hace algo tan inusual que los ajustes propios de la app no llegan a cubrirlo.
Todo lo que aparece a continuación se ejecuta en la tienda online y necesita la inserción de aplicación activada. Sin ella, no existe ninguno de estos objetos ni eventos.
window.GPOConfigs
El objeto de la app en la tienda online. Lo crea la inserción de aplicación antes de que se ejecute el script propio de la app, y eso es lo que hace posibles las sobrescrituras de abajo.
| Propiedad | Qué contiene |
|---|---|
theme | Los selectores que usa la app para encontrar elementos en tu tema. Consulta Selectores del tema |
page.type | El tipo de página de Shopify: product, cart, index, collection, etc. |
product | El producto actual, como JSON de producto de Shopify, más product.collections con los ID de las colecciones a las que pertenece. false fuera de una página de producto |
cart | El carrito actual, como JSON de carrito de Shopify |
customer | id, name, email y tags de un cliente que ha iniciado sesión, o false. Las etiquetas son lo que comparan las reglas de clientes |
curCountryCode | El país del visitante, como código de dos letras. Lo que comparan las reglas de países |
money_format | El formato monetario con el que la app da formato a los precios, que sigue tus ajustes de precio del complemento |
initialize() | Vuelve a ejecutar la app. Consulta Volver a ejecutar la app |
El resto de esta sección
Volver a ejecutar la app
GPOConfigs.initialize() vuelve a ejecutar la app desde el principio. Úsalo cuando algo reemplace el formulario del producto después de que se haya cargado la página: un creador de páginas que intercambia secciones o un tema que vuelve a renderizar el producto al cambiar de variante.
window.GPOConfigs && window.GPOConfigs.initialize();Llámalo después de que el nuevo marcado esté en el DOM, no antes. Si lo llamas cuando nada ha cambiado, las opciones se vuelven a renderizar sin necesidad, así que actívalo desde la propia señal de «sección reemplazada» de tu tema y no con un temporizador.
Notas
- Todo esto necesita la inserción de aplicación activada en el tema publicado. Consulta Activar la inserción de aplicación.
GPOConfigsexiste en todas las páginas en las que se ejecuta la inserción de aplicación, peroproductesfalsefuera de una página de producto.- Sobrescribir selectores no cambia lo que recopilan las opciones, solo dónde encuentra la app los elementos en tu tema.
- Si un tema necesita la misma sobrescritura en todas las tiendas que lo usan, envíanosla en lugar de repetirla en cada tienda. Consulta Contactar con el soporte.
¿Te ha sido útil?
¡Gracias por tu opinión! Cuéntanos qué faltaba
Informar de un problema