En una publicación anterior aprendimos cómo insertar contenido dinámico en la plantilla usando delimitadores. Ahora veamos qué contenido dinámico está disponible en HubL.
HubL se construye sobre tres pilares: variables, etiquetas y funciones. Cada uno tiene un rol específico, y su disponibilidad puede variar según el contexto (páginas web, posts de blog, landing pages)
Variables
Las variables son propiedades que nos permiten acceder a valores específicos: un título, una fecha, un color, una URL...
Para mostrar el valor de una variable, usas el delimitador de salida , por ejemplo, 2026 muestra el año actual.
Cuando el contenido está agrupado en pares clave-valor, estamos hablando de diccionarios. Un ejemplo es el diccionario content, que agrupa toda la información de una página: {{ content.name }} (título), {{ content.created }} (fecha de creación), entre otros.
Profundiza en Variables y Diccionarios Aprende las variables más usadas, notación de punto, propiedades anidadas (
{{content.author.display_name}}), y cómo crear diccionarios personalizados con{% set %}.Lo compartiremos en una futura publicación
Etiquetas
Las etiquetas usan el delimitador de lógica {% %} para realizar acciones en tu plantilla: ejecutar lógica ({% if %}, {% for %}), manipular datos ({% set %}, {% do %}), organizar código ({% block %}, {% include %}), o insertar componentes del sistema ({% menu %}, {% post_listing %}).
Muchas etiquetas tienen módulos equivalentes en el editor visual. Por ejemplo, {% menu %} tiene un módulo de Menú, y {% blog_subscribe %} tiene un módulo de Suscripción. Sin embargo, en plantillas de páginas de sistema (como plantillas de blog o búsqueda) no tienes acceso al editor drag & drop, por lo que usas las etiquetas directamente en el código.
Funciones
Las funciones son operaciones que crean o transforman datos. Mientras las variables acceden a información existente ({{ content.name }}), las funciones generan nueva información o realizan cálculos.
Algunos ejemplos de funciones son:
range(1, 10): genera una secuencia de números.blog_recent_posts(): obtiene los posts más recientes del blog.hubdb_table_rows(): Consulta filas de una tabla de HubDB
Las funciones se usan dentro del delimitador de salida {{ }} y pueden recibir parámetros: {{ blog_recent_posts('default', 5) }} obtiene 5 posts del blog 'default'.
Profundiza en etiquetas y funciones Aprende como usar las etiquetas y funciones para generar contenido dinámico en HubL.
Lo compartiremos en una próxima publicación
En el siguiente HubL Basics hablaremos de las variables y diccionarios más usados y cómo crearlos.