Ir al contenido
Instalar la app
Español

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.

PropiedadQué contiene
themeLos selectores que usa la app para encontrar elementos en tu tema. Consulta Selectores del tema
page.typeEl tipo de página de Shopify: product, cart, index, collection, etc.
productEl 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
cartEl carrito actual, como JSON de carrito de Shopify
customerid, name, email y tags de un cliente que ha iniciado sesión, o false. Las etiquetas son lo que comparan las reglas de clientes
curCountryCodeEl país del visitante, como código de dos letras. Lo que comparan las reglas de países
money_formatEl 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.
  • GPOConfigs existe en todas las páginas en las que se ejecuta la inserción de aplicación, pero product es false fuera 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?

Informar de un problema