Tiendy Documentación
Plantillas

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ónPlantilla
Portadatemplates/index.html.twig
Productotemplates/product.html.twig
Categoríatemplates/category.html.twig
Blog y entradatemplates/blog.html.twig · templates/article.html.twig
Área de clientetemplates/customers/<acción>.html.twig
Página con contraseñatemplates/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:

EtiquetaQué 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:

NombrePara qué
moneyFormatea un precio con el formato de la tienda.
asset_url · versioned_asset_url · upload_urlConstruyen la URL de un activo del tema, con versión o de un archivo subido.
asset_exists · asset_imagesizeComprueban si un activo existe y obtienen sus dimensiones.
product_img_url · category_img_urlURL de imagen de producto o de categoría.
link_to · link_to_page · link_to_tag · link_to_type · link_to_manufacturerConstruyen enlaces internos a recursos de la tienda.
truncate · strip_tags · nl2br · regex_replaceTransforman texto.
handleizeConvierte un texto en un identificador URL.
date_formatFormatea una fecha según el idioma de la tienda.
pluralizeElige singular o plural según un número.
json · json_decodeSerializa 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.