Plantillas y herencia
Todas las páginas extienden layout/theme.html.twig y rellenan el bloque content. Tiendy resuelve qué plantilla corresponde a cada petición y las secciones se insertan con etiquetas propias del motor.
Herencia: el layout y sus bloques
El layout define tres bloques. La cabecera y el pie no se escriben en cada plantilla: se delegan a grupos de secciones.
{% block theme_header %}{% sections 'header-group' %}{% endblock theme_header %}
<main id="main">
{% block content %}{% layout %}{% endblock content %}
</main>
{% block theme_footer %}{% sections 'footer-group' %}{% endblock theme_footer %}Una plantilla de página solo declara la herencia y el contenido. Por ejemplo, una portada:
{% extends "theme.html.twig" %}
{% block content %}
{% template_sections %}
{% endblock content %}Qué hace {% layout %}. Dentro del bloque content, la etiqueta inserta la vista que resuelve el controlador cuando la plantilla no la sustituye. Es el puente entre Twig y las páginas que aún se renderizan fuera de él.
Cómo se resuelve cada página
La plantilla se busca por el nombre del controlador con el sufijo del tema (.html.twig en modo Twig):
| Petición | Plantilla |
|---|---|
| Portada | templates/index.html.twig |
| Producto | templates/product.html.twig |
| Categoría | templates/category.html.twig |
| Blog y entrada | templates/blog.html.twig · templates/article.html.twig |
| Área de cliente | templates/customers/<acción>.html.twig |
| Página con contraseña | templates/password.html.twig, renderizada en la misma URL |
Puedes empezar con las siete plantillas obligatorias y añadir las demás a medida que personalices cada página.
Parciales: snippets
Los fragmentos reutilizables viven en snippets/ y se incluyen con parámetros:
{% include 'snippets/icon.html.twig' with {'name': 'close'} %}Las plantillas de una página pueden pasar datos al parcial igual que cualquier include de Twig. Los snippets no tienen esquema ni ajustes: son marcado con variables.
Etiquetas disponibles
Además de las etiquetas estándar de Twig, el motor de Tiendy registra estas:
| Etiqueta | Qué hace |
|---|---|
| {% layout %} | Inserta la vista resuelta por el controlador dentro del layout. |
| {% sections 'grupo' %} | Renderiza un grupo de secciones (por ejemplo header-group). |
| {% template_sections %} | Renderiza las secciones declaradas en el JSON de la plantilla actual. |
| {% schema %} … {% endschema %} | Declara el esquema JSON de una sección. |
| {% translate %} … {% endtranslate %} | Marca una cadena como traducible. Alias: {% trans %} y filtro |trans. |
| {% paginate … %} | Pagina un listado. Se acompaña de pagination_control. |
| {% form … %} | Genera formularios con los campos y la protección de Tiendy. |
| {% captcha %} · {% recaptcha %} | Inserta la protección anti-spam configurada en la tienda. |
| {% youtube … %} | Incrusta un vídeo de YouTube. |
| {% set %} | Asigna variables dentro de la plantilla. |
Filtros y funciones
Los que más se usan al escribir un tema:
| Nombre | Para qué |
|---|---|
| money | Formatea un precio con el formato de la tienda. |
| asset_url · versioned_asset_url · upload_url | Construyen la URL de un activo del tema, con versión o de un archivo subido. |
| asset_exists · asset_imagesize | Comprueban si un activo existe y obtienen sus dimensiones. |
| product_img_url · category_img_url | URL de imagen de producto o de categoría. |
| link_to · link_to_page · link_to_tag · link_to_type · link_to_manufacturer | Construyen enlaces internos a recursos de la tienda. |
| truncate · strip_tags · nl2br · regex_replace | Transforman texto. |
| handleize | Convierte un texto en un identificador URL. |
| date_format | Formatea una fecha según el idioma de la tienda. |
| pluralize | Elige singular o plural según un número. |
| json · json_decode | Serializa o lee JSON desde la plantilla. |
Los nombres viven dos veces en el motor: como variables ({{ asset_url }}) y como filtros ({{ 'theme.css'|asset_url }}). Usa el filtro cuando construyas la ruta desde una cadena.