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:
| Variable | Contenido |
|---|---|
| shop | Datos de la tienda: nombre, URL, idioma, moneda y formato de precio. |
| cart | Carrito actual: artículos, totales, descuento y URL. |
| customer | Cliente autenticado. Es null si nadie ha iniciado sesión. |
| categories | Categorías de la tienda, accesibles por handle: categories['catalogo']. |
| linklists | Menús de enlaces configurados en la tienda. |
| pages | Páginas de contenido publicadas. |
| blogs | Blogs de la tienda. |
| settings | Ajustes del tema, leídos de settings_data.json. |
| template | Nombre de la plantilla que se está renderizando. |
| wishlist · wishlist_state · wishlist_product_ids | Lista de favoritos y el estado por variante. |
| asset_url · tiendy_asset_url · uploads_url · theme_url | Rutas base de activos del tema, activos de Tiendy y archivos subidos. |
| _get · _post · _server | Parámetros de la petición. Incluye _server.mobile_detect. |
| design_mode | Verdadero 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ágina | Variables |
|---|---|
| product | product |
| category | category, listing_filters, current_tags |
| cart | cart |
| page | page |
| blog y article | blog, article, form (comentarios) |
| search | q, search_* |
| index | page_title, canonical_url, messages |
| account | order, order_page, address, files |
| wishlist | products |
| error | error |
| password | password_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,availabley 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.twigcon 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.