Tiendy Documentación
Plantillas

Variables de plantilla

Cada petición inyecta un conjunto de variables globales y, según la página, los objetos de su recurso. Esta es la lista completa de lo que puedes leer desde Twig, con el atributo que cada plantilla usa de verdad.

Variables globales

Se asignan en Tienda::setupView(), antes de renderizar cualquier plantilla:

VariableContenido
shopDatos de la tienda: nombre, URL, idioma, moneda y formato de precio.
cartCarrito actual: artículos, totales, descuento y URL.
customerCliente autenticado. Es null si nadie ha iniciado sesión.
categoriesCategorías de la tienda, accesibles por handle: categories['catalogo'].
linklistsMenús de enlaces configurados en la tienda.
pagesPáginas de contenido publicadas.
blogsBlogs de la tienda.
settingsAjustes del tema, leídos de settings_data.json.
templateNombre de la plantilla que se está renderizando.
wishlist · wishlist_state · wishlist_product_idsLista de favoritos y el estado por variante.
asset_url · tiendy_asset_url · uploads_url · theme_urlRutas base de activos del tema, activos de Tiendy y archivos subidos.
_get · _post · _serverParámetros de la petición. Incluye _server.mobile_detect.
design_modeVerdadero cuando la página se renderiza dentro del editor de temas.

Variables por página

Además de las globales, cada controlador añade las suyas:

PáginaVariables
productproduct
categorycategory, listing_filters, current_tags
cartcart
pagepage
blog y articleblog, article, form (comentarios)
searchq, search_*
indexpage_title, canonical_url, messages
accountorder, order_page, address, files
wishlistproducts
errorerror
passwordpassword_page

shop

shop.name
Nombre de la tienda.
shop.url
URL base de la tienda, con el prefijo de idioma cuando corresponde.
shop.url_without_lang
La misma URL sin el prefijo de idioma.
shop.description
Descripción de la tienda.
shop.domain · shop.email · shop.phone
Dominio y datos de contacto.
shop.current_language
Idioma activo de la visita.
shop.languages
Idiomas disponibles en la tienda.
shop.currency
Código de la moneda.
shop.money_format
Patrón de formato de precio. Lo usa el filtro money.
shop.generation
Versión de la tienda. Se usa para invalidar la caché de activos.
shop.customer_accounts_enabled · shop.customer_accounts_optional
Configuración de las cuentas de cliente.
shop.vendors · shop.types
Fabricantes y tipos disponibles para filtrar.

product

Disponible en la ficha de producto y en las tarjetas de listado:

product.id
Identificador del producto.
product.title
Nombre del producto.
product.url
URL de la ficha.
product.description
Descripción. Puede contener HTML: se pinta con |raw.
product.featured_image
Imagen principal.
product.images
Lista de imágenes del producto.
product.variants
Variantes. Cada una expone id, title, price, sku, available y el valor de cada opción.
product.options
Opciones que definen las variantes (color, talla…).
product.files
Archivos descargables asociados.
product.vendor · product.type
Fabricante y tipo.
product.price_min · product.compare_at_price
Precio mínimo entre variantes y precio anterior.
product.available
Si hay alguna variante disponible para la venta.
product.categories
Categorías a las que pertenece.
product.ratings · ratings_count · ratings_average
Valoraciones de los clientes.

Los campos de una variante coinciden con los del recurso Product de la API. Si necesitas un dato que no aparece en plantilla, comprueba primero si la API lo expone.

cart

cart.items
Líneas del carrito.
cart.item_count
Número de artículos.
cart.total_price
Total del carrito, ya con el descuento aplicado.
cart.total_discount
Importe descontado.
cart.discount
Código de descuento aplicado, si hay uno.
cart.url
URL del carrito en el idioma activo.

category

category.title
Nombre de la categoría.
category.url
URL de la categoría.
category.handle
Identificador de la categoría en la URL.
category.description
Descripción.
category.image
Imagen de la categoría.
category.products
Productos de la categoría.
category.current_tag
Filtro activo cuando se navega por etiquetas.

collection no es una variable global. En featured-collection.html.twig se calcula en la propia sección a partir de categories[handle]. Si escribes una sección nueva, haz lo mismo; no esperes encontrarla inyectada.

article y blog

article.title · article.url
Título y URL de la entrada.
article.content
Cuerpo en HTML. Se pinta con |raw.
article.excerpt
Resumen para listados.
article.image
Imagen destacada.
article.author · article.created_at
Autor y fecha de publicación.
article.tags · article.comments
Etiquetas y comentarios.
blog.title · blog.url
Nombre y URL del blog.
blog.articles
Entradas del blog.
blog.tags · blog.current_tag
Etiquetas disponibles y la activa.
blog.comments_enabled
Si el blog acepta comentarios.

page

page.title · page.description
Título y entradilla.
page.handle
Identificador de la página. Sirve para condicionar plantillas, como hace main-page.html.twig con la página de contacto.
page.content
Contenido en HTML. Se pinta con |raw.

customer

customer.name · customer.email
Datos del cliente autenticado.
customer.orders
Pedidos del cliente.
customer.addresses · customer.default_address
Direcciones guardadas y la predeterminada.
customer.created_at
Fecha de alta.

customer vale null cuando no hay sesión. Protege siempre los accesos: {% if customer %} o un valor por defecto con |default().

settings

Contiene los valores de config/settings_data.json para el preset activo. Cada clave es un ajuste declarado en el esquema del tema:

<body data-palette="{{ settings.color_palette }}"
      data-variant="{{ settings.theme_variant }}">

No confundas las dos capas. settings.* son los ajustes globales del tema. Dentro de una sección, los suyos se leen como section.settings.*. Los ajustes de una sección no existen fuera de ella.

Petición y estado del editor

_get · _post · _server
Parámetros de la petición actual.
_server.mobile_detect
Detección de dispositivo móvil.
design_mode
Verdadero dentro del editor de temas. Permite añadir atributos de edición.