Saltar al contenido principal
Las funciones en HubL son similares a los filtros porque los dos aceptan parámetros y generan un valor. Sin embargo, no es necesario aplicar todas las funciones al valor inicial de una plantilla, ya que estas interactúan con otras áreas de tu entorno en HubSpot. Si mantienes un sitio web antiguo, también puedes consultar la lista de funciones de HubL obsoletas. A continuación, encontrarás más información sobre cada función de HubL y su sintaxis.

append

Agrega un solo elemento al final de una lista.

blog_all_posts_url

La función blog_all_posts_url da como resultado la URL completa de la página de índice de todas las publicaciones del blog especificado. El siguiente ejemplo muestra cómo se puede utilizar esta función como la etiqueta href de un ancla.

blog_author_url

La función blog_author_url da como resultado la URL completa de la página del autor del blog especificado. El siguiente ejemplo muestra cómo se puede utilizar esta función como la etiqueta href de un ancla. Que se puede combinar con blog_authors como se muestra en los ejemplos de esa función.

blog_authors

La función blog_authors da como resultado una secuencia de objetos con los datos del autor para el blog especificado, en orden ascendente según el slug. Esta secuencia se puede almacenar en una variable e iterarla a fin de crear filtros personalizados para las publicaciones del autor. Se puede obtener el número de artículos publicados de cada autor usando el parámetro author.live_posts.
Nota: esta función tiene un límite de 250 autores. Esta función también tiene un límite de 10 llamadas por página.
La primera línea del ejemplo siguiente demuestra cómo la función da como resultado una secuencia de objetos de autor. El resto del ejemplo muestra un caso en el que se guarda una secuencia en una variable y luego se itera con los objetos de autor, imprimiendo el conjunto de enlaces a las páginas de los autores. En el ejemplo se asume que el blog tiene 4 autores.

blog_by_id

La función blog_by_id da como resultado un blog con su ID. El siguiente código de ejemplo muestra esta función en uso, que genera una lista de elementos con los hipervínculos.
Nota: esta función tiene un límite de 10 llamadas por página.
La función blog_page_link genera la URL de una vista por páginas de la lista de blogs. La función toma un parámetro numérico, que permite generar enlaces para la página actual, la siguiente, la anterior o una página específica. Esta función se utiliza generalmente en el atributo href de las etiquetas de ancla de la paginación y debe ser utilizada en la plantilla del listado de blogs. Los siguientes ejemplos muestran esta función en uso como etiqueta href de un ancla. El primer ejemplo muestra la página actual. El segundo ejemplo toma el número 7 como el parámetro para especificar la séptima página. El tercer ejemplo utiliza la variable next_page_num para generar un enlace relativo al número de página actual (también puedes utilizar la variable last_page_num para la página anterior). El último ejemplo utiliza la variable current_page_num y un operador + para crear un enlace que esté 4 páginas más adelante de la página actual.
Esta función convierte un número determinado de publicaciones populares en una secuencia. Esta secuencia se puede guardar en una variable e iterarla mediante un bucle “for”, creando un listado personalizado de las publicaciones más populares. Los resultados de esta función se almacenan en caché durante seis horas. Para obtener publicaciones de blog usando HubL de una manera que evite el almacenamiento en caché, podrías usar blog_recent_tag_posts en su lugar. En el siguiente código de ejemplo, la primera línea muestra cómo la función da como resultado una secuencia. La secuencia se guarda como una variable que luego se usa en un bucle “for”. Toda variable de una publicación de blog debe usar el nombre de cada elemento del bucle en lugar de content.. En el ejemplo, se utiliza pop_post.name. Esta técnica se puede utilizar en plantillas de blog y páginas de sitio web.
Nota: esta función tiene un límite de 200 publicaciones. Esta función también tiene un límite de 10 llamadas por página.

blog_post_archive_url

La función blog_post_archive_url da como resultado una URL completa que enlaza a la página de índice de los archivos según los valores de fecha dados en el blog especificado. Esta función tiene dos parámetros obligatorios y dos opcionales. El primer parámetro es el ID de un blog o simplemente la palabra clave "default". El segundo es el año de las publicaciones archivadas que deseas mostrar. Los parámetros opcionales incluyen el mes y el día de las publicaciones archivadas que deseas mostrar, respectivamente. El siguiente ejemplo muestra cómo se puede utilizar esta función como la etiqueta href de un ancla.

