Configuración de metacampos y metaobjetos
Las funciones para muebles de Tenora leen los datos de producto de metacampos y metaobjetos. Esta página te muestra cómo crearlos, paso a paso, con los nombres y los tipos exactos que espera el tema.
- Un metacampo es un campo adicional de un producto, por ejemplo "Ancho".
- Un metaobjeto es una entrada reutilizable con sus propios campos, por ejemplo un material llamado "Roble macizo" con una imagen e instrucciones de cuidado.
Configuras las definiciones una sola vez. Después, completas los valores de cada producto.
Antes de empezar
- Escribe cada espacio de nombres (namespace) y cada clave exactamente como se muestran, en minúsculas y con guiones bajos. El tema lee estos nombres exactos. Una pequeña diferencia, como
specs.Widthospec.width, hace que el tema no encuentre el valor. - Crea primero la definición del metaobjeto "Material". El metacampo
specs.materialsla necesita. - Si un valor está vacío, el bloque correspondiente se oculta en la página de producto. Puedes completar tus productos poco a poco.
| Función | Metacampos que lee |
|---|---|
| Medidas | specs.width, specs.depth, specs.height, specs.seat_height, specs.weight |
| ¿Cabe? | specs.width, specs.depth, specs.height (se necesitan los tres) |
| Materiales y cuidados | specs.materials y el metaobjeto "Material" |
| Pedir una muestra | specs.sample_product (o la opción Producto de muestra del bloque) |
| Entrega y montaje | delivery.lead_time, delivery.method, delivery.assembly_required, delivery.assembly_guide |
Primero, revisa el sistema de unidades de tu tienda
Los metacampos de dimensión y de peso usan el sistema de unidades de tu tienda como unidad predeterminada.
- En el panel de control de Shopify, ve a Configuración (Settings) → General.
- Busca Valores predeterminados de la tienda (Store defaults) → Sistema de unidades (Unit system).
- Comprueba si está configurado en el sistema métrico o en el imperial.
Si tu tienda usa el sistema imperial, el panel de control selecciona pulgadas y onzas de forma predeterminada. Un valor que escribes como 220 se guarda entonces como 220 in, a menos que cambies la unidad junto al campo. El tema convierte las unidades correctamente, pero los números no serán los que querías.
Consejo: Revisa siempre la unidad junto al valor antes de guardar un producto.
El bloque Medidas siempre muestra centímetros y pulgadas, y kilogramos y libras, sin importar cuál de las unidades admitidas usaste en el panel de control (mm, cm, m, in, ft o yd para longitudes; g, kg, lb u oz para el peso). Los clientes pueden cambiar de unidad, y su elección se recuerda en su dispositivo.
Paso 1: Crea la definición del metaobjeto "Material"
En el panel de control de Shopify, ve a Configuración → Datos personalizados (Custom data).
En Metaobjetos, selecciona Agregar definición.
Introduce el Nombre:
Material.Revisa el Tipo. Shopify lo completa a partir del nombre. Debe ser exactamente
material.Selecciona Agregar campo y agrega estos cuatro campos:
Nombre del campo Clave Tipo Opciones Nombre nameTexto de una sola línea Marcar como obligatorio Imagen imageArchivo, con solo Imágenes permitidas Un archivo Descripción descriptionTexto de varias líneas Instrucciones de cuidado care_instructionsTexto de varias líneas En las opciones de acceso, activa el acceso de Tiendas online (Storefronts). Sin él, el tema no puede leer el material.
Deja desactivada la opción Estado activo-borrador (Active-draft status). Si la activas, debes poner cada entrada de material en Activo; si no, no aparecerá en tu tienda.
Opcional: define Nombre como nombre para mostrar, para encontrar las entradas fácilmente en las listas.
Selecciona Guardar.
Paso 2: Agrega tus materiales
En el panel de control de Shopify, ve a Contenido → Metaobjetos.
Selecciona Material.
Selecciona Agregar entrada.
Completa los campos. Por ejemplo:
Nombre Descripción Instrucciones de cuidado Roble macizo Roble europeo con certificación FSC y acabado de aceite natural. Limpia con un paño suave y seco. Vuelve a aceitar una vez al año. Evita el calor directo. Mezcla de lino 55% lino, 45% algodón. Fundas extraíbles y prelavadas. Las fundas se pueden lavar a 30°C. Seca al aire y plancha mientras estén húmedas. Ratán natural Ratán tejido a mano sobre una estructura de madera maciza. Quita el polvo con un cepillo suave. Mantén lejos de radiadores y del sol directo. Agrega una Imagen para cada material, como un primer plano de la madera o de la tela. Una imagen cuadrada funciona mejor.
Selecciona Guardar.
Consejos
- En el diseño Tarjetas, el bloque solo muestra la primera frase de la descripción. Pon la información más importante en la primera frase.
- Los saltos de línea de la descripción y de las instrucciones de cuidado se mantienen.
- Un material sin nombre no se muestra.
Paso 3: Crea las definiciones de metacampos de producto
- En el panel de control de Shopify, ve a Configuración → Datos personalizados.
- En Metacampos, selecciona Productos.
- Selecciona Agregar definición.
- Introduce el Nombre y, después, el Espacio de nombres y clave (Namespace and key) exactamente como se muestran abajo, con el punto (por ejemplo
specs.width). - Selecciona el Tipo y las opciones de la tabla.
- Asegúrate de que el acceso de Tiendas online (Storefronts) esté activado. Suele estar activado de forma predeterminada.
- Selecciona Guardar.
- Repite para cada fila de la tabla.
| Nombre | Espacio de nombres y clave | Tipo | Opciones |
|---|---|---|---|
| Ancho | specs.width | Dimensión | Un valor |
| Profundidad | specs.depth | Dimensión | Un valor |
| Altura | specs.height | Dimensión | Un valor |
| Altura del asiento | specs.seat_height | Dimensión | Un valor |
| Peso | specs.weight | Peso | Un valor |
| Materiales | specs.materials | Metaobjeto; después, selecciona Material | Lista de entradas |
| Producto de muestra | specs.sample_product | Producto | Un producto |
| Plazo de entrega | delivery.lead_time | Texto de una sola línea | Un valor |
| Método de entrega | delivery.method | Texto de una sola línea | Un valor. Opcional: Limitar a opciones predefinidas (Limit to preset choices), por ejemplo Standard delivery, White-glove delivery, Flat-pack delivery |
| Montaje necesario | delivery.assembly_required | Verdadero o falso | |
| Guía de montaje | delivery.assembly_guide | Archivo | Permitir archivos PDF (o todos los tipos de archivo) |
Notas
specs.materialstambién puede ser una sola entrada (Una entrada) en lugar de una lista. El tema admite ambas opciones. Te recomendamos una lista, para que un producto pueda tener varios materiales.- Los nombres de la columna Nombre solo se muestran en el panel de control. Puedes traducirlos o cambiarlos. El espacio de nombres y la clave deben quedar exactamente como se muestran.
- Consejo: Activa Fijar en las páginas de productos (Pin to product pages) cuando crees una definición. Así, los campos aparecen directamente en cada página de producto del panel de control.
Paso 4: Completa tus productos
En el panel de control de Shopify, ve a Productos y abre un producto.
Desplázate hasta Metacampos.
Completa los campos de este producto. Por ejemplo, para un sofá:
Metacampo Valor de ejemplo Ancho 220 cm Profundidad 95 cm Altura 82 cm Altura del asiento 44 cm Peso 68 kg Materiales Roble macizo, Mezcla de lino Producto de muestra Set de muestras de tela Plazo de entrega Hecho por encargo, se envía en 6–8 semanas Método de entrega Entrega con servicio premium Montaje necesario Falso Guía de montaje Un archivo PDF Revisa la unidad de cada dimensión y de cada peso antes de guardar.
Selecciona Guardar.
Abre el producto en tu tienda online y revisa los bloques Medidas, Materiales y cuidados, Pedir una muestra y Entrega y montaje.
Qué pasa con datos parciales
No necesitas completar todos los campos. Por ejemplo, si un producto solo tiene ancho, altura y plazo de entrega:
- La tabla de medidas muestra solo el ancho y la altura.
- El dibujo se muestra, porque solo necesita el ancho y la altura.
- "¿Cabe?" se oculta, porque también necesita la profundidad.
- Los bloques Materiales y cuidados y Pedir una muestra se ocultan (a menos que el bloque Pedir una muestra tenga un Producto de muestra configurado en el editor de temas).
- El bloque Entrega y montaje muestra solo el plazo de entrega.
Importar valores de metacampos con un archivo CSV
Si tienes muchos productos, puedes completar los metacampos con la importación de productos por CSV de Shopify. Crea las definiciones de metacampos (paso 3) antes de exportar o importar. Así, el CSV tiene una columna para cada definición.
En el panel de control de Shopify, ve a Productos y selecciona Exportar para obtener un archivo CSV con tus productos actuales.
Abre el archivo en un programa de hojas de cálculo. Busca las columnas de metacampos. Sus nombres incluyen el espacio de nombres y la clave, por ejemplo:
Width (product.metafields.specs.width)Weight (product.metafields.specs.weight)Materials (product.metafields.specs.materials)
Completa los valores:
Columna Valor de ejemplo Nota Width, Depth, Height, Seat height 180cmUn número y una unidad Weight 58 kgUn número y una unidad Materials solid-oak; linen-blendIdentificadores de las entradas de material, separados por punto y coma y un espacio Lead time Made to order, ships in 6–8 weeksTexto sin formato Assembly required TRUEoFALSEGuarda el archivo como CSV (UTF-8).
En Productos, selecciona Importar, elige el archivo y sigue los pasos.
Después de la importación, abre algunos productos y revisa los valores y las unidades.
Consejos
- Importa primero un archivo de prueba pequeño con dos o tres productos.
- El identificador (handle) de un material se muestra en la entrada del material en Contenido → Metaobjetos → Material. Suele ser el nombre en minúsculas y con guiones, por ejemplo
solid-oak. - Incluye siempre la unidad en los valores de dimensión y de peso. Sin unidad, el valor puede interpretarse en la unidad predeterminada de tu tienda.
Traducir los datos de producto
Si tu tienda tiene más de un idioma, traduce los valores de texto (materiales, plazos de entrega y métodos de entrega) con las herramientas de traducción de Shopify, igual que las descripciones de producto. Las etiquetas que agrega el tema, como "Ancho", "Cuidados" y "Requiere algo de montaje", ya están traducidas. Consulta Vender a nivel internacional.
Solución de problemas
| Problema | Qué revisar |
|---|---|
| Un bloque no aparece | El espacio de nombres y la clave son exactamente como se muestran, el acceso de Tiendas online está activado y el producto tiene un valor. Además, el bloque está en la plantilla de producto que usa el producto. |
| Los materiales no aparecen | La entrada del material tiene un Nombre. Si la definición usa Estado activo-borrador, la entrada está en Activo. |
| Las medidas son incorrectas | La unidad junto a cada valor. Revisa el sistema de unidades de tu tienda. |
| "¿Cabe?" no aparece | El ancho, la profundidad y la altura tienen valor, y Mostrar asistente de medidas está activado en el bloque Medidas. |
| La muestra no aparece | El producto de muestra está activo y disponible en el canal de ventas Tienda online. La muestra no es el propio producto. |
Para obtener más ayuda, consulta Preguntas frecuentes.