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.
| Campo | Valor |
|---|---|
| Nombre | Lookbook Look |
| Tipo (API) | lookbook_look |
| Acceso Storefront | Lectura publica habilitada |
3. Campos recomendados
| Clave | Tipo | Obligatorio | Proposito |
|---|---|---|---|
| image | Archivo (imagen unica) | Si | Media principal de cada tarjeta de look. |
| title | Texto de una linea | Si | Titulo principal que se muestra en overlay/tarjetas. |
| subtitle | Texto de una linea | No | Copy secundario para contexto del look. |
| description | Texto multilinea | No | Texto editorial mas largo para overlays. |
| cta_label | Texto de una linea | No | Etiqueta opcional de CTA en overlay. |
| url | URL | No | Destino al pulsar la tarjeta del look. |
| products | Lista de referencias de producto | No | Productos del shop-the-look (se recomiendan hasta 3). |
| category | Texto de una linea | No | Taxonomia de filtro opcion 1. |
| mood | Texto de una linea O referencia a metaobjeto | No | Taxonomia de filtro opcion 2. Soporta texto plano y registros de mood referenciados. |
| service_type | Texto de una linea | No | Taxonomia de filtro opcion 3. |
| featured | Verdadero/falso | No | Prioriza 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
- Abre la pagina/plantilla que contiene la seccion Lookbook.
- Define Source mode como Metaobject lookbook_look entries.
- Define Taxonomy field en Category, Mood o Service type segun lo que rellenaste en entradas.
- Opcional: activa Shop the look, Quick add, Filters y Load more.
- 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
| Problema | Que revisar |
|---|---|
| No se renderizan looks en modo metaobjeto | El tipo API de la definicion debe ser exactamente lookbook_look y el acceso Storefront debe estar habilitado. |
| Los filtros no muestran opciones utiles | Rellena 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 chips | Quick 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 cambia | Define featured=true en una o mas entradas y en la seccion usa Featured look ordering = featured_first. |
8. Documentacion relacionada
- 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.