blog_recent_author_posts

La función blog_recent_author_posts da como resultado una secuencia de objetos de publicaciones de blog del autor especificado, ordenados según el más reciente. Esta secuencia de publicaciones se pueden almacenar en una variable e iterar con un bucle “for”, creando un listado de publicaciones personalizado de un autor en particular. La función toma tres parámetros. El primer parámetro especifica de qué blog se recogen las publicaciones de un autor. El valor debe ser el parámetro "default" o el ID de un blog en particular (disponible en la URL del panel de blogs). El segundo parámetro especifica el autor a utilizar. Este parámetro puede utilizar content.blog_post_author.slug para usar el autor de la publicación actual o aceptar un nombre con guion en minúsculas como "brian-halligan". El tercer parámetro especifica cuántos posts se obtendrán. La primera línea del ejemplo de abajo demuestra cómo la función devuelve una secuencia con las publicaciones de un autor. En este ejemplo, en lugar de especificar el nombre de un autor, se utiliza el autor actual de la publicación. La secuencia se guarda en una variable y se repite en bucle. Toda variable de una publicación de blog debe usar el nombre de cada elemento del bucle en lugar de content.. En el ejemplo, se utiliza author_post.name. Esta técnica se puede utilizar en las plantillas de blogs y páginas.
Nota: Esta función tiene un límite de 200 publicaciones y 10 llamadas por página.

blog_recent_posts

La función blog_recent_posts da como resultado una secuencia de objetos de publicaciones para el blog especificado, ordenados según el más reciente. Esta secuencia de publicaciones se puede guardar en una variable e iterar mediante un bucle “for”, creando un listado personalizado de publicaciones de tus publicaciones más populares. La función toma dos parámetros. El primer parámetro especifica de qué blog se recogen los posts populares. El valor debe ser el parámetro "default" o el ID de un blog en particular (disponible en la URL del panel de blogs). El segundo parámetro especifica cuántos posts se obtendrán. La primera línea del ejemplo de abajo demuestra cómo la función devuelve una secuencia. La secuencia se guarda en una variable y se repite en bucle. Toda variable de una publicación de blog debe usar el nombre de cada elemento del bucle en lugar de content.. En el ejemplo, se utiliza rec_post.name. Esta técnica se puede utilizar no sólo en las plantillas de los blogs, sino también en otras páginas.
Nota: Esta función tiene un límite de 200 publicaciones y 10 llamadas por página.

blog_recent_tag_posts

La función blog_recent_tag_posts da como resultado una secuencia de objetos de publicaciones de blog correspondiente a una o varias etiquetas especificadas, ordenadas según la más reciente. Esta secuencia de publicaciones se puede guardar en una variable e iterar con un bucle “for”, creando un listado de publicaciones personalizado según una o varias etiquetas en particular. En el código de ejemplo a continuación:
  • La primera línea muestra cómo la función devuelve una secuencia de publicaciones por etiqueta.
  • La segunda línea muestra cómo guardar la función en una variable de secuencia. El resto del código utiliza un bucle “for” para repetir el ciclo de los valores de la variable. Toda variable de una publicación de blog debe usar el nombre de cada elemento del bucle en lugar de content.. En el ejemplo, se utiliza tag_post.name. Puedes usar esta técnica tanto en páginas de blog como en páginas de sitio web.
Encuentra más información sobre cómo crear una lista de publicaciones de blog relacionadas.
Nota: Esta función tiene un límite de 100 publicaciones y 10 llamadas por página.

blog_tag_url

La función blog_tag_url da como resultado una URL completa enlazada a la página de índice del blog cuya etiqueta se ha especificado. Esta función acepta dos parámetros. El primer parámetro especifica en qué blog se encuentra la página de índice de la etiqueta. El segundo parámetro especifica la etiqueta que se debe enlazar. Este parámetro puede utilizar topic.slug para una etiqueta específica de content.topic_list o acepta un nombre con guion en minúsculas como "marketing-tips". El siguiente ejemplo muestra cómo se puede utilizar esta función como etiqueta href de un ancla.

