Guía del tema Lumen
Lumen es un tema Online Store 2.0 diseñado para tiendas de equipo nuevo y usado, con componentes dedicados a condición del producto, especificaciones técnicas y flujos de canje. Esta guía cubre todo lo necesario, desde la instalación hasta el lanzamiento.
Resumen
Lumen incluye todas las secciones y plantillas necesarias para una tienda completa: inicio, colección, producto, carrito, búsqueda, 404, páginas de cuenta de cliente, blog y tarjetas de regalo. Cada color, fuente y radio de esquina está expuesto como ajuste del tema: es posible un rediseño completo sin tocar código.
Las páginas de producto incluyen una insignia de condición, una etiqueta de garantía, una pestaña de especificaciones técnicas, una pestaña editorial de "veredicto" y una venta cruzada opcional hacia el equivalente usado del mismo producto. Todo se gestiona mediante metacampos de producto, descritos más abajo.
Primeros pasos
Sigue estos pasos en orden después de instalar Lumen en tu tienda.
- Elige un estilo (Default, Midnight o Editorial) en la galería al instalar, o cámbialo después (ver Estilos del tema).
- Sustituye textos de demostración, imágenes y estadísticas (ver Contenido de demostración).
- Crea los metacampos de producto que necesite tu catálogo (ver Metacampos).
- Completa tus políticas legales para que aparezcan los enlaces del pie de página (ver Páginas legales).
- Opcional: conecta una app de reseñas, activa el comparador de productos, configura los filtros de colección.
- Realiza un pedido de prueba real en escritorio y móvil antes de publicar.
Contenido de demostración
Cada sección con texto de relleno o estadísticas inventadas tiene una nota de aviso en la parte superior de sus ajustes en el Editor de temas. Búscalas y sustituye el contenido antes del lanzamiento. No publiques recuentos de reseñas, testimonios o afirmaciones de servicio inventados.
- Cabecera / pie de página: nombre de la tienda, eslogan, dirección, datos legales/razón social.
- Hero (inicio): titular, texto, los tres números estadísticos (envío, garantía, puntuación de reseñas).
- Banda de beneficios (inicio): las tres columnas de garantías de servicio.
- Testimonios (inicio): nombres, citas y valoraciones son de relleno.
- Canje (inicio): tiempos y detalles del servicio de canje.
custom.specs_text, cita y cuerpo del veredicto) aceptan texto simple, no JSON (ver Metacampos para el formato exacto a usar en tu catálogo).Metacampos
Crea estos metacampos en Admin → Configuración → Datos personalizados → Productos, con las claves exactas de abajo (espacio de nombres custom). El tema ya los lee con estos nombres. Si falta un metacampo, la sección que lo usa simplemente queda oculta: comportamiento esperado, no un error.
| Clave | Tipo | Uso |
|---|---|---|
custom.condizione | Texto de una línea | Insignia de condición en tarjeta y página de producto, ej. "Usado · A-", "Nuevo precintado". |
custom.nota_stato | Texto de una línea | Primera línea de metadatos de la tarjeta, ej. "12.400 disparos", "Precintado". |
custom.innesto | Texto de una línea | Montura (RF, E, Z, X, L, M), también usado como valor del filtro de colección "Montura". |
custom.garanzia_label | Texto de una línea | Insignia de garantía en la página de producto. |
custom.rating | Texto de una línea | Valoración mostrada en los metadatos del producto, ej. "4,9". |
custom.review_count | Número entero | Recuento de reseñas estático, mostrado hasta que se añade un bloque de app (ver Reseñas de producto). |
custom.usato_correlato | Referencia a producto | Enlaza un producto nuevo con su equivalente usado, para el recuadro "También disponible usado". |
custom.specs_text | Texto multilínea | Tabla de especificaciones. Una línea por especificación, formato Etiqueta: Valor, por ejemplo Sensor: CMOS full-frame, 24 MP. Texto simple, no JSON: editable a mano o vía importación CSV. |
custom.verdict_quote | Texto de una línea | Cita breve en la pestaña "Nuestro veredicto". Si está vacía, la pestaña no aparece. |
custom.verdict_body | Texto multilínea | Texto completo del veredicto, debajo de la cita. |
Etiqueta: Valor para que el personal de la tienda pueda editar las especificaciones directamente desde el Admin de Shopify sin escribir JSON.Estilos del tema
Lumen incluye tres estilos predefinidos listos para usar. Elige uno en la galería de estilos al añadir el tema por primera vez, o aplica otro más tarde desde los preajustes guardados del Editor de temas.
Default
Look cálido y editorial, inspiración heritage. Playfair Display + Inter, esquinas rectas.
Midnight
Look oscuro de estudio. Fraunces + Work Sans, esquinas suaves.
Editorial
Look claro, moderno, sin serifas. Work Sans + Inter, esquinas redondeadas.
Cada color, las tres fuentes, el ancho del contenedor y el radio de las esquinas se pueden editar individualmente en la configuración del tema. Un estilo es solo un punto de partida, no una limitación.
Reseñas de producto
La pestaña "Reseñas" de la página de producto muestra un recuento estático de custom.review_count (o un mensaje de "aún sin reseñas") hasta que conectes una app de reseñas. Para pasar a reseñas reales: instala una app (Judge.me, Loox, Ryviu, etc.), luego añade su bloque de app a la sección Product tabs en el Editor de temas. Una vez presente el bloque de app, tiene prioridad y el recuento estático deja de mostrarse.
Comparador de productos
Una función opcional de comparación lado a lado (icono en tarjetas y página de producto, barra de comparación, página dedicada) está desactivada por defecto y no requiere metacampos.
- Configuración del tema → Product comparison → activa
Enable product comparison. - Crea una página con la plantilla
page.compare. - Selecciona esa página en el ajuste
Compare page.
El estado de la selección se guarda en el navegador del visitante (localStorage); no hay backend ni metacampos implicados.
Filtros de colección
Los filtros "Condición" y "Montura" en la barra lateral de colección se renderizan de forma genérica desde el objeto nativo collection.filters de Shopify. Para que aparezcan, configura filtros de producto en la app Search & Discovery basados en custom.innesto y una etiqueta o metacampo de condición de tu elección.
Páginas legales
Los enlaces del pie de página solo se muestran cuando existe la política correspondiente, así que nunca hay enlaces rotos:
- Privacidad / Términos: leídos de
shop.privacy_policy/shop.terms_of_service. Complétalos en Admin → Configuración → Políticas. - Política de cookies: opcional, basada en una página con el handle
cookie(Shopify no tiene un objeto nativo para la política de cookies).
Idiomas
Las cadenas de interfaz de la tienda (botones, etiquetas, carrito, búsqueda, cuenta, tarjeta de regalo) vienen traducidas en cuatro idiomas: italiano (predeterminado), inglés, español y francés. Activa los que necesites en Admin → Configuración → Idiomas.
Las etiquetas propias del Editor de temas (nombres de secciones y ajustes) también están traducidas en los mismos cuatro idiomas: un comerciante con el Admin en italiano, inglés, español o francés ve un editor traducido, no solo una tienda traducida.
El contenido que escribes en el Editor de temas (textos de hero, bloques, metacampos) no pasa por estos archivos. Tradúcelo con la app nativa de Shopify Translate & Adapt, que detecta automáticamente el contenido de secciones, bloques y metacampos.
Para añadir otro idioma: duplica los archivos de idioma correspondientes (interfaz y, si es necesario, etiquetas del editor) con el código ISO correcto y traduce cada clave.
Limitaciones conocidas
- Los estados hover siguen una regla coherente en todo el tema (aclarado ~8% / cambio al tono accent-bright) en lugar de estar dirigidos artísticamente por componente.
- Los filtros de colección (Condición / Montura) solo se rellenan tras configurar Search & Discovery. El tema renderiza lo que esa app proporciona.
- La pestaña de reseñas muestra un recuento estático hasta que se añade un bloque de app, como se describió antes.
- Los enlaces legales del pie dependen de las políticas completadas en Admin → Configuración → Políticas; hasta entonces, permanecen ocultos en lugar de rotos.
Preguntas frecuentes
¿Puedo cambiar de estilo después de instalar el tema?
Sí. Duplica el tema publicado, vuelve a aplicar un preajuste distinto desde el Editor de temas, revísalo y publica cuando esté listo.
¿Qué pasa si no creo los metacampos de producto?
Nada se rompe. Cualquier sección que dependa de un metacampo ausente simplemente se omite o se muestra vacía. No hay errores en la tienda.
¿Necesito la función de comparador de productos?
No, es opcional y está desactivada por defecto. Actívala solo si quieres ofrecer una comparación lado a lado.
¿Puedo añadir un idioma además de italiano, inglés, español y francés?
Sí, duplica los archivos de idioma correspondientes con el nuevo código ISO y traduce cada clave, tanto para la tienda como para las etiquetas del Editor de temas.
Soporte
Para preguntas no cubiertas en esta guía, escribe a hello@digreg.dev.