Estructura de un tema
Todo tema es una carpeta theme con siete subcarpetas. El layout envuelve todas las páginas, las plantillas deciden qué se renderiza, las secciones hacen editable cada bloque y la configuración guarda los ajustes.
Árbol de un tema
Esta es la forma de un tema completo. Puedes empezar con menos archivos; las carpetas y las siete plantillas marcadas como obligatorias sí deben estar.
theme/
├── layout/
│ └── theme.html.twig # estructura base de todas las páginas
├── templates/
│ ├── index.html.twig # portada
│ ├── index.json # secciones de la portada
│ ├── product.html.twig
│ ├── product.json
│ ├── category.html.twig
│ ├── cart.html.twig
│ ├── page.html.twig
│ ├── blog.html.twig
│ ├── article.html.twig
│ ├── search.html.twig
│ ├── password.html.twig
│ ├── error.html.twig
│ └── customers/ # área de cliente
│ ├── account.html.twig
│ ├── login.html.twig
│ └── login.json
├── sections/ # secciones editables
│ ├── header.html.twig
│ ├── header-group.json
│ ├── main-product.html.twig
│ ├── hero.html.twig
│ └── footer-group.json
├── snippets/ # parciales reutilizables
│ ├── product-card.html.twig
│ ├── pagination.html.twig
│ └── icon.html.twig
├── config/
│ ├── settings_schema.json # qué ajustes se pueden editar
│ └── settings_data.json # valores y presets
├── languages/
│ ├── es.csv
│ └── en.csv
├── assets/
│ ├── theme.css
│ └── app.js
└── thumbnail.png # miniatura del selectorQué hace cada carpeta
| Carpeta | Contenido |
|---|---|
| layout/ | El archivo theme.html.twig: <head>, cabecera, bloque content y pie. Todo tema necesita uno. |
| templates/ | Una plantilla por página. Puede ir sola (.html.twig) o acompañada de un JSON que reparte la página en secciones. |
| sections/ | Secciones editables con su {% schema %}, más los grupos header-group.json y footer-group.json. |
| snippets/ | Parciales que se incluyen desde plantillas y secciones: tarjetas de producto, iconos, paginación… |
| config/ | Esquema y valores de los ajustes del tema. |
| languages/ | Traducciones en CSV, una por idioma. |
| assets/ | CSS, JavaScript, imágenes y fuentes del tema. |
Plantillas de página
Tiendy busca una plantilla con el nombre de la página que va a mostrar:
| Archivo | Página |
|---|---|
| index.html.twig | Portada de la tienda. |
| product.html.twig | Ficha de producto, con variantes e imágenes. |
| category.html.twig | Listado de una categoría. |
| cart.html.twig | Carrito. |
| page.html.twig | Página de contenido (nosotros, condiciones…). |
| blog.html.twig | Listado del blog. |
| article.html.twig | Entrada del blog. |
| search.html.twig | Resultados de búsqueda. |
| password.html.twig | Tienda protegida con contraseña. |
| error.html.twig | Página de error. |
| wishlist.html.twig | Lista de favoritos. |
| page.<handle>.html.twig | Plantilla alternativa para una página concreta: page.about.html.twig solo se usa en la página con handle about. |
| templates/customers/ | Área de cliente: cuenta, direcciones, pedidos, alta, acceso y recuperación de contraseña. |
Qué valida la subida
Al subir el ZIP, Tiendy comprueba que existan estas carpetas y plantillas. Si falta una, rechaza el archivo y no aplica nada:
| Elemento | Tipo |
|---|---|
| theme/assets/ | Carpeta |
| theme/layout/ | Carpeta |
| theme/templates/ | Carpeta |
| theme/templates/index.html.twig | Plantilla |
| theme/templates/page.html.twig | Plantilla |
| theme/templates/product.html.twig | Plantilla |
| theme/templates/cart.html.twig | Plantilla |
| theme/templates/blog.html.twig | Plantilla |
| theme/templates/article.html.twig | Plantilla |
| theme/templates/category.html.twig | Plantilla |
El layout también es obligatorio en la práctica. La validación de la subida no lo exige por nombre, pero sin layout/theme.html.twig no hay página que renderizar. Inclúyelo siempre.
Añade thumbnail.png (por ejemplo 600×450) para que el tema se vea bien en la galería. No es obligatorio para funcionar, pero sí para reconocerlo de un vistazo.