blog_tags

La función blog_tags da como resultado una secuencia de las 250 etiquetas con la mayor cantidad de artículos en el blog (en función del número de publicaciones asociadas) para el blog especificado, ordenadas según el número de publicaciones. Esta secuencia se puede almacenar en una variable e iterar para crear filtros personalizados para las etiquetas de las publicaciones. Se puede ver el número de publicaciones de cada etiqueta con tag.live_posts. Esta función acepta dos parámetros. El primer parámetro especifica de qué blog se van a obtener las etiquetas. El segundo parámetro establece un límite en el número de etiquetas obtenidas. La primera línea del ejemplo de abajo muestra cómo la función devuelve una secuencia de objetos de etiqueta. El resto del ejemplo muestra un caso en el que se guarda una secuencia en una variable y luego se itera en todos los objetos de etiqueta, imprimiendo un conjunto de enlaces a etiquetas. En el ejemplo se asume que el blog tiene 4 etiquetas.
Nota: Esta función tiene un límite de 250 etiquetas.

blog_total_post_count

Esta función da como resultado el número total de artículos publicados en el blog especificado. Si no se especifica ningún parámetro, contará las publicaciones del blog especificado por defecto. Como alternativa, puedes especificar el parámetro "default" o el ID de un blog diferente para hacer el conteo. El ID del blog está disponible en la URL del panel de control para cada blog.
Nota: esta función tiene un límite de 10 llamadas por página.

clear

Elimina todos los elementos de una lista. A diferencia de pop(), no entrega ningún resultado.

color_contrast

Esta función valida el contraste de color con base en los estándares de las Web Content Accessibility Guidelines (WCAG). Tendrás que incluir dos colores como argumentos, y puedes incluir un argumento opcional para especificar la calificación (AA o AAA). El resultado serán los parámetros true o false en función de si los colores cumplen o superan los estándares.

color_variant

Esta función aclara u oscurece un valor hexadecimal o una variable de color en un grado específico. El primer parámetro es el color hexadecimal (por ejemplo (“#FFDDFF”) o una variable que almacene un valor hexadecimal. El segundo parámetro es el grado en el que se debe ajustar, de 0 a 255. Esta función se puede utilizar en archivos CSS para crear variaciones de color. Otro buen ejemplo es utilizarla con un parámetro de color de un módulo de color, para permitir a los usuarios especificar un color primario que genere automáticamente variaciones de color. En el ejemplo de abajo, el color hexadecimal #3A539B se almacena en una variable llamada base_color. El color se modifica en -80 dando como resultado un azul más oscuro (#00034B).

content_by_id

La función content_by_id da como resultado una landing page, una página de sitio web o una publicación de blog según el ID. El único parámetro aceptado por esta función es un ID de contenido numérico. El siguiente código de ejemplo muestra esta función en uso, que genera una lista de elementos con los hipervínculos.
Nota: esta función tiene un límite de 10 llamadas por página.

content_by_ids

Dada una lista de varios ID de contenido, da como resultado un dict (diccionario) de páginas de destino, páginas de sitio web o publicaciones de blog que coinciden con esos ID. Esta función toma un parámetro, una lista de ID de páginas o publicaciones de blog para buscar, colocadas en orden. Se pueden pasar hasta 100 objetos de contenido. El siguiente código de ejemplo muestra esta función en uso para generar una lista de elementos con sus hipervínculos.
Nota: esta función tiene un límite de 10 llamadas por página.

copy

Da como resultado una copia superficial de la lista. Equivalente a a[:]. Una copia superficial construye un nuevo objeto compuesto y luego (en la medida de lo posible) inserta en él referencias a los objetos que se encuentran en el original.

count

Da como resultado el número de veces que una variable existe en una lista.

crm_associations

Obtiene una lista de registros del CRM asociados a otro registro mediante su ID de registro, la categoría de asociación y el ID que define la asociación. Esta función devuelve un objeto con los siguientes atributos: has_more, total, offset y results.
  • has_more indica que hay más resultados disponibles además de este bloque (total > offset).
  • total es el número total de resultados disponibles.
  • offset es el desplazamiento que se utilizará para el siguiente bloque de resultados.
  • results devuelve una lista de los objetos asociados especificados que coinciden con los parámetros de la función.
Nota: Por razones de seguridad, de los tipos de objetos estándar de HubSpot solo los objetos producto y evento de marketing se pueden obtener desde una página de acceso público. Cualquier otro tipo de objeto estándar debe alojarse en una página que esté protegida por contraseña o que requiera un inicio de sesión por membresía en el CMS. Los objetos personalizados no tienen esta misma restricción.
Nota: Esta función se puede llamar un máximo de 10 veces por página. Cada llamada de la función crm_associations puede dar como resultado como máximo 100 objetos. El límite por opción predeterminada es de 10 objetos.

crm_object

Obtiene un único registro del CRM por consulta o por ID. Los registros aparecerán en un dicc. de propiedades y valores. Esta función también se puede utilizar con objetos personalizados y de integraciones.
Nota: Por razones de seguridad, de los tipos de objetos estándar de HubSpot solo los objetos producto y evento de marketing se pueden obtener desde una página de acceso público. Cualquier otro tipo de objeto estándar debe alojarse en una página que esté protegida por contraseña o que requiera un inicio de sesión por membresía en el CMS. Los objetos personalizados no tienen esta misma restricción.
¿Cuál es la diferencia entre los parámetros in y contains?in entrega resultados si el valor de la propiedad coincide con alguno de los valores dados. Por otro lado, contains entrega resultados si los valores de las propiedades en una selección múltiple tienen todos los valores especificados.
Nota: Esta función solo se puede llamar un máximo de 10 veces en una misma página.
Nota: Cuando creas una consulta, los valores range, distinct ndistinct y startswith son palabras clave reservadas. Para consultar una propiedad que usa uno de esos nombres, deberás usar el siguiente formato: range__eq= (en lugar de range=).

crm_objects

Obtiene una lista de registros para un tipo de objeto específico del CRM de HubSpot. Esta función devuelve un objeto con los siguientes atributos: has_more, total, offset y results.
  • has_more indica que hay más resultados disponibles además de este bloque (total > offset).
  • total es el número total de resultados disponibles.
  • offset es el desplazamiento que se utilizará para el siguiente bloque de resultados.
  • results devuelve una lista de los objetos especificados que coinciden con los parámetros de la función.
Los resultados se pueden ordenar utilizando al menos un parámetro de orden en la consulta. Por ejemplo, crm_objects("contact", "firstname=Bob&order=lastname&order=createdate") ordenará los contactos con el nombre "Bob" según el apellido y luego según el parámetro createdate. Para invertir el orden, agrega el signo - al nombre de la propiedad así: order=-createdate. La función de objetos del CRM también puede utilizarse con objetos personalizados y de integraciones.
Nota: Por razones de seguridad, de los tipos de objetos estándar de HubSpot solo los objetos producto y evento de marketing se pueden obtener desde una página de acceso público. Cualquier otro tipo de objeto estándar debe alojarse en una página que esté protegida por contraseña o que requiera un inicio de sesión por membresía en el CMS. Los objetos personalizados no tienen esta misma restricción.
Nota: Esta función se puede llamar un máximo de 10 veces por página. Cada llamada de la función crm_objects puede dar como resultado como máximo 100 objetos. El límite por opción predeterminada es de 10 objetos.
Nota: Cuando creas una consulta, los valores range, distinct ndistinct y startswith son palabras clave reservadas. Para consultar una propiedad que usa uno de esos nombres, deberás usar el siguiente formato: range__eq= (en lugar de range=).

crm_property_definition

Permite obtener la definición de la propiedad para un tipo de objeto y un nombre de propiedad dados. Los tipos de objetos admitidos son los objetos estándar de HubSpot (por ejemplo, los contactos), los objetos específicos del portal y los objetos de integraciones.

crm_property_definitions

Permite obtener las definiciones de las propiedades para un tipo de objeto y un conjunto de nombres de propiedades dados. Los tipos de objetos admitidos son los objetos estándar de HubSpot (por ejemplo, los contactos), los objetos específicos del portal y los objetos de integraciones.

cta

Debido a que los módulos de CTA tienen muchos parámetros con variaciones en el código de programación, puedes utilizar la función CTA para generar fácilmente una CTA particular en una plantilla, página o correo electrónico. Esta es la función que utiliza el editor de texto enriquecido cuando se agrega una CTA mediante el editor.
Nota: Esta función tiene un límite de 10 llamadas por página.

extend

Permite ampliar una lista agregando todos los elementos de un bloque iterable. En otras palabras, inserta todos los elementos de una lista en otra lista.

file_by_id

Esta función entrega los metadatos de un archivo según el ID. Acepta un único parámetro, el ID numérico del fichero que se busca. Para obtener varios archivos a la vez, utiliza la función files_by_ids en su lugar.
Nota: Esta función está limitada a 10 llamadas por página.

files_by_ids

Entrega los metadatos de varios archivos según el ID. Acepta una serie de ID de archivo.
Nota: Esta función está limitada a 10 llamadas por página y puede aceptar hasta 100 ID de archivo.
Por ejemplo, puedes usar esta función para repetir los archivos que se han subido para un contacto. Para volver sobre los resultados, deberás usar el filtro split de HubL, ya que la propiedad del CRM será una cadena separada con punto y coma.

flag_content_for_access_check

Cuando una publicación de blog está configurada para el acceso por autorregistro, los visitantes deberán registrarse o iniciar sesión para ver el contenido completo de la publicación. Los recursos de blog predeterminados de HubSpot incluyen esta función automáticamente y también un indicador con el icono de un candado para las publicaciones que requieren autorregistro para acceder. Obtén más información sobre cómo crear soluciones personalizadas utilizando esta función y su API correspondiente. Esta función comprueba si el visitante actual puede acceder a una publicación de blog. Cuando se llama, la función se reemplaza con el siguiente atributo: hs-member-content-access=<true/false> A value of true indicates that the blog post requires the visitor to log in to view the full content.
Devuelve los enlaces de las cuentas de redes sociales fijadas en la configuración de la cuenta. Se utiliza en el módulo predeterminado follow_me.

format_address

Le da formato a una dirección según la configuración regional del contexto.

format_company_name

Permite darle formato al nombre de una empresa agregando sufijos honoríficos japoneses cuando corresponda.

format_name

Permite dar formato al nombre de una persona colocando el apellido antes del primer nombre y agrega sufijos honoríficos japoneses cuando corresponda.

format_datetime

Permite darle formato a los componentes de fecha y hora de un objeto de fecha, similar al filtro de HubL format_datetime. Esta función reemplaza a la función obsoleta datetimeformat.

geo_distance

Esta función contiene 4 parámetros y calcula la altura elipsoidal 2D entre dos puntos de la Tierra. Utiliza esta función como una consulta de filtro para obtener los datos de HubDB.

get_asset_url

Esta función devuelve la URL pública de la plantilla o el archivo de programación especificado. El parámetro de esta función es la ruta del recurso en el administrador de diseño. Las URL de los archivos incluidas en el código se actualizan cada vez que se publican; por lo tanto, al utilizar esta función te aseguras de utilizar siempre la última versión del archivo. Puedes generar automáticamente esta función en la aplicación, bien haciendo clic con el botón derecho en un archivo y seleccionando Copiar URL pública, o bien haciendo clic en Acciones y seleccionando luego Copiar URL pública. En el siguiente ejemplo se obtiene la URL de un archivo Javascript creado en el administrador de diseño que se puede incluir como atributo src de una etiqueta <script>.
Copia de una URL pública

get_public_template_url_by_id

Esta función, al igual que get_public_template_url, devuelve la URL pública de la plantilla o el archivo de programación especificado. La única diferencia es que el parámetro de esta función es el ID de la plantilla (disponible en la URL de la plantilla o el archivo de programación), en lugar de la ruta del administrador de diseño.

hubdb_table

HubDB es una característica disponible en Content Hub Pro y Enterprise. La función hubdb_table se puede utilizar para obtener información sobre una tabla, incluyendo su nombre, columnas, última actualización, etcétera. Los siguientes datos pueden obtenerse llamando los atributos correspondientes:
  • ID: el ID de la tabla.
  • name: el nombre de la tabla.
  • columns: una lista de la información de las columnas.
  • created_at: la marca de tiempo de cuando se creó esta tabla por primera vez.
  • published_at: la marca de tiempo de cuando se publicó esta tabla.
  • updated_at: la marca de tiempo de cuando esta tabla fue actualizada por última vez.
  • row_count: el número de filas de la tabla.
Nota: esta función tiene un límite de 10 llamadas por página.

hubdb_table_column

HubDB es una característica disponible en Content Hub Pro y Enterprise. La función hubdb_table_column se puede utilizar para obtener información sobre una columna de la tabla, como la etiqueta, el tipo y las opciones. Esta función acepta dos parámetros. Esta información sobre la columna puede obtenerse llamando los atributos correspondientes:
  • ID: el ID de la columna.
  • name: el nombre de la columna.
  • label: la etiqueta que se utilizará para la columna.
  • type: el tipo de la columna.
  • options: en el caso de las columnas de tipo select, un mapa del parámetro optionId con la información sobre las opciones.
  • foreignIds: en el caso de las columnas de tipo "foreignId", una lista de los atributos foreignIds (con las propiedades id y name).
Además de los atributos anteriores, también se puede llamar el método getOptionByName("&lt;option name&gt;") mediante el cual se obtendrá la información de la opción por su nombre en el caso de las columnas de tipo "select".
Los nombres de las columnas no distinguen entre mayúsculas y minúsculas, por ejemplo, tanto HS_ID como hs_id son válidos.

hubdb_table_row

HubDB es una característica disponible en Content Hub Pro y Enterprise. La función hubdb_table_row se puede utilizar para extraer una sola fila de una tabla HubDB. Desde esta fila, se puede extraer la información de cada celda de la tabla llamando el atributo correspondiente:
  • hs_id: el identificador único global de esta fila.
  • hs_created_at: una marca de tiempo que representa cuándo se creó la fila.
  • hs_path: cuando se utiliza con páginas dinámicas, esta cadena es el último segmento de la ruta de la URL de la página.
  • hs_name: cuando se utiliza con páginas dinámicas, es el título de la página.
  • <column name> or [“<column name>”]: obtiene el valor de la columna de la fila por el name de la columna.
Los nombres de las columnas no distinguen entre mayúsculas y minúsculas, por ejemplo, tanto HS_ID como hs_id son válidos.
Nota: esta función tiene un límite de 10 llamadas por página.

hubdb_table_rows

HubDB es una característica disponible en Content Hub Pro y Enterprise. La función hubdb_table_rows se puede utilizar para obtener una lista de las filas de una tabla HubDB con el fin de iterarlas. Una sola llamada de hubdb_table_rows() está limitada a 10 escaneos de tabla por página. Por opción predeterminada, esta función devolverá un máximo de 1000 filas. Para obtener más filas, especifica el parámetro limit en la consulta, como se muestra en el código más abajo.
Nota: Si usas un filtro aleatorio con esta función, la página se renderizará previamente con regularidad. Esto significa que el contenido filtrado no se actualizará cada vez que se descargue la página.
Nota: Cuando creas una consulta, los valores range, distinct ndistinct y startswith son palabras clave reservadas. Para consultar una propiedad que usa uno de esos nombres, deberás usar el siguiente formato: range__eq= (en lugar de range=).

include_default_custom_css

Esta función genera una etiqueta de enlace que hace referencia al archivo CSS primario (default_custom_style.min.css). Este archivo está diseñado para ser un archivo CSS global que se puede agregar a todas las plantillas. Para renderizar, la función requiere el valor de parámetro booleano True.

index

Muestra la ubicación del primer elemento coincidente en una serie basada en 0. Esta función acepta 3 parámetros y el primero es obligatorio. El primer parámetro es el elemento que estás tratando de encontrar en la serie. El segundo (start) y el tercero (end) permiten encontrar ese elemento en una porción de la serie.

insert

Coloca un elemento en una lista en el índice específico proporcionado. Esta función acepta dos parámetros:
  • Index: la posición en la que se va a insertar un elemento.
  • Element: el elemento que se va a insertar.

locale_name

Muestra una representación comprensible para humanos de un código de idioma, opcionalmente traducida a un idioma de destino.

load_translations

Descarga las traducciones desde la ruta _locales de una carpeta determinada y muestra un mapa de los valores. Obtén más información sobre la inclusión de traducciones de los campos en los módulos y temas personalizados.
Muestra la estructura de enlaces anidados de un menú avanzado. Los nodos del menú tienen varias propiedades que se pueden utilizar en los objetos que salen en los resultados. Si pasas null a la función de menú, ésta devolverá una pylist vacía. También puedes especificar un menú por su nombre. En la mayoría de los casos es más seguro utilizar el ID del menú, ya que el cambio de nombre de un menú no afectará al ID. Si se diseña para el mercado es mejor establecer el parámetro "default" como opción predeterminada si no hay resultado para el menú, es decir null.
Nota: esta función tiene un límite de 10 llamadas por página.
Al utilizar la función menu() para generar un menú, eres totalmente responsable de asegurarte de que tu menú sea accesible.

module_asset_url

Obtiene la URL de un recurso enlazado a un módulo personalizado mediante Archivos enlazados > Otros archivos.

namespace

Crea un objeto namespace que puede contener atributos arbitrarios. Se puede iniciar desde un diccionario o con argumentos de palabras clave.

oembed

Muestra el diccionario de datos OEmbed para la solicitud especificada. Solo funciona con los correos electrónicos.

personalization_token

Muestra el valor de un contacto o de una propiedad relacionada con un contacto, o un valor predeterminado.

pop

Elimina el elemento del índice de la lista. También muestra el elemento eliminado si se imprime.

postal_location

La función postal_location da como resultado el par de ubicación latitud/longitud de un código postal y un código de país determinados (restringido a EE. UU., CA y GB).
Nota: esta función tiene un límite de 10 llamadas por página.

put

Da resultados similares a la función update, que actualiza un objeto dict con los elementos de otro objeto dict o de un elemento iterable de pares clave-valor, con la diferencia que put admite nombres de variables en objetos dicc.

range

Muestra una lista que contiene una progresión aritmética de números enteros. Con un parámetro, range mostrará una lista desde 0 hasta lo indicado en value, sin incluirlo. Con dos parámetros, el rango comenzará en el primer valor y se incrementará en 1 hasta el segundo value, sin incluirlo. El tercer parámetro especifica el incremento gradual. Todos los valores pueden ser negativos. Los rangos imposibles devolverán una lista vacía. Los rangos pueden generar un máximo de 1000 valores. El rango se puede utilizar dentro de un bucle “for” para especificar el número de iteraciones que deben ejecutarse.

require_css

Esta función pone en cola un archivo CSS para renderizarlo en el elemento head. Todas las etiquetas link del CSS se agrupan y se muestran antes que cualquier etiqueta JavaScript. El código HubL se sustituye por una línea vacía y luego se agrega una etiqueta link a {{ standard_header_includes }}. Este método requiere una URL absoluta; se puede solicitar el contenido del CMS con una URL relativa conocida mediante el uso de la función get_asset_url(). Para poner en cola un estilo inline para que se muestre con la etiqueta head mediante un elemento con la etiqueta style, utiliza la etiqueta {% require_css %} and {% end_require_css %} en su lugar con las etiquetas style y CSS. El segundo parámetro es un diccionario de opciones para modificar la etiqueta generada. Admite el parámetro async (verdadero o falso) una técnica descrita en web.dev y cualquier otro par clave-valor se agregará como atributo HTML a la etiqueta de estilo.

require_js

Especifica si un script debe ser puesto en cola para ser renderizado en el encabezado o en el pie de página (como opción por defecto). Especifica la ubicación del renderizado incluyendo el parámetro head o footer. El código HubL será sustituido por una línea vacía, y se incluirá en el encabezado o en el pie de página. Para poner en cola un script en línea para que se muestre en el pie de página a través de un elemento script, encierra las etiquetas <script> con las funciones {% require_js %} y {% end_require_js %}. También puedes incluir opciones de renderizado adicionales en esta función. Se agregarán como atributos HTML en la etiqueta del script. Las opciones de renderización incluyen:
  • position: head/footer
  • defer: true/false
  • async: true/false
  • type: string

resize_image_url

Convierte la URL de la imagen almacenada en el administrador en archivos a una URL que redimensionará la imagen si así se requiere. La función acepta un parámetro obligatorio y cinco opcionales. Se debe pasar al menos un parámetro opcional. Requerido
  • URL: cadena, la URL de una imagen alojada en HubSpot.
Opcionales
  • width: número, la nueva anchura de la imagen en pixeles.
  • height: número, la nueva altura de la imagen en pixeles.
  • length: número, la nueva longitud del lado mayor, en pixeles.
  • upscale: booleano, utiliza las dimensiones de la imagen redimensionada incluso si superan la imagen original (las imágenes pueden aparecer borrosas).
  • upsize: booleano, muestra la imagen redimensionada aunque sea mayor que la original en bytes.
Nota: las imágenes que son mayores a 4096 pixeles en altura o ancho no se redimensionarán automáticamente. En lugar de eso, tendrás que cambiar el tamaño de la imagen manualmente.

reverse

Invierte el orden de los elementos de una lista. No toma ningún parámetro. Para invertir un objeto o devolver un elemento iterable para repetir la lista a la inversa, utiliza |reverse

set_response_code

Establece el código de respuesta como el código especificado. 404 es el único código admitido por ahora. Cuando se utiliza, la página mostrará un error 404.

super

Esta función imprime el contenido de la plantilla principal en una plantilla secundaria utilizando la etiqueta extends. Por ejemplo, en el ejemplo de código de abajo, se ha creado una plantilla HTML básica con un bloque HubL llamado sidebar y se ha guardado como parent.html. Se creará un segundo archivo de plantilla que ampliará ese archivo principal. Normalmente, el valor de la etiqueta <h3> se imprimiría en el bloque de la barra lateral del HTML principal. Pero al usar super, el contenido del bloque de la barra lateral de la plantilla principal se combina con el contenido de la plantilla secundaria.

today

Muestra el inicio del día de hoy (12:00am). Como alternativa, puedes agregar un parámetro para cambiar la zona horaria de la zona UTC predeterminada.

to_local_time

Convierte una marca de tiempo UNIX a la hora local, con base en la configuración de los informes en HubSpot. A continuación, puedes aplicar un filtro datetimeformat para darle formato a la fecha.

topic_cluster_by_content_id

Devuelve un objeto dicc. de HubL que representa el grupo de temas asociado a un contenido (determinado por el ID del contenido que se proporcionó), e incluye los metadatos de la página pilar asociada, el tema central y los temas secundarios. Se puede usar para “enlazar automáticamente” un contenido con su página pilar asociada [si existe]. Los metadatos disponibles se encuentran con las etiquetas: attachableContent (los metadatos del contenido actual), topic (los metadatos del tema asociado al contenido actual), coreTopic (los metadatos del tema central del conjunto asociado) y pillarPage (los metadatos de la página pilar asociada). Utiliza {{ topicCluster|pprint }} para que se muestren todas las propiedades y atributos disponibles.
Nota: esta función tiene un límite de 10 llamadas por página.

truncate

La función de truncamiento actúa del mismo modo que el filtro truncar pero utiliza la sintaxis de una función en lugar de la de un filtro. El primer parámetro especifica la cadena. El segundo parámetro especifica el punto en el que se debe truncar. El último parámetro especifica los caracteres que se agregarán cuando se produzca el truncamiento.
Nota: Debido a que esta función depende de los espacios entre las palabras para acortar las cadenas, es posible que no funcione como se espera con idiomas sin espacios entre caracteres, como el japonés.

type

Esta función acepta un argumento y muestra el tipo de objeto. El valor devuelto es uno de los siguientes: "bool", "datetime", "dict", "float", "int", "list", "long", "null", "str" o "tuple".

unixtimestamp

Esta función da como resultado una marca de tiempo UNIX cuando se proporciona un objeto datetime.

update

Actualiza el objeto dict con los elementos de otro objeto dict o de un elemento iterable de pares clave-valor. Utiliza esta función para combinar o fusionar objetos.
Última modificación el 10 de febrero de 2026