← Arcanum HollowDocs · 1.3.0

Configuracion de metaobjetos para lookbook

Crea el metaobjeto lookbook_look, añade entradas y conectalas con la seccion Lookbook en el editor del tema.

Usa esta guia cuando quieras gestionar el contenido del Lookbook desde Contenido en Shopify en vez de solo bloques manuales. La seccion Lookbook soporta ambos modos, asi que puedes migrar de forma gradual.

1. Requisitos previos

  • Version del tema con modo de origen en Lookbook que incluya bloques manuales y render de metaobjetos.
  • Acceso de admin a Configuracion -> Datos personalizados -> Metaobjetos y Contenido -> Metaobjetos.
  • Acceso Storefront habilitado en la definicion lookbook_look.

2. Crear la definicion

Admin de Shopify: Configuracion -> Datos personalizados -> Metaobjetos -> Anadir definicion.

CampoValor
NombreLookbook Look
Tipo (API)lookbook_look
Acceso StorefrontLectura publica habilitada

3. Campos recomendados

ClaveTipoObligatorioProposito
imageArchivo (imagen unica)SiMedia principal de cada tarjeta de look.
titleTexto de una lineaSiTitulo principal que se muestra en overlay/tarjetas.
subtitleTexto de una lineaNoCopy secundario para contexto del look.
descriptionTexto multilineaNoTexto editorial mas largo para overlays.
cta_labelTexto de una lineaNoEtiqueta opcional de CTA en overlay.
urlURLNoDestino al pulsar la tarjeta del look.
productsLista de referencias de productoNoProductos del shop-the-look (se recomiendan hasta 3).
categoryTexto de una lineaNoTaxonomia de filtro opcion 1.
moodTexto de una linea O referencia a metaobjetoNoTaxonomia de filtro opcion 2. Soporta texto plano y registros de mood referenciados.
service_typeTexto de una lineaNoTaxonomia de filtro opcion 3.
featuredVerdadero/falsoNoPrioriza looks clave cuando se activa orden destacado en ajustes de seccion.

4. Crear entradas

Admin de Shopify: Contenido -> Metaobjetos -> Lookbook Look -> Anadir entrada.

  • Como minimo rellena image y title para que el look renderice correctamente.
  • Rellena products para habilitar chips comprables y quick add.
  • Usa valores de taxonomia consistentes (por ejemplo hair, skin, ritual) para que los filtros agrupen bien.
  • Marca featured=true en looks que quieras priorizar cuando actives orden de destacados.

5. Conectarlo en el editor del tema

  1. Abre la pagina/plantilla que contiene la seccion Lookbook.
  2. Define Source mode como Metaobject lookbook_look entries.
  3. Define Taxonomy field en Category, Mood o Service type segun lo que rellenaste en entradas.
  4. Opcional: activa Shop the look, Quick add, Filters y Load more.
  5. Opcional: define Featured look ordering en Show featured looks first.

6. Verificar comportamiento

  • Las tarjetas de lookbook se renderizan cuando hay entradas y acceso Storefront habilitado.
  • Los filtros muestran solo valores presentes y filtran correctamente los looks visibles.
  • Load more revela mas looks coincidentes sin recargar la pagina.
  • Quick add solo aparece en productos disponibles con una variante por defecto.

7. Resolucion de problemas

ProblemaQue revisar
No se renderizan looks en modo metaobjetoEl tipo API de la definicion debe ser exactamente lookbook_look y el acceso Storefront debe estar habilitado.
Los filtros no muestran opciones utilesRellena category, mood o service_type de forma consistente en las entradas y selecciona la taxonomia correspondiente en ajustes de la seccion.
Quick add no aparece en chipsQuick add solo se muestra para productos disponibles con una variante por defecto y con el ajuste Enable quick add activo.
El orden destacados primero no cambiaDefine featured=true en una o mas entradas y en la seccion usa Featured look ordering = featured_first.
  • Section library para ubicar Lookbook dentro del stack de merchandising.
  • JavaScript events para senales analiticas emitidas por interacciones del lookbook.

¿Te resultó útil esta página?

El contenido lo mantiene Arcanum Hollow Labs. Para notas internas de ingeniería, consulta la carpeta docs/ del monorepo.