Studio Arcana — Equipo y servicios con metaobjetos
Define metaobjetos de Shopify, crea entradas y enlázalos en las secciones Equipo de especialistas y Menú de servicios.
Las especificaciones a nivel de campo para socios de automatización también están en el monorepo bajo docs/ (por ejemplo studio-arcana-metaobjects.md).
Esta guía explica cómo definir metaobjetos de Shopify, crear entradas y enlazarlos en el tema para las secciones Equipo de especialistas y Menú de servicios. Los metaobjetos mantienen especialistas y servicios en Contenido → Metaobjetos para escalar mucho personal o servicios sin duplicar campos en decenas de bloques del tema. Los bloques manuales (Miembro del equipo, Tarjeta de servicio) siguen disponibles si prefieres editar solo en el editor de temas.
1. Qué ganas
- Contenido central: edita especialistas y servicios en Contenido → Metaobjetos en lugar de duplicar campos en muchos bloques.
- Reutilización: la misma entrada puede referenciarse desde varias secciones o plantillas.
- Escala: un bloque del tema puede listar hasta 50 entradas por selector (sujeto a límites max blocks de otros tipos de bloque).
2. Requisitos previos
- Versión del tema que incluya los bloques de metaobjetos: sección Equipo de especialistas → bloque Equipo (metaobjetos); sección Menú de servicios → bloque Servicios (metaobjetos).
- Acceso de admin a Configuración → Datos personalizados → Metaobjetos y Contenido → Metaobjetos.
- Definiciones de metaobjeto en la tienda con acceso Storefront para que la tienda online pueda leer entradas. Los handles deben incluir studio_specialist y studio_service. Opcional: studio_location — no exigido para estas dos secciones.
Si faltan definiciones o el acceso Storefront está apagado, el editor puede mostrar error en el selector de metaobjetos o la tienda puede mostrar listas vacías.
3. Crear definiciones de metaobjeto (Admin)
Configuración → Datos personalizados → Metaobjetos → Añadir definición.
Para cada tipo, usa el handle de definición y los campos exactamente según tu especificación de implementación (Arcanum Hollow Labs proporciona listas de campos para socios).
| Handle de definición | Nombre sugerido en admin | Acceso Storefront |
|---|---|---|
| studio_specialist | Especialista Studio | Lectura pública |
| studio_service | Servicio Studio | Lectura pública |
Tras guardar cada definición, abre el acceso Storefront y activa lectura pública para la tienda online.
Opcional studio_location: solo si modelas varias ubicaciones con lista de especialistas. Hoy no lo usan los bloques Equipo (metaobjetos) ni Servicios (metaobjetos).
4. Referencia de campos
studio_specialist (Equipo de especialistas)
| Campo | Propósito |
|---|---|
| name | Nombre visible (obligatorio). |
| role | Título o rol. |
| bio | Texto de biografía. |
| photo | Retrato (file_reference). |
| linked_services | Lista de productos de servicio; el tema usa el primero para la URL de reserva cuando Ajustes del tema → URL base de reservas está definida. |
| booking_url | Se usa si no hay URL base de reservas, o como enlace de respaldo. |
| profile_page | Destino de página de perfil (modo clic en toda la tarjeta y CTA explícito de perfil). |
| quick_book_product | Producto de reserva rápida opcional para construir la URL desde Ajustes del tema → URL base de reservas. |
| quick_book_url | URL directa de reserva rápida opcional. |
specialty y years_experience son opcionales; rellénalos si quieres perfiles más ricos o futuras actualizaciones del tema.
studio_service (Menú de servicios)
| Campo | Propósito |
|---|---|
| name | Nombre del servicio (obligatorio). |
| description | Texto enriquecido en Admin; en tienda la tarjeta muestra un extracto plano (HTML eliminado, truncado). |
| service_product | Producto enlazado: precio, imagen destacada y handle de reserva cuando la URL base de reservas está definida. |
| detail_page | URL de página opcional (por ejemplo plantilla de detalle) cuando el enlace de reserva no se construye desde el producto. |
Eyebrow: no hay campo metaobjeto aparte para eyebrow; si Consultation required está activo, la tarjeta muestra el eyebrow traducido. Precio e imagen vienen del producto enlazado cuando service_product está definido. Si la opción de sección Usar foto del producto enlazado cuando no hay imagen está activa, la imagen destacada viene de ese producto.
5. Crear entradas
Contenido → Metaobjetos → elige Especialista Studio / Servicio Studio → Añadir entrada.
Rellena campos y sube imágenes. Guarda cada entrada. Si las definiciones usan estado publicable, asegúrate de que las entradas estén activas en la tienda.
6. Conectar el tema (editor OS 2.0)
- Abre la plantilla que contiene Equipo de especialistas o Menú de servicios (a menudo la home).
- Añadir bloque → Equipo (metaobjetos) o Servicios (metaobjetos).
- En el bloque, abre Especialistas / Servicios y selecciona las entradas en el orden deseado.
- Guarda y previsualiza la tienda.
Orden de bloques: los bloques de lista de metaobjetos y los manuales aparecen juntos en la lista de la sección; ordénalos como cualquier bloque. Puedes usar solo metaobjetos, solo manuales o ambos (vigila el máximo de bloques por sección).
7. Reservas y enlaces
- Ajustes del tema → URL base de reservas y clave de parámetro siguen controlando enlaces por query cuando hay producto (linked_services / service_product).
- Enlace de perfil del especialista: profile_page si está definido; si no, comportamiento de reserva/enlace existente.
- Reserva rápida del especialista: quick_book_product (URL de reserva del tema desde handle) o quick_book_url.
- Interacción de tarjeta: con reserva rápida hay botones Ver perfil y Reserva rápida; sin ella, toda la tarjeta enlaza al perfil.
- Servicio: service_product más detail_page opcional para URL estática cuando la reserva no sale del producto.
8. Bloques manuales como alternativa
Los bloques Miembro del equipo y Tarjeta de servicio no están obsoletos. Úsalos si no quieres definiciones de metaobjeto en la tienda. Evita borrar definiciones cuando ya hay entradas; prueba cambios en un tema duplicado o de desarrollo primero.
9. Resolución de problemas
| Problema | Qué revisar |
|---|---|
| Error en el selector de metaobjetos en el editor | El handle debe ser exactamente studio_specialist o studio_service. Las definiciones deben existir en esta tienda. |
| Selector vacío | Crea entradas en Contenido → Metaobjetos. |
| La tienda no muestra tarjetas | Acceso Storefront en definiciones; estado activo si es publicable; productos/páginas referenciados deben existir. |
| Enlace incorrecto o ausente | URL base de reservas, service_product / linked_services, detail_page en servicios y booking_url en especialistas. |
| La descripción se ve plana | La descripción en metaobjeto es rich text; el tema muestra a propósito un extracto plano breve como en tarjetas manuales. |
10. Más lectura
- Especificaciones de campos y scripts de seed están en la carpeta docs/ del monorepo Arcanum (studio-arcana-metaobjects.md, studio-arcana-theme.md) para desarrolladores y socios de automatización.
¿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.