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
| Variable | Apunta a |
|---|---|
| asset_url | La carpeta assets/ del tema. |
| tiendy_asset_url | Los activos comunes de Tiendy (scripts de atributos, captcha…). |
| uploads_url | Los archivos subidos por la tienda. |
| theme_url | La 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
| Filtro | Qué hace |
|---|---|
| versioned_asset_url | Devuelve la URL del activo con su versión, para invalidar la caché al publicar. |
| asset_url | Prefija la ruta con la carpeta de activos del tema. |
| upload_url | Prefija la ruta con la carpeta de archivos subidos. |
| asset_exists | Comprueba si el archivo existe antes de pintarlo. |
| asset_imagesize | Obtiene las dimensiones de una imagen del tema. |
| product_img_url · category_img_url | Construyen 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.