Tiendy Documentación
Plantillas

Activos e idiomas

Los CSS, JavaScript e imágenes se referencian con rutas que Tiendy sirve desde su servidor de estáticos y cachea por generación. Las cadenas visibles se traducen desde archivos CSV del propio tema.

Rutas de activos

VariableApunta a
asset_urlLa carpeta assets/ del tema.
tiendy_asset_urlLos activos comunes de Tiendy (scripts de atributos, captcha…).
uploads_urlLos archivos subidos por la tienda.
theme_urlLa raíz del tema.

Tiendy resuelve estas rutas por ti. Nunca escribas la ruta absoluta a mano: cambia según el entorno y rompería la caché.

Cómo referenciar

Las dos formas conviven y son equivalentes:

{# Variable + ruta relativa #}
<img src="{{ asset_url }}img/favicon.svg?{{ shop.generation }}" alt="">

{# Filtro sobre el nombre del archivo #}
<link rel="stylesheet" href="{{ 'theme.css'|versioned_asset_url }}">
<script src="{{ 'app.js'|versioned_asset_url }}?{{ shop.generation }}"></script>

{# Activos de Tiendy #}
<script src="{{ tiendy_asset_url }}attributes.js"></script>

Filtros de activos

FiltroQué hace
versioned_asset_urlDevuelve la URL del activo con su versión, para invalidar la caché al publicar.
asset_urlPrefija la ruta con la carpeta de activos del tema.
upload_urlPrefija la ruta con la carpeta de archivos subidos.
asset_existsComprueba si el archivo existe antes de pintarlo.
asset_imagesizeObtiene las dimensiones de una imagen del tema.
product_img_url · category_img_urlConstruyen la URL de una imagen de producto o de categoría.

Caché y generación

Los activos del tema se sirven como inmutables. El parámetro shop.generation cambia cuando la tienda se vuelve a publicar y es lo que fuerza al navegador a pedir la versión nueva:

<link rel="stylesheet" href="{{ 'theme.css'|versioned_asset_url }}">
<script src="{{ 'app.js'|versioned_asset_url }}?{{ shop.generation }}" defer></script>

Si un cambio de CSS no se ve en la tienda, comprueba que la referencia lleva ?{{ shop.generation }} o el filtro versioned_asset_url. Sin eso, el navegador reutiliza el archivo anterior.

Vista previa del tema

El editor de plantilla muestra la tienda con el tema en borrador mediante una barra de vista previa, sin publicar los cambios. Esa previsualización queda ligada a tu sesión de edición: el resto de visitantes sigue viendo la tienda publicada.

Idiomas

Cada tema trae un CSV por idioma en languages/. El formato es de dos columnas separadas por punto y coma: texto original y traducción, entre comillas:

"(optional)";"(opcional)"
"30-day free returns and instant exchanges";"30 días para devoluciones gratis y cambios inmediatos"
"About us";"Sobre nosotros"
"Actions";"Acciones"

Tiendy carga primero las cadenas base de la plataforma y después las del tema, que tienen prioridad. En el repositorio hay archivos para es, en, ca y pt, según el tema.

Traducir cadenas

Marca el texto con la etiqueta y Tiendy lo sustituye según el idioma activo:

<h1>{% translate %}Featured products{% endtranslate %}</h1>

{# Alias y filtro #}
{% trans %}Add to cart{% endtrans %}
{{ 'Free shipping'|trans }}

Traduce el texto literal. Si interpolas variables dentro de la etiqueta, añade la cadena completa al CSV o la traducción no encontrará coincidencia.