Tiendy Documentación
Plantillas

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 selector

Qué hace cada carpeta

CarpetaContenido
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:

ArchivoPágina
index.html.twigPortada de la tienda.
product.html.twigFicha de producto, con variantes e imágenes.
category.html.twigListado de una categoría.
cart.html.twigCarrito.
page.html.twigPágina de contenido (nosotros, condiciones…).
blog.html.twigListado del blog.
article.html.twigEntrada del blog.
search.html.twigResultados de búsqueda.
password.html.twigTienda protegida con contraseña.
error.html.twigPágina de error.
wishlist.html.twigLista de favoritos.
page.<handle>.html.twigPlantilla 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:

ElementoTipo
theme/assets/Carpeta
theme/layout/Carpeta
theme/templates/Carpeta
theme/templates/index.html.twigPlantilla
theme/templates/page.html.twigPlantilla
theme/templates/product.html.twigPlantilla
theme/templates/cart.html.twigPlantilla
theme/templates/blog.html.twigPlantilla
theme/templates/article.html.twigPlantilla
theme/templates/category.html.twigPlantilla

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.