This is the parent template

> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.es/docs/llms.txt > Use this file to discover all available pages before exploring further. # Funciones de HubL > Una lista de referencia de todas las funciones disponibles de HubL. 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](/cms/versions-deprecations/deprecated/hubl/filters-functions). 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. ```text hubl.txt theme={null} {% set numbers_under_5 = [1,2,3] %} {% do numbers_under_5.append(4) %} {{numbers_under_5}} ``` ```text resultados renderizados.txt theme={null} [1, 2, 3, 4] ``` | Parámetro | Tipo | Descripción | | --------- | ---------- | ------------------------------------ | | `item` | Cualquiera | Elemento que se agregará a la 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. ```html example.html theme={null} All Marketing blog posts ``` ```html example.html theme={null} All Marketing blog posts ``` | Parámetro | Tipo | Descripción | | --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `selected_blog` | ID del blog o "default" | Especifica qué blog utilizar. El ID del blog se obtiene del [campo del blog en el módulo](/cms/reference/fields/module-theme-fields#blog). | ## 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. ```html example.html theme={null} Brian Halligan ``` ```html example.html theme={null} Brian Halligan ``` | Parámetro | Tipo | Descripción | | --------------- | ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o el blog "default" | Especifica en qué blog existe la página del autor. Puedes especificar un blog por su ID o utilizar la variable `"default"` para seleccionar el blog predeterminado. El ID del blog está dado por el [campo de blog del módulo](/cms/reference/fields/module-theme-fields#blog). | | `author_slug` | Cadena o variable de HubL | Especifica el autor al que se va a enlazar. Puedes utilizar la variable `content.blog_post_author.slug` o un nombre con guión en minúsculas, por ejemplo: `"jane-doe"`. | ## 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. ```html example.html theme={null} {{ blog_authors("default", 250) }} {% set my_authors = blog_authors("default", 250) %}

{{ author }}

``` ```html example.html theme={null} [ Brian Halligan, Dharmesh Shah, Katie Burke, Kipp Bodnar]

{{my_blog.html_title}}

``` ```html example.html theme={null}

Outdoor biking for the earnest

``` | Parámetro | Tipo | Descripción | | --------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o "default" | Especifica qué blog utilizar, ya sea un blog específico por su ID o el blog predeterminado con `"default"`. El ID del blog está dado por el [campo de blog del módulo](/cms/reference/fields/module-theme-fields#blog). | ## blog\_page\_link 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. ```html example.html theme={null} Current page Page 7 Next Page Plus 4 ``` ```html example.html theme={null} Page 1 Page 7 Next Page Plus 4 ``` | Parámetro | Tipo | Descripción | | --------- | ------------------------- | ------------------------------------------------------------------------------------------ | | `page` | Número o variable de HubL | Número de página utilizado para generar la URL o la variable de HubL del número de página. | ## blog\_popular\_posts 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](#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"](/cms/reference/hubl/loops). [Toda variable de una publicación de blog](/cms/reference/hubl/variables#blog-variables) 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. ```html example.html theme={null} {% set pop_posts = blog_popular_posts("default", 5, ["marketing-tips", "sales-tips"], "popular_past_month", "AND") %} {% for pop_post in pop_posts %}

{% endfor %} ``` ```html example.html theme={null} [Popular post title 1, Popular post title 2, Popular post title 3, Popular post title 4, Popular post title 5]

Recent post title 5

{% endfor %} ``` ```html example.html theme={null} [Post about Marketing 1, Post about Marketing 2, Post about Marketing 3, Post about Marketing 4, Post about Marketing 5]

Post about Marketing

Post about Fun

Post about Inbound

``` | Parámetro | Tipo | Descripción | | ------------------ | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o "default" | Especifica qué blog utilizar, ya sea un blog específico por su ID o el blog predeterminado con `"default"`. El ID del blog está dado por el [campo de blog del módulo](/cms/reference/fields/module-theme-fields#blog). | | `tag_slug` | Cadena | Especifica la etiqueta que se utilizará en el filtro. Puedes incluir hasta 10 etiquetas, separadas por comas. Las etiquetas con varias palabras deben estar en minúsculas con los espacios reemplazados por guiones. | | `limit` | Entero | Especifica el número de publicaciones que se agregarán a la secuencia. Este parámetro es obligatorio cuando se incluye el parámetro `logical_operator`. | | `logical_operator` | Cadena | Cuando `tag_slug` contiene varias etiquetas, utiliza este operador para filtrar los resultados con la lógica `AND` u `OR`. Por opción predeterminada, esta función utiliza la lógica `OR` para devolver publicaciones con cualquiera de las etiquetas especificadas. Al incluir este parámetro, `limit` es obligatorio. | ## 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. ```html example.html theme={null} Inbound Marketing ``` ```html example.html theme={null} Inbound Marketing ``` | Parámetro | Tipo | Descripción | | --------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o "default" | Especifica qué blog utilizar, ya sea un blog específico por su ID o el blog predeterminado con `"default"`. | | `tag_slug` | Cadena | Especifica la etiqueta a la que se va a enlazar. | ## 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. ```html example.html theme={null} {{ blog_tags("default", 250) }} {% set my_tags = blog_tags("default", 250) %}

