Introducción al Error de Sintaxis en Liquid
El motor de plantillas Liquid es el corazón de las tiendas en Shopify, permitiendo mostrar contenido dinámico en tu escaparate. Sin embargo, un simple error tipográfico en las etiquetas puede romper el diseño de tu sitio web y mostrar mensajes de error molestos o dejar secciones en blanco. En este artículo te enseñamos a solucionar este problema de forma definitiva.
Causas Principales del Error en Liquid
Los errores de sintaxis en Shopify ocurren generalmente por:
- Uso incorrecto de las etiquetas de apertura y cierre como
{% if %}sin su correspondiente{% endif %}. - Falta de comillas o uso de comillas no válidas en cadenas de texto dentro de los filtros o variables.
- Errores tipográficos en los nombres de las variables nativas o personalizadas de Shopify.
- Uso de filtros de Liquid inexistentes o mal aplicados.
Método 1: Identificar el archivo afectado desde el Editor de Temas
Cuando se produce un error de Liquid, Shopify suele mostrar un mensaje indicando la línea y el archivo problemático.
- Inicia sesión en tu panel de administración de Shopify y ve a Tienda online > Temas.
- Haz clic en los tres puntos del tema activo y selecciona Editar código.
- Revisa la notificación de error en la parte superior o busca el archivo indicado (por ejemplo,
product-template.liquidoindex.json). - Busca las líneas de código señaladas y verifica que todas las estructuras de control tengan su cierre adecuado.
Método 2: Corregir etiquetas de control y filtros
Una vez localizado el archivo, debes corregir la estructura del código Liquid afectado.
- Asegúrate de que cada bucle o condicional esté correctamente cerrado. Por ejemplo, corrige código incompleto como este:
{% for product in collection.products %} <p>{{ product.title }}</p>añadiendo el cierre requerido:{% endfor %}. - Verifica el uso de filtros asegurándote de usar el carácter barra vertical correctamente:
{{ product.title | escape }}. - Haz clic en el botón Guardar en la esquina superior derecha y actualiza tu tienda para verificar que el error ha desaparecido.