{{ item }}

``` ```html example.html theme={null} [ Blogging, Inbound Marketing, SEO, Social Media]

``` | Parámetro | Tipo | Descripción | | --------------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o blog "default" | Especifica qué blog utilizar. El ID del blog está dado por el [campo de blog del módulo](/cms/reference/fields/module-theme-fields#blog). | | `limit` | Entero | La cantidad máxima de etiquetas que saldrán en los resultados. | ## 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. ```text hubl.txt theme={null} {{ blog_total_post_count }} {{ blog_total_post_count(359485112) }} ``` ```text resultados renderizados.txt theme={null} 16 54 ``` | Parámetro | Tipo | Descripción | | --------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID del blog o "default" | Especifica en qué blog hacer el conteo. El ID del blog está dado por el [campo de blog del módulo](/cms/reference/fields/module-theme-fields#blog). | ## clear Elimina todos los elementos de una lista. A diferencia de `pop()`, no entrega ningún resultado. ```text hubl.txt theme={null} {% set words = ["phone","home"] %} {% do words.clear() %} {{words}} ``` ```text resultados renderizados.txt theme={null} [] ``` ## color\_contrast Esta función valida el contraste de color con base en [los estándares de las Web Content Accessibility Guidelines (WCAG)](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum). 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. ```text hubl.txt theme={null} {{color_contrast('#FFFFFF','#273749')}} {{color_contrast('rgb(255, 255, 255)','rgb(229, 237, 245)','AAA')}}

Hey there

``` ```text resultados renderizados.txt theme={null} true false Hey there ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `color_1` | Color | El primer color que se va a comparar. Acepta:

Códigos hexadecimales de 6 dígitos (`#FFFFFF`)
Códigos hexadecimales de 3 dígitos (`#F0A`)
Códigos de color RGB (`rgb(12,31,1)`)

También puede usar una variable que almacene un código de color hexadecimal o RGB, por ejemplo, `theme.primary_color.color` | | `color_2` | Color | El segundo color que se va a comparar con el primero. | | `rating` | Cadena | El estándar de las WCAG que se utilizará para la calificación. Puede ser `AA` (predeterminado) o `AAA`. | ## 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). ```text hubl.txt theme={null} {% set base_color ="#3A539B" %} {{ color_variant(base_color, -80) }} ``` ```text resultados renderizados.txt theme={null} #00034b ``` | Parámetro | Tipo | Descripción | | ------------------- | --------------------------- | --------------------------------------------------------------------------------------- | | `base_color` | Cadena de color hexadecimal | El color inicial que se modificará. Por ejemplo, `#F7F7F7`. | | `brightness_offset` | Entero | Un número positivo o negativo que se utiliza para aclarar u oscurecer el color de base. | ## 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. ```html example.html theme={null} {% set my_content = content_by_id(4715624297) %}

{{my_content.title}}

``` ```html example.html theme={null}

How do I create default values for my email or smart content personalization tokens?

``` | Parámetro | Tipo | Descripción | | --------- | ---- | ----------------------------------- | | `id` | ID | El ID del contenido que se buscará. | ## 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. ```html example.html theme={null} {% set contents = content_by_ids([4715624297, 4712623297, 5215624284]) %}

{{content.title}}

``` ```html example.html theme={null}

``` | Parámetro | Tipo | Descripción | | --------- | ----- | --------------------------------------------------------------------------------------------------------------- | | `ids` | Lista | Una lista de ID de páginas o publicaciones de blog para buscar. Se pueden pasar hasta 100 objetos de contenido. | ## 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. ```text hubl.txt theme={null} {% set a = ["ham"] %} {% set b = a.copy() %} a: {{a}} b: {{b}} After Append {% do a.append("swiss") %} a: {{a}} b: {{b}} ``` ```text resultados renderizados.txt theme={null} a: [ham] b: [ham] After Append a: [ham, swiss] b: [ham] ``` ## count Da como resultado el número de veces que una variable existe en una lista. ```html example.html theme={null} {% set attendees = ["Jack","Jon","Jerry","Jessica"] %} {% set jon_count = attendees.count("Jon") %} There are {{jon_count}} Jon's in the list.

After append:

{% do attendees.append("Jon") %} {% set jon_count_after_append = attendees.count("Jon") %} There are now {{jon_count_after_append}} Jon's in the list. ``` ```html example.html theme={null} There are 1 Jon's in the list.

After append:

There are now 2 Jon's in the list. ``` ## 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](https://knowledge.hubspot.com/es/get-started/manage-your-crm-database#standard-objects) 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](https://knowledge.hubspot.com/es/website-pages/password-protect-a-page) o que requiera un [inicio de sesión por membresía en el CMS](https://knowledge.hubspot.com/es/website-pages/require-member-registration-to-access-private-content). Los objetos personalizados no tienen esta misma restricción. ```text hubl.txt theme={null} {% set associated_contacts = crm_associations(847943847, "HUBSPOT_DEFINED", 2, "limit=3&years_at_company__gt=2&orderBy=email", "firstname,email", false) %} {{ associated_contacts }} ``` ```text resultados renderizados.txt theme={null} {has_more=true, offset=3, total=203, results=[{firstname=Aimee, id=905, email=abanks@company.com}, {firstname=Amy, id=1056, email=abroma@company.com}, {firstname=Abigael, id=957, email=adonahu@company.com}]} ``` **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. | Parámetro | Tipo | Descripción | | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | ID | ID del registro a partir del que se deben buscar asociaciones. | | `association category` | Cadena | La categoría de la definición de la asociación. Los valores posibles son `HUBSPOT_DEFINED`, `USER_DEFINED` y `INTEGRATOR_DEFINED`. Este parámetro puede omitirse en el caso de los tipos de asociación integrados definidos por HubSpot. | | `association type id` | Entero | El ID de la definición de la asociación que se va a utilizar. Para saber los objetos estándar de HubSpot compatibles, consulta [ID del tipo de asociación que vas a usar](https://developers.hubspot.es/docs/guides/api/crm/associations). De otro modo, el ID de la asociación se puede encontrar en la [API del esquema de objetos del CRM](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details). | | `query` | Cadena | El `id` del registro, o una cadena de consulta, delimitada por `&`. Todas las expresiones se suman con AND. Los operadores admitidos son:

`eq` (predeterminado)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (aplicable para propiedades con varios valores o propiedades de cadena, por ejemplo, *"firstname\_\_contains=Tim"*).

Las consultas pueden incluir los siguientes parámetros:

`limit`: el número máximo de resultados obtenidos en la respuesta, por ejemplo, `limit=50`.
`offset`: para distribuir los resultados en páginas si el número de resultados devueltos es superior al parámetro límite, por ejemplo, `offset=51`.
`orderBy`: ordena los resultados por una propiedad específica, por ejemplo, `orderBy=email`.

| | `properties` | Cadena | Opcional. Una lista separada con comas de las propiedades que saldrán en los resultados. Por defecto, el resultado es un pequeño conjunto de propiedades comunes. Siempre se devuelve la propiedad ID. Se puede encontrar una lista completa de propiedades utilizando los endpoints para [obtener todas las propiedades de los contactos](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-contacts/get-properties-v1-contacts-properties#get-all-contact-properties) y [obtener todas las propiedades de las empresas](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-companies/get-properties-v1-companies-properties#get-all-company-properties). | | `formatting` | Booleano | Opcional. Da formato a los valores, como las fechas y la divisa, de acuerdo con la configuración del portal. Omite o pasa el parámetro `false` con las cadenas sin procesar. | ## 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](/cms/start-building/features/data-driven-content/crm-objects). **Nota:** Por razones de seguridad, de los [tipos de objetos estándar de HubSpot](https://knowledge.hubspot.com/es/get-started/manage-your-crm-database#standard-objects) 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](https://knowledge.hubspot.com/es/website-pages/password-protect-a-page) o que requiera un [inicio de sesión por membresía en el CMS](https://knowledge.hubspot.com/es/website-pages/require-member-registration-to-access-private-content). 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. ```text hubl.txt theme={null} {% set contact = crm_object("contact", "email=contact@company.com", "firstname,lastname", false) %} {% set contact = crm_object("contact", 123) %} {{ contact.firstname }} {{ contact.lastname }} ``` ```text resultados renderizados.txt theme={null} Brian Halligan ``` **Nota:** Esta función solo se puede llamar un máximo de 10 veces en una misma página. | Parámetro | Tipo | Descripción | | ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Cadena | El nombre del tipo de objeto. Los nombres de los tipos de objetos distinguen entre mayúsculas y minúsculas. Encuentra más información sobre los [tipos de objetos admitidos](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Para encontrar los nombres de los tipos de objetos específicos de la cuenta y de integraciones disponibles en tu cuenta, utiliza la [API del esquema de objetos del CRM](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) para obtener las definiciones de los tipos y encontrar el nombre de la propiedad. Contiene el nombre del tipo de objeto interno que se debe usar para la función. En el caso de los tipos de objeto de integraciones y específicos de la cuenta con el mismo nombre que los objetos de la aplicación debes usar el [nombre completamente calificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN, por sus siglas en inglés) de los objetos. | | `query` | Cadena | Opcional. El `id` del registro, o una cadena de consulta, delimitada con`&`. Todas las expresiones se suman con AND. Los operadores admitidos son:

`eq` (predeterminado)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (aplicable para propiedades con varios valores o propiedades de cadena, por ejemplo, *"firstname\_\_contains=Tim"*).

Las consultas pueden incluir los siguientes parámetros:

`limit`: el número máximo de resultados obtenidos en la respuesta. por ejemplo, `limit=50`.
`offset`: para distribuir los resultados en páginas si el número de resultados devueltos es superior al parámetro límite, por ejemplo, `offset=51`.
`orderBy`: ordena los resultados por una propiedad específica, por ejemplo, `orderBy=email`.

| | `properties` | Cadena | Opcional. Una lista separada con comas de las propiedades que saldrán en los resultados. Por defecto, el resultado es un pequeño conjunto de propiedades comunes. Siempre se devuelve la propiedad ID. Se puede encontrar una lista completa de propiedades utilizando los endpoints para [obtener todas las propiedades de los contactos](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-contacts/get-properties-v1-contacts-properties#get-all-contact-properties) y [obtener todas las propiedades de las empresas](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-companies/get-properties-v1-companies-properties#get-all-company-properties). | | `formatting` | Booleano | Opcional. Da formato a los valores, como las fechas y la divisa, de acuerdo con la configuración del portal. Pasa el parámetro `false` con las cadenas sin procesar. | **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](/cms/start-building/features/data-driven-content/crm-objects). **Nota:** Por razones de seguridad, de los [tipos de objetos estándar de HubSpot](https://knowledge.hubspot.com/es/get-started/manage-your-crm-database#standard-objects) 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](https://knowledge.hubspot.com/es/website-pages/password-protect-a-page) o que requiera un [inicio de sesión por membresía en el CMS](https://knowledge.hubspot.com/es/website-pages/require-member-registration-to-access-private-content). Los objetos personalizados no tienen esta misma restricción. ```text hubl.txt theme={null} {% set objects = crm_objects("contact", "firstname__not_null=&limit=3", "firstname,lastname") %} {{ objects }} ``` ```text resultados renderizados.txt theme={null} {has_more=true, offset=3, total=331, results=[{firstname=Brian, id=44151, lastname=Halligan}, {firstname=Dharmesh, id=44051, lastname=Shah}, {firstname=George, id=88551, lastname=Washington}]} ``` **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. | Parámetro | Tipo | Descripción | | ------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Cadena | El tipo de objeto por su nombre. Los nombres de los tipos de objetos distinguen entre mayúsculas y minúsculas. Se aceptan el singular y el plural en el caso de los tipos de objetos estándar (por ejemplo, `contacto`, `contactos`). Encuentra más información sobre los [tipos de objetos admitidos](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Para encontrar los nombres de los tipos de objetos específicos de la cuenta y de integraciones disponibles en tu cuenta, utiliza la [API del esquema de objetos del CRM](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) para obtener las definiciones de los tipos y las propiedades del nombre. En el caso de los tipos de objetos específicos de integraciones y de la cuenta con el mismo nombre que los objetos propios de la aplicación, utiliza el [nombre completo cualificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN, por sus siglas en inglés) de los objetos. | | `query` | Cadena | Opcional. El ID del registro o una cadena de consulta, delimitada con `&`. Todas las expresiones se suman con AND. Los operadores admitidos son:

`eq` (predeterminado)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (aplicable para propiedades con varios valores o propiedades de cadena, por ejemplo, *"firstname\_\_contains=Tim"*).

Ejemplo:`"email=contact@company.com"` | | `properties` | Cadena | Opcional. Una lista separada con comas de las propiedades que saldrán en los resultados. Por defecto, el resultado es un pequeño conjunto de propiedades comunes. Siempre se devuelve el ID de la propiedad. Puedes encontrar una lista completa de las propiedades utilizando los endpoints para [obtener todas las propiedades de los contactos](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-contacts/get-properties-v1-contacts-properties#get-all-contact-properties) y [obtener todas las propiedades de las empresas](https://developers.hubspot.es/docs/api-reference/legacy/crm-properties-v1-companies/get-properties-v1-companies-properties#get-all-company-properties). El ID del registro siempre se incluye en las propiedades del objeto que salen en los resultados, incluso cuando no se agrega explícitamente en la lista de propiedades. | | `formatting` | Booleano | Opcional. Da formato a los valores, como las fechas y la divisa, de acuerdo con la configuración del portal. Pasa el parámetro `false` con las cadenas sin procesar. | **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. ```hubl theme={null} {{ crm_property_definition("house_listing", "agent_name") }} ``` | Parámetro | Tipo | Descripción | | --------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Cadena | El nombre del tipo de objeto. Los nombres de los tipos de objetos distinguen entre mayúsculas y minúsculas. Encuentra más información sobre los [tipos de objetos admitidos](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Para encontrar los nombres de los tipos de objetos específicos de la cuenta y de integraciones disponibles en tu cuenta, utiliza la [API del esquema de objetos del CRM](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) para obtener las definiciones de los tipos y encontrar el nombre de la propiedad. Contiene el nombre del tipo de objeto interno que se debe usar para functionFor. En el caso de los tipos de objeto de integraciones y específicos de la cuenta con el mismo nombre que los objetos de la aplicación debes usar el [nombre completamente calificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN, por sus siglas en inglés) de los objetos. | | `property_name` | Cadena | El nombre de la propiedad que sirve para obtener la definición y que no distingue entre mayúsculas y minúsculas. | ## 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. ```hubl theme={null} {{ crm_property_definitions("house_listing", "agent_name,address") }} ``` | Parámetro | Tipo | Descripción | | --------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Cadena | El nombre del tipo de objeto. Los nombres de los tipos de objetos distinguen entre mayúsculas y minúsculas. Encuentra más información sobre los [tipos de objetos admitidos](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Para encontrar los nombres de los tipos de objetos específicos de la cuenta y de integraciones disponibles en tu cuenta, utiliza la [API del esquema de objetos del CRM](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) para obtener las definiciones de los tipos y encontrar el nombre de la propiedad. Contiene el nombre del tipo de objeto interno que se debe usar para functionFor. En el caso de los tipos de objeto de integraciones y específicos de la cuenta con el mismo nombre que los objetos de la aplicación debes usar el [nombre completamente calificado](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN, por sus siglas en inglés) de los objetos. | | `property_name` | Cadena | Opcional. Los nombres de las propiedades que sirven para obtener la definición, separados por comas, sin distinción entre mayúsculas y minúsculas. Si está vacío, se extraerán las definiciones de todas las propiedades. | ## 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. ```text hubl.txt theme={null} {{ cta("ccd39b7c-ae18-4c4e-98ee-547069bfbc5b") }} {{ cta("ccd39b7c-ae18-4c4e-98ee-547069bfbc5b", "justifycenter") }} ``` ```html example.html theme={null} Start a HubSpot trial Start a HubSpot trial ``` | Parámetro | Tipo | Descripción | | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------- | | `guid` | Cadena | El ID de la CTA que se renderiza. Se puede encontrar en la URL de la pantalla de datos de la CTA. | | `align_opt` | Enumeración | Ajusta la alineación de la CTA. Los valores incluyen: `justifyleft`, `justifycenter`, `justifyright`, `justifyfull`. | ## 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. ```text hubl.txt theme={null} {% set vehicles = ["boat","car","bicycle"] %} {% set more_vehicles = ["airplane","motorcycle"] %} {% do vehicles.extend(more_vehicles) %} {{vehicles}} ``` ```text resultados renderizados.txt theme={null} [boat, car, bicycle, airplane, motorcycle] ``` ## 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](#files_by_ids) en su lugar. **Nota:** Esta función está limitada a 10 llamadas por página. ```text hubl.txt theme={null} {% set file = file_by_id(123) %} {{ file.friendlyUrl }} ``` ```text resultados renderizados.txt theme={null} https://www.hubspot.com/hubfs/HubSpot_Logos/HSLogo_color.svg ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ------------------------------- | | `file_id` | Número | El ID del archivo que se busca. | ## 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. ```text hubl.txt theme={null} {% set files = files_by_ids([123,456])%} {% for file in files %} URL:{{file.friendlyUrl}}
{% endfor %} ``` ```text resultados renderizados.txt theme={null} URL:https://api-na1.hubspot.com/filemanager/api/v2/files/123/example-file-1 URL:https://api-na1.hubspot.com/filemanager/api/v2/files/456/example-file-2 ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ---------------------------------------------------------------------- | | `file_id` | Número | Los ID de los archivos que se buscan, separados por comas (hasta 100). | 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](/cms/reference/hubl/filters#split), ya que la propiedad del CRM será una cadena separada con punto y coma. ```hubl theme={null} {% set objects = crm_objects("contact", "email=bh@hubspot.com", "file").results %} {% for item in objects %} {% set fileIDs = item.file|split(";") %} {% set files = files_by_ids(fileIDs) %} {% for file in files %}

File name: {{file.name}}
Friendly Url: {{file.friendlyUrl }}
Url: {{file.url }}

{% endfor %} {% endfor %} ``` ## flag\_content\_for\_access\_check Cuando una publicación de blog está [configurada para el acceso por autorregistro](https://knowledge.hubspot.com/es/blog/use-self-registration-for-private-blog-content), 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](/cms/start-building/features/memberships/overview#private-blog-posts-with-self-registration). 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=` A value of `true` indicates that the blog post requires the visitor to log in to view the full content. ```text hubl.txt theme={null} {% for content in contents %}

...

{% endfor %} ``` ```text resultados renderizados.txt theme={null}

...

``` | Parámetro | Tipo | Descripción | | --------- | ---- | ----------------------------------------------------------------------------------------- | | `ID` | ID | El ID del contenido que se cotejará con la persona que ha iniciado sesión en ese momento. | ## follow\_me\_links Devuelve los [enlaces de las cuentas de redes sociales fijadas en la configuración de la cuenta](https://knowledge.hubspot.com/es/design-manager/use-default-modules-in-the-layout-editor#add-social-accounts-to-the-follow-me-module). Se utiliza en el [módulo predeterminado follow\_me](/cms/reference/modules/default-modules#follow-me). ```text hubl.txt theme={null} {% set fm = follow_me_links() %} {{ fm }} ``` ```text resultados renderizados.txt theme={null} [FollowMeLink{type=URL, id=5142734, altName=RSS, followMeUrl=http://website.com/rss.xml, iconName=rss, name=http://website.com/rss.xml}] ``` ## format\_address Le da formato a una dirección según la configuración regional del contexto. ```text hubl.txt theme={null} {{ format_address('en-us', { address: "25 First Street", address2: "2nd Floor", city: "Cambridge", state: "MA", country: "United States", zip: "02141"}) }} ``` ```text resultados renderizados.txt theme={null} [25 First Street, 2nd Floor, Cambridge, MA 02141, United States] ``` | Parámetro | Tipo | Descripción | | ---------- | ------ | ----------------------------------------------------------------------- | | `locale` | Cadena | La configuración regional que determinará el formato de la dirección. | | `address` | Cadena | La dirección del lugar. | | `address2` | Cadena | La segunda línea de la dirección, como el número de piso o apartamento. | | `city` | Cadena | La ciudad de la dirección. | | `state` | Cadena | El estado de la dirección. | | `country` | Cadena | El país de la dirección. | | `zip` | Cadena | El código postal de la dirección. | ## format\_company\_name Permite darle formato al nombre de una empresa agregando sufijos honoríficos japoneses cuando corresponda. ```text hubl.txt theme={null} {{ format_company_name("companyName", addJapaneseHonorifics) }} ``` ```text resultados renderizados.txt theme={null} HubSpot ``` | Parámetro | Tipo | Descripción | | -------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------- | | `companyName` | Cadena | El nombre de la empresa. | | `useHonorificIfApplicable` | Booleano | Cuando se establece en `true` y el idioma del contexto es japonés, se agregará el sufijo honorífico para la empresa 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. ```text hubl.txt theme={null} {{ format_name("firstName", "surname", addJapaneseHonorifics) }} ``` ```text resultados renderizados.txt theme={null} Hobbes Baron ``` | Parámetro | Tipo | Descripción | Predeterminado | | -------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------- | -------------- | | `firstName` | Cadena | El nombre de la persona. | | | `surname` | Cadena | El apellido de la persona. | `False` | | `useHonorificIfApplicable` | Booleano | Cuando se establece en `true` y el idioma del contexto es japonés, se agregará un sufijo honorífico japonés 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](/cms/reference/hubl/filters#format_datetime). Esta función reemplaza a la función obsoleta `datetimeformat`. ```text hubl.txt theme={null} {{ format_datetime(content.publish_date, "short", "America/New_York", "en") }} ``` ```text resultados renderizados.txt theme={null} 12/31/69 7:00 PM ``` | Parámetro | Tipo | Descripción | | ---------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | Cadena | El formato que se utilizará. Puede ser uno de los siguientes:

`short`
`medium`
`long`
`full`
un patrón personalizado basado en las normas [Unicode LDML](https://unicode.org/reports/tr35/tr35-dates.html#Date_Format_Patterns)

| | `timeZone` | Cadena | La zona horaria de la fecha del resultado en [formato IANA TZDB](https://data.iana.org/time-zones/tzdb/). | | `locale` | Cadena | La configuración regional que se utilizará en los formatos adaptados a la configuración regional. | ## 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. ```html example.html theme={null} {% for row in hubdb_table_rows(1234567, "geo_distance(loc,1.233,-5.678,mi)__gt=500") %} {{row.name}}
{% endfor %} ``` ```html example.html theme={null} Cambridge, MA
Salem, MA
San Diego, CA
Chicago, IL
``` | Parámetro | Tipo | Descripción | | ------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------- | | `point1` | Ubicación | Ubicación desde una columna de HubDB. | | `point2_lat` | Latitud | Latitud del punto 2. | | `point2_long` | Longitud | Longitud del punto 2. | | `units` | Cadena | Unidades de medida del valor resultante. Las opciones son `FT` para pies, `MI` para millas, `M` para metros o `KM` para kilómetros. | ## 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 ` ``` ## 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](https://knowledge.hubspot.com/es/files/automatic-image-resizing-on-hubspot-content). ```text hubl.txt theme={null} {{ resize_image_url("http://your.hubspot.site/hubfs/img.jpg", 0, 0, 300) }} ``` ```text resultados renderizados.txt theme={null} http://your.hubspot.site/hubfs/img.jpg?length=300&name=img.jpg ``` | Parámetro | Tipo | Descripción | | --------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | Cadena | URL de una imagen alojada en HubSpot. | | `width` | Entero (px) | El nuevo ancho de la imagen, en pixeles. | | `height` | Entero (px) | La nueva altura de la imagen, en pixeles. | | `length` | Entero (px) | La nueva longitud del lado más largo, en pixeles. | | `upscale` | Booleano | Utiliza las dimensiones de la imagen redimensionada incluso si superan la imagen original (las imágenes pueden aparecer borrosas). El valor por opción predeterminada es `false`. | | `upsize` | Booleano | Muestra la imagen redimensionada aunque sea mayor que la original en bytes. El valor por opción predeterminada es `false`. | ## 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`](/cms/reference/hubl/filters#reverse) ```text hubl.txt theme={null} {% set numbers = [1,2,3,4] %} {% do numbers.reverse() %} {{numbers}} ``` ```text resultados renderizados.txt theme={null} [4, 3, 2, 1] ``` ## set\_response\_code Establece el código de respuesta como el código especificado. [404](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/404) es el único código admitido por ahora. Cuando se utiliza, la página mostrará un error `404`. ```text hubl.txt theme={null} {{ set_response_code(404) }} ``` ```text resultados renderizados.txt theme={null} ``` | Parámetro | Tipo | Descripción | | --------- | ------ | ----------------------------------------------------------------------------------- | | `code` | Entero | el código de la respuesta del HTTP. Actualmente, `404` es el único código admitido. | ## super Esta función imprime el contenido de la plantilla principal en una plantilla secundaria utilizando la etiqueta [extends](/cms/reference/hubl/overview#blocks-and-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 `

` 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. ```html example.html theme={null} {% extends "custom/page/web_page_basic/parent.html" %} {% block sidebar %}
Table Of Contents
{{ super() }} {% endblock %} ``` ```html example.html theme={null} This is the parent template
Table of contents
Sidebar content from parent. ``` ## 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. ```text hubl.txt theme={null} {{ today() }} {{ today("America/New_York") }} {{ unixtimestamp(today("America/New_York").plusDays(1)) }} ``` ```text resultados renderizados.txt theme={null} 2018-10-23T00:00Z 2018-10-23T00:00-04:00[America/New_York] 1540353600000 ``` ## 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. ```text hubl.txt theme={null} {{ to_local_time(eastern_dt) }} ``` ```text resultados renderizados.txt theme={null} 2015-05-13 10:37:31 ``` | Parámetro | Tipo | Descripción | | --------- | ------------ | ---------------------------------------------------- | | `date` | Fecha y hora | Marca de tiempo UNIX para convertir a la hora local. | ## 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. ```html example.html theme={null} {{ topic_cluster_by_content_id(content.id) }} {%- if content.id -%} {%- set topicCluster = topic_cluster_by_content_id(content.id) -%} {%- if topicCluster.pillarPage.url.value and topicCluster.pillarPage.publishState == "PUBLISHED" -%}
Topic: {{ topicCluster.coreTopic.phrase }}
{%- endif -%} {%- endif -%} ``` ```html example.html theme={null} { attachedContent, topic, coreTopic, pillarPage } (AttachedContentWithContext: {attachedContent=AttachedContent{id=1234, topicId=1234, clusterId=1234, portalId=0, attachable=Attachable{contentId=124, url=ValidatedUri{https://www.hubspot.com/}, attachableType=LANDING_PAGE, title=title, publishState=PUBLISHED, deletedAt=null}, isLinkedToPillarPage=null, isPillarPage=null, createdAt=1547238986475, updatedAt=1547238986475, deletedAt=null}, coreTopic=Optional[Topic{id=1234, portalId=0, clusterId=1234, phrase=TOPIC PHRASE, attachedContent=null, isCoreTopic=false, createdAt=1547157062081, updatedAt=1547232313421, deletedAt=null}], pillarPage=Optional[AttachedContent{id=1234, topicId=1234, clusterId=1234, portalId=0, attachable=Attachable{contentId=null, url=ValidatedUri{https://www.hubspot.com.com/}, attachableType=EXTERNAL_URL, title=null, publishState=PUBLISHED, deletedAt=null}, isLinkedToPillarPage=null, isPillarPage=null, createdAt=1547157062086, updatedAt=1547157062086, deletedAt=null}], topic=Optional[Topic{id=1234, portalId=0, clusterId=8345, phrase=topic phrase, attachedContent=null, isCoreTopic=false, createdAt=1547238962703, updatedAt=1547238962703, deletedAt=null}]})
Topic: core topic phrase
``` Nota: esta función tiene un límite de 10 llamadas por página. | Parámetro | Tipo | Descripción | | ------------ | ---- | -------------------------------- | | `content_id` | ID | El ID de la página que se busca. | ## truncate La función de truncamiento actúa del mismo modo que el [filtro truncar](/cms/reference/hubl/filters#truncate) 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. ```text hubl.txt theme={null} {{ truncate("string to truncate at a certain length", 19, false, "...") }} {% set longString = "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Phasellus sodales ultricies velit sit amet ornare." %} {{ truncate(longString, 40, false, "...") }} ``` ```text resultados renderizados.txt theme={null} string to truncate ... Lorem ipsum dolor sit amet, consectetur ... ``` | Parámetro | Tipo | Descripción | | -------------------- | -------- | --------------------------------------------------------------------------------------------------- | | `string_to_truncate` | Cadena | La cadena que se trunca. | | `length` | Entero | Especifica el punto en el que se debe truncar el texto (incluye los caracteres HTML). | | `killwords` | Booleano | Si es verdadero, la cadena cortará el texto, independientemente de si está en medio de una palabra. | | `end` | Cadena | Los caracteres que se agregarán para indicar dónde se ha truncado el texto. | ## 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"`. ```text hubl.txt theme={null} {{ type("Blog") }} {% set my_type = type("Blog") %}
{{my_type}}
``` ```text resultados renderizados.txt theme={null}
str
``` ## unixtimestamp Esta función da como resultado una marca de tiempo UNIX cuando se proporciona un objeto datetime. ```text hubl.txt theme={null} {{ unixtimestamp(d) }} ``` ```text resultados renderizados.txt theme={null} 1565983117868 ``` ## 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. ```text hubl.txt theme={null} {% set dict_var = {"authorName": "Douglas Judy", "authorTitle": "Mastermind" } %} {% do dict_var.update({"authorFriend": "Jake"}) %} {% do dict_var.update({"authorLocation": "unknown"}) %} {{ dict_var }} ``` ```text resultados renderizados.txt theme={null} {authorName=Douglas Judy, authorTitle=Mastermind, authorFriend=Jake, authorLocation=unknown} ```