This is the parent template

> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # Fonctions HubL > Un listing de référence de toutes les fonctions HubL disponibles. Les fonctions dans HubL sont similaires aux filtres car elles acceptent des paramètres et génèrent une valeur. Cependant, toutes les fonctions n'ont pas besoin d'être appliquées à une valeur de modèle initiale, mais interagissent avec d'autres zones de votre environnement HubSpot. Si vous gérez un site web plus ancien, vous pouvez également consulter la [liste des fonctions HubL obsolètes](/docs/cms/versions-deprecations/deprecated/hubl/filters-functions). Découvrez ci-dessous chaque fonction HubL et sa syntaxe. ## append Ajoute un seul élément à la fin d'une liste. ```text hubl.txt theme={null} {% set numbers_under_5 = [1,2,3] %} {% do numbers_under_5.append(4) %} {{numbers_under_5}} ``` ```text sortie rendue.txt theme={null} [1, 2, 3, 4] ``` | Paramètre | Type | Description | | --------- | ---- | ----------------------------- | | `item` | Tout | Élément à ajouter à la liste. | ## blog\_all\_posts\_url La fonction `blog_all_posts_url` renvoie une URL complète vers la page de listing de tous les articles du blog indiqué. L'exemple ci-dessous montre comment cette fonction peut être utilisée comme `href` d'une ancre. ```html example.html theme={null} All Marketing blog posts ``` ```html example.html theme={null} All Marketing blog posts ``` | Paramètre | Type | Description | | --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Indique le blog à utiliser. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | ## blog\_author\_url La fonction `blog_author_url` renvoie une URL complète vers la page de listing de l'auteur du blog indiqué. L'exemple ci-dessous montre comment cette fonction peut être utilisée comme `href` d'une ancre. Cette fonction peut être combinée avec `blog_authors` comme le montrent les exemples de cette fonction. ```html example.html theme={null} Brian Halligan ``` ```html example.html theme={null} Brian Halligan ``` | Paramètre | Type | Description | | --------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Spécifie le blog dans lequel se trouve la page de listing de l'auteur. Vous pouvez spécifier un blog par ID ou utiliser `"default"` pour sélectionner le blog par défaut. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | | `author_slug` | Chaîne ou variable HubL | Indique l'auteur vers lequel le lien doit être établi. Peut utiliser soit `content.blog_post_author.slug` ou un nom en minuscule avec un trait d'union. Exemple : `"jane-doe"`. | ## blog\_authors La fonction `blog_authors` renvoie une séquence d'objets auteurs de blog pour le blog indiqué, triés par slug en ordre croissant. Cette séquence peut être stockée dans une variable et être parcourue pour créer des filtres d'articles d'auteurs personnalisés. Le nombre d'articles publiés par chaque auteur peut être consulté avec `author.live_posts`. **Remarque :** cette fonction est limitée à 250 auteurs. Cette fonction est également limitée à 10 appels par page. La première ligne de l'exemple ci-dessous montre comment la fonction renvoie une séquence d'objets auteur. La suite de l'exemple montre un cas d'utilisation consistant à enregistrer une séquence dans une variable, puis à parcourir les objets auteur, en imprimant un ensemble de liens de listing d'auteurs. L'exemple suppose que le blog a 4 auteurs. ```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

``` | Paramètre | Type | Description | | --------------- | ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Indique le blog à utiliser, soit un blog spécifique selon son ID, soit le blog par défaut avec `"default"`. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | ## blog\_page\_link La fonction `blog_page_link` génère l'URL d'une vue paginée du listing de votre blog. La fonction prend un paramètre numérique, qui vous permet de générer des liens pour la page actuelle, suivante, précédente ou une page spécifique. Cette fonction est généralement utilisée dans l'attribut `href` des balises d'ancrage de la pagination et doit être utilisée sur le modèle de listing de votre blog. Les exemples ci-dessous montrent cette fonction utilisée comme un `href` d'ancre. Le premier exemple affiche la page actuelle. Le deuxième exemple utilise le paramètre numéro 7 pour la septième page. Le troisième exemple utilise la variable `next_page_num` pour générer un lien relatif au numéro de la page actuelle (vous pouvez également utiliser la variable `last_page_num` pour la page précédente). Le dernier exemple utilise la variable `current_page_num` et un opérateur `+` pour créer un lien supérieur de 4 à la page actuelle. ```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 ``` | Paramètre | Type | Description | | --------- | ----------------------- | ------------------------------------------------------------------------------------- | | `page` | Nombre ou variable HubL | Numéro de page utilisé pour générer l'URL ou la variable HubL pour le numéro de page. | ## blog\_popular\_posts Cette fonction rend un nombre déterminé d'articles populaires en une séquence. La séquence peut ensuite être enregistrée dans une variable et être parcourue par une boucle for, créant un listing personnalisé de vos articles les plus populaires. Les résultats de cette fonction sont mis en cache pendant six heures. Pour récupérer des articles de blog en utilisant HubL d'une manière qui évite la mise en cache, vous pouvez utiliser [blog\_recent\_tag\_posts](#blog-recent-tag-posts) à la place. Dans l'exemple de code ci-dessous, la première ligne montre comment la fonction renvoie une séquence. La séquence est enregistrée en tant que variable qui est ensuite utilisée dans une [boucle for](/docs/cms/reference/hubl/loops). [Toute variable d'article de blog](/docs/cms/reference/hubl/variables#blog-variables) doit utiliser le nom de l'élément individuel de la boucle plutôt que `content.`. Dans l'exemple, `pop_post.name` est utilisé. Cette technique peut être utilisée sur les modèles de blog et les pages de site web. **Remarque :** cette fonction est limitée à 200 articles. Cette fonction est également limitée à 10 appels par page. ```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

``` | Paramètre | Type | Description | | ------------------ | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Indique le blog à utiliser, soit un blog spécifique selon son ID, soit le blog par défaut avec `"default"`. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | | `tag_slug` | Chaîne | Indique la balise sur laquelle le filtre doit porter. Vous pouvez inclure jusqu'à 10 balises, séparées par des virgules. Les balises avec plusieurs mots doivent être en minuscules avec des espaces remplacées par des traits d'union. | | `limit` | Entier | Indique le nombre d'articles à ajouter à la séquence. Ce paramètre est obligatoire lors de l'inclusion d'un paramètre `logical_operator`. | | `logical_operator` | Chaîne | Lorsque `tag_slug` contient plusieurs balises, utilisez cet opérateur pour filtrer les résultats avec la logique `AND` ou `OR`. Par défaut, cette fonction utilise la logique `OR` pour renvoyer les publications étiquetées avec l'une des balises spécifiées. Lorsque vous incluez ce paramètre, `limit` est requis. | ## blog\_tag\_url La fonction `blog_tag_url` renvoie une URL complète vers la page de listing de la balise du blog indiquée. Cette fonction accepte deux paramètres. Le premier paramètre indique dans quel blog se trouve la page de listing de la balise. Le deuxième paramètre indique la balise à mettre en lien. Ce paramètre peut utiliser **`topic.slug`** pour une balise particulière de `content.topic_list` ou accepter un nom en minuscule avec un trait d'union tel que `"marketing-tips"`. L'exemple ci-dessous montre comment cette fonction peut être utilisée comme href d'une ancre. ```html example.html theme={null} Inbound Marketing ``` ```html example.html theme={null} Inbound Marketing ``` | Paramètre | Type | Description | | --------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Indique le blog à utiliser, soit un blog spécifique selon son ID, soit le blog par défaut avec `"default"`. | | `tag_slug` | Chaîne | Indique la balise vers laquelle le lien doit être établi. | ## blog\_tags La fonction `blog_tags` renvoie une séquence des 250 balises les plus présentes dans les blogs (en fonction du nombre d'articles de blog associés) pour le blog indiqué, triées par nombre d'articles de blog.Cette séquence peut être stockée dans une variable et être parcourue pour créer des filtres d'articles de balises personnalisés. Le nombre d'articles pour chaque balise peut être consulté avec `tag.live_posts`. Cette fonction accepte deux paramètres. Le premier paramètre indique le blog à partir duquel récupérer les balises. Le deuxième paramètre fixe une limite au nombre de balises récupérées. La première ligne de l'exemple ci-dessous montre comment la fonction renvoie une séquence d'objets balises. La suite de l'exemple montre un cas d'utilisation consistant à enregistrer une séquence dans une variable, puis à parcourir les objets balise, en imprimant un ensemble de liens de balise. L'exemple suppose que le blog a 4 balises. **Remarque :** cette fonction est limitée à 250 balises. ```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]

``` | Paramètre | Type | Description | | --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | ID du blog ou "default" | Indique le blog à utiliser. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | | `limit` | Entier | Le nombre maximum de balises à renvoyer. | ## blog\_total\_post\_count Cette fonction renvoie le nombre total d'articles publiés dans le blog indiqué. Si aucun paramètre n'est indiqué, il comptera les articles de votre blog par défaut. Vous pouvez également indiquer `"default"` ou l'ID d'un blog différent à comptabiliser. L'ID du blog est disponible dans l'URL de votre tableau de bord pour un blog particulier. **Remarque :** cette fonction est limitée à 10 appels par page. ```text hubl.txt theme={null} {{ blog_total_post_count }} {{ blog_total_post_count(359485112) }} ``` ```text sortie rendue.txt theme={null} 16 54 ``` | Paramètre | Type | Description | | --------------- | ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | `selected_blog` | ID du blog ou "default" | Indique le blog à comptabiliser. L'ID du blog est renvoyé selon le [champ blog du module](/docs/cms/reference/fields/module-theme-fields#blog). | ## clear Supprime tous les éléments d'une liste. Contrairement à `pop()`, il ne renvoie rien. ```text hubl.txt theme={null} {% set words = ["phone","home"] %} {% do words.clear() %} {{words}} ``` ```text sortie rendue.txt theme={null} [] ``` ## color\_contrast Cette fonction valide le contraste des couleurs en fonction des [normes WCAG](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum). Vous devrez inclure deux couleurs comme arguments, et vous pouvez inclure un argument facultatif pour spécifier l'évaluation (`AA` ou `AAA`). Renvoie `true` ou `false` selon que les couleurs respectent/dépassent la norme. ```text hubl.txt theme={null} {{color_contrast('#FFFFFF','#273749')}} {{color_contrast('rgb(255, 255, 255)','rgb(229, 237, 245)','AAA')}}

Hey there

``` ```text sortie rendue.txt theme={null} true false Hey there ``` | Paramètre | Type | Description | | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `color_1` | Couleur | La première couleur à comparer. Accepte :

les codes hexadécimaux à 6 chiffres (`#FFFFFF`)
les codes hexadécimaux à 3 chiffres (`#F0A`)
les codes couleur RVB (`rgb(12,31,1)`)

Peut également utiliser une variable qui stocke un code de couleur hexadécimal ou RVB. Par exemple :`theme.primary_color.color` | | `color_2` | Couleur | La deuxième couleur à comparer à la première. | | `rating` | Chaîne | La norme WCAG à utiliser pour l'évaluation. Peut être soit `AA` (par défaut) ou `AAA`. | ## color\_variant Cette fonction éclaircit ou assombrit une valeur hex ou une variable couleur d'une quantité définie. Le premier paramètre est la couleur hex (par exemple ("#FFDDFF") ou une variable stockant une valeur hex. Le deuxième paramètre est la quantité pour l'ajustement, de 0 à 255. Cette fonction peut être utilisée dans les fichiers CSS pour créer une variation de couleur. Un autre bon cas d'utilisation est de l'utiliser avec un paramètre couleur d'un module couleur, pour permettre aux utilisateurs d'indiquer une couleur primaire qui génère automatiquement une variation de couleur. Dans l'exemple ci-dessous, la couleur hex #3A539B est stockée dans une variable appelée `base_color`. La couleur est modifiée par -80, ce qui donne un bleu plus foncé (#00034B). ```text hubl.txt theme={null} {% set base_color ="#3A539B" %} {{ color_variant(base_color, -80) }} ``` ```text sortie rendue.txt theme={null} #00034b ``` | Paramètre | Type | Description | | ------------------- | ---------------------- | ------------------------------------------------------------------------------------ | | `base_color` | Chaîne de couleurs hex | La couleur de départ à modifier. Par exemple : `#F7F7F7`. | | `brightness_offset` | Entier | Un nombre positif ou négatif utilisé pour éclaircir ou assombrir la couleur de base. | ## content\_by\_id La fonction **`content_by_id`** renvoie une page de destination, une page de site web ou un article de blog par ID. Le seul paramètre accepté par cette fonction est un ID du contenu numérique. L'exemple de code ci-dessous montre l'utilisation de cette fonction pour générer un élément de liste avec lien hypertexte. **Remarque :** cette fonction est limitée à 10 appels par page. ```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?

``` | Paramètre | Type | Description | | --------- | ---- | ----------------------------- | | `id` | ID | L'ID du contenu à rechercher. | ## content\_by\_ids La liste d'ID de contenu donnée, renvoie un dictionnaire de pages de destination, de pages de site web ou d'articles de blog correspondant à ces ID. Cette fonction prend un paramètre, une liste d'ID de pages ou d'articles de blog à rechercher, placés dans un tableau. Jusqu'à 100 objets de contenu peuvent être transmis. L'exemple de code ci-dessous montre l'utilisation de cette fonction pour générer une liste d'éléments de liste avec lien hypertexte. **Remarque :** cette fonction est limitée à 10 appels par page. ```html example.html theme={null} {% set contents = content_by_ids([4715624297, 4712623297, 5215624284]) %}

{{content.title}}

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

``` | Paramètre | Type | Description | | --------- | ----- | ---------------------------------------------------------------------------------------------------------------- | | `ids` | Liste | Une liste d'ID de pages ou d'articles de blog à rechercher. Jusqu'à 100 objets de contenu peuvent être transmis. | ## copy Renvoie une copie simplifiée de la liste. Équivalent à `a[:]`. Une *copie simplifiée* construit un nouvel objet composé, puis (dans la mesure du possible) insère dans celui-ci des *références* aux objets présents dans l'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 sortie rendue.txt theme={null} a: [ham] b: [ham] After Append a: [ham, swiss] b: [ham] ``` ## count Renvoie le nombre de fois qu'une variable existe dans une liste. ```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 Obtient une liste d'enregistrements CRM associés à un autre enregistrement par son ID d'enregistrement, sa catégorie d'association et son ID de définition d'association. Cette fonction renvoie un objet avec les attributs suivants : `has_more`, `total`, `offset` et `results`. * `has_more` indique qu'il y a plus de résultats disponibles au-delà de ce lot (total > offset). * `total` est le nombre total de résultats disponibles. * `offset` est le décalage à utiliser pour le prochain lot de résultats. * *`results`* renvoie un tableau des objets associés indiqués correspondant aux paramètres de la fonction **Remarque :** pour des raisons de sécurité, parmi les [types d'objets standards de HubSpot](https://knowledge.hubspot.com/fr/get-started/manage-your-crm-database#standard-objects), seuls les objets `product` et `marketing_event` peuvent être récupérés sur une page accessible au public. Tout autre type d'objet standard doit être hébergé sur une page qui est soit [protégée par un mot de passe](https://knowledge.hubspot.com/fr/website-pages/password-protect-a-page) ou qui nécessite une [connexion au contrôle d'accès CMS](https://knowledge.hubspot.com/fr/website-pages/require-member-registration-to-access-private-content). Les objets personnalisés n'ont pas cette même restriction. ```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 sortie rendue.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}]} ``` **Remarque :** cette fonction peut être appelée au maximum 10 fois par page. Chaque appel `crm_associations` peut renvoyer au maximum 100 objets. La limite par défaut est de 10 objets. | Paramètre | Type | Description | | ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | ID | de l'enregistrement à partir duquel les associations doivent être trouvées. | | `association category` | Chaîne | La catégorie de la définition de l'association. Les valeurs possibles sont : `HUBSPOT_DEFINED`, `USER_DEFINED` et `INTEGRATOR_DEFINED`. Ce paramètre peut être omis pour les types d'association intégrés définis par HubSpot. | | `association type id` | Entier | L'ID de la définition de l'association à utiliser. Pour les objets standards pris en charge par HubSpot, voir l'[ID du type d'association à utiliser](https://developers.hubspot.fr/docs/guides/api/crm/associations). Sinon, cet ID d'association peut être trouvé dans [l'API de schéma d'objets CRM](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details). | | `query` | Chaîne | L'`id` de l'enregistrement OU une chaîne de requête, délimitée par `&`. Toutes les expressions sont combinées par un ET. Les opérateurs pris en charge :

`eq` (par défaut),
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (pour les propriétés à plusieurs valeurs ou de chaîne, comme *"firstname\_\_contains=Tim"*)

Les requêtes peuvent inclure les paramètres suivants :

`limit` : le nombre maximum de résultats renvoyés dans la réponse. Par exemple, `limit=50`.
`offset` : pour paginer les résultats si le nombre de résultats renvoyés est supérieur au paramètre de limite. Par exemple, `offset=51`.
`orderBy` : classer les résultats selon une propriété spécifique. Par exemple : `orderBy=email`.

| | `properties` | Chaîne | Facultative. Une liste de propriétés à renvoyer, séparées par des virgules. Par défaut, un petit ensemble de propriétés communes est renvoyé. La propriété de l'ID est toujours renvoyée.Une liste complète des propriétés peut être trouvée en utilisant les points de terminaisons [obtenir toutes les propriétés du contact](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) et [obtenir toutes les propriétés de l'entreprise](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-companies#get-all-company-properties). | | `formatting` | Booléen | Facultatif. Formatez les valeurs telles que les dates et les devises en fonction des paramètres de ce portail. Omettre ou transmettre `false` pour les chaînes brutes. | ## crm\_object Récupère un seul enregistrement CRM par requête ou selon son ID. Les enregistrements sont renvoyés sous la forme d'un dictionnaire de propriétés et de valeurs. Cette fonction peut également être [utilisée avec des objets personnalisés et des objets intégrateurs](/docs/cms/start-building/features/data-driven-content/crm-objects). **Remarque :** pour des raisons de sécurité, parmi les [types d'objets standards de HubSpot](https://knowledge.hubspot.com/fr/get-started/manage-your-crm-database#standard-objects), seuls les objets `product` et `marketing_event` peuvent être récupérés sur une page accessible au public. Tout autre type d'objet standard doit être hébergé sur une page qui est soit [protégée par un mot de passe](https://knowledge.hubspot.com/fr/website-pages/password-protect-a-page) ou qui nécessite une [connexion au contrôle d'accès CMS](https://knowledge.hubspot.com/fr/website-pages/require-member-registration-to-access-private-content). Les objets personnalisés n'ont pas cette même restriction. Quelle est la différence entre `in` et `contains` ? `in` renvoie quelque chose si la valeur de la propriété correspond à l'une des valeurs données. Alors que `contains` renvoie quelque chose seulement si les valeurs de la propriété, pour sélection multiple, ont toutes les valeurs données. ```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 sortie rendue.txt theme={null} Brian Halligan ``` **Remarque :** cette fonction ne peut être appelée qu'au maximum 10 fois par page. | Paramètre | Type | Description | | ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Chaîne | Le nom du type d'objet. Les noms des types d'objets tiennent compte de la casse.[Les types d'objets pris en charge](/docs/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Pour trouver les noms des types d'objets spécifiques aux comptes et aux intégrateurs disponibles dans votre compte, utilisez l'[API de schéma d'objets CRM](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) pour obtenir les définitions des types et rechercher la propriété name. Elle contient le nom du type d'objet interne qui doit être utilisé dans la l'intégrateur functionFor pour les types d'objets spécifiques à l'intégrateur et au compte ayant le même nom que les objets intégrés, utilisez les objets [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN). | | `query` | Chaîne | Facultative. L'`id` de l'enregistrement OU une chaîne de requête, délimitée par `&`. Toutes les expressions sont combinées par un ET. Les opérateurs pris en charge :

`eq` (par défaut)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains`, (pour les propriétés à plusieurs valeurs ou de chaîne, comme *"firstname\_\_contains=Tim"*)

Les requêtes peuvent inclure les paramètres suivants :

`limit` : le nombre maximum de résultats renvoyés dans la réponse. Par exemple, `limit=50`.
`offset` : pour paginer les résultats si le nombre de résultats renvoyés est supérieur au paramètre de limite. Par exemple, `offset=51`.
`orderBy` : classer les résultats selon une propriété spécifique. Par exemple : `orderBy=email`.

| | `properties` | Chaîne | Facultative. Une liste de propriétés à renvoyer, séparées par des virgules. Par défaut, un petit ensemble de propriétés communes est renvoyé. La propriété de l'ID est toujours renvoyée.Une liste complète des propriétés peut être trouvée en utilisant les points de terminaisons [obtenir toutes les propriétés du contact](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) et [obtenir toutes les propriétés de l'entreprise](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-companies#get-all-company-properties). | | `formatting` | Booléen | Facultatif. Formatez les valeurs telles que les dates et les devises en fonction des paramètres de ce portail. Transmettre `false` pour les chaînes brutes. | **Remarque :** lors de la création d'une requête, les valeurs `range`, `distinct`, `ndistinct` et `startswith` sont des mots-clés réservés. Pour interroger une propriété qui utilise l'un de ces noms, vous devez utiliser le format suivant : `range__eq=` (plutôt que `range=`). ## crm\_objects Obtient une liste d'enregistrements pour un type d'objet spécifique à partir du CRM de HubSpot. Cette fonction renvoie un objet avec les attributs suivants : `has_more`, `total`, `offset` et `results`. * `has_more` indique qu'il y a plus de résultats disponibles au-delà de ce lot (total > offset). * `total` est le nombre total de résultats disponibles. * `offset` est le décalage à utiliser pour le prochain lot de résultats. * `results` renvoie un tableau des objets indiqués correspondant aux paramètres de la fonction Les résultats peuvent être triés en utilisant au moins un paramètre de classement dans la requête. Par exemple, `crm_objects("contact", "firstname=Bob&order=lastname&order=createdate")` classera les contacts portant le prénom `"Bob"` par nom de famille, puis par `createdate`. Pour inverser un tri, ajoutez `-` devant le nom de la propriété, par exemple `order=-createdate`. La fonction d'objets CRM peut également être [utilisée avec des objets personnalisés et des objets intégrateurs](/docs/cms/start-building/features/data-driven-content/crm-objects). **Remarque :** pour des raisons de sécurité, parmi les [types d'objets standards de HubSpot](https://knowledge.hubspot.com/fr/get-started/manage-your-crm-database#standard-objects), seuls les objets `product` et `marketing_event` peuvent être récupérés sur une page accessible au public. Tout autre type d'objet standard doit être hébergé sur une page qui est soit [protégée par un mot de passe](https://knowledge.hubspot.com/fr/website-pages/password-protect-a-page) ou qui nécessite une [connexion au contrôle d'accès CMS](https://knowledge.hubspot.com/fr/website-pages/require-member-registration-to-access-private-content). Les objets personnalisés n'ont pas cette même restriction. ```text hubl.txt theme={null} {% set objects = crm_objects("contact", "firstname__not_null=&limit=3", "firstname,lastname") %} {{ objects }} ``` ```text sortie rendue.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}]} ``` **Remarque :** cette fonction peut être appelée au maximum 10 fois par page. Chaque appel `crm_objects` peut renvoyer au maximum 100 objets. La limite par défaut est de 10 objets. | Paramètre | Type | Description | | ------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Chaîne | Le type d'objet par nom. Les noms des types d'objets tiennent compte de la casse. Le singulier et le pluriel sont acceptés pour les types d'objets standards (par exemple, `contact`, `contacts`). Découvrez-en davantage sur les [types d'objets pris en charge](/docs/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Pour trouver les noms des types d'objets spécifiques aux comptes et aux intégrateurs disponibles dans votre compte, utilisez l'[API de schéma d'objets CRM](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) pour obtenir les définitions des types et la propriété name. Pour les types d'objets spécifiques à l'intégrateur et au compte ayant le même nom que les objets intégrés, utilisez les objets [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN). | | `query` | Chaîne | Facultative. L'ID de l'enregistrement ou une chaîne de requête, délimitée par `&`. Toutes les expressions sont combinées par un ET.Les opérateurs pris en charge :

`eq` (par défaut)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains`, (pour les propriétés à plusieurs valeurs ou de chaîne, comme *"firstname\_\_contains=Tim"*)

Exemple : `"email=contact@company.com"` | | `properties` | Chaîne | Facultative. Une liste de propriétés à renvoyer, séparées par des virgules. Par défaut, un petit ensemble de propriétés communes est renvoyé. La propriété ID est toujours renvoyée. Une liste complète des propriétés peut être trouvée en utilisant les points de terminaisons [obtenir toutes les propriétés du contact](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) et [obtenir toutes les propriétés de l'entreprise](https://developers.hubspot.fr/docs/reference/api/crm/properties/v1-companies#get-all-company-properties). L'ID de l'enregistrement est toujours inclus dans les propriétés de l'objet renvoyé, même s'il n'est pas explicitement ajouté dans la liste des propriétés. | | `formatting` | Booléen | Facultatif. Formatez les valeurs telles que les dates et les devises en fonction des paramètres de ce portail. Transmettre `false` pour les chaînes brutes. | **Remarque :** lors de la création d'une requête, les valeurs `range`, `distinct`, `ndistinct` et `startswith` sont des mots-clés réservés. Pour interroger une propriété qui utilise l'un de ces noms, vous devez utiliser le format suivant : `range__eq=` (plutôt que `range=`). ## crm\_property\_definition Obtenir la définition de la propriété pour un type d'objet et un nom de propriété donnés. Les types d'objets pris en charge sont les objets standards HubSpot (par exemple, contacts), les objets spécifiques au portail et les objets intégrateurs. ```hubl theme={null} {{ crm_property_definition("house_listing", "agent_name") }} ``` | Paramètre | Type | Description | | --------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Chaîne | Le nom du type d'objet. Les noms des types d'objets tiennent compte de la casse. [Les types d'objets pris en charge](/docs/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Pour trouver les noms des types d'objets spécifiques aux comptes et aux intégrateurs disponibles dans votre compte, utilisez l'[API de schéma d'objets CRM](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) pour obtenir les définitions des types et rechercher la propriété name. Elle contient le nom du type d'objet interne qui doit être utilisé dans la l'intégrateur functionFor pour les types d'objets spécifiques à l'intégrateur et au compte ayant le même nom que les objets intégrés, utilisez les objets [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN). | | `property_name` | Chaîne | Le nom de la propriété, sans tenir compte de la casse, dont la définition doit être récupérée. | ## crm\_property\_definitions Obtenir les définitions de propriété pour un type d'objet et un ensemble de noms de propriétés donnés. Les types d'objets pris en charge sont les objets standards HubSpot (par exemple, contacts), les objets spécifiques au portail et les objets intégrateurs. ```hubl theme={null} {{ crm_property_definitions("house_listing", "agent_name,address") }} ``` | Paramètre | Type | Description | | --------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Chaîne | Le nom du type d'objet. Les noms des types d'objets tiennent compte de la casse. [Les types d'objets pris en charge](/docs/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Pour trouver les noms des types d'objets spécifiques aux comptes et aux intégrateurs disponibles dans votre compte, utilisez l'[API de schéma d'objets CRM](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) pour obtenir les définitions des types et rechercher la propriété name. Elle contient le nom du type d'objet interne qui doit être utilisé dans la l'intégrateur functionFor pour les types d'objets spécifiques à l'intégrateur et au compte ayant le même nom que les objets intégrés, utilisez les objets [nom entièrement qualifié](/docs/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (FQN). | | `property_name` | Chaîne | Facultative. Les noms de propriétés séparés par des virgules, sans tenir compte de la casse, pour lesquels il faut récupérer la définition. S'il est vide, les définitions de toutes les propriétés seront récupérées. | ## cta Étant donné que les modules CTA possèdent de nombreux paramètres qui contiennent des variations de leur code, vous pouvez utiliser la fonction CTA pour générer facilement un CTA particulier dans un modèle, une page ou un e-mail. Cette fonction est celle que l'éditeur de texte enrichi utilise lorsque vous ajoutez un CTA via l'éditeur. **Remarque :** cette fonction est limitée à 10 appels par page. ```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 ``` | Paramètre | Type | Description | | ----------- | ----------- | -------------------------------------------------------------------------------------------------------------------- | | `guid` | Chaîne | L'ID du CTA à rendre. Se trouve dans l'URL de l'écran de détails du CTA. | | `align_opt` | Énumération | Ajuste l'alignement du CTA. Les valeurs comprennent : `justifyleft`, `justifycenter`, `justifyright`, `justifyfull`. | ## extend Étend une liste en ajoutant tous les éléments d'une table itérative. En d'autres termes, insérer tous les éléments d'une liste dans une autre liste. ```text hubl.txt theme={null} {% set vehicles = ["boat","car","bicycle"] %} {% set more_vehicles = ["airplane","motorcycle"] %} {% do vehicles.extend(more_vehicles) %} {{vehicles}} ``` ```text sortie rendue.txt theme={null} [boat, car, bicycle, airplane, motorcycle] ``` ## file\_by\_id Cette fonction renvoie les métadonnées d'un fichier par ID. Elle accepte un seul paramètre, l'ID numérique du fichier à rechercher. Pour récupérer plusieurs fichiers à la fois, utilisez plutôt la fonction [files\_by\_ids](#files_by_ids). **Remarque :** cette fonction est limitée à 10 appels par page. ```text hubl.txt theme={null} {% set file = file_by_id(123) %} {{ file.friendlyUrl }} ``` ```text sortie rendue.txt theme={null} https://www.hubspot.com/hubfs/HubSpot_Logos/HSLogo_color.svg ``` | Paramètre | Type | Description | | --------- | ------ | ----------------------------- | | `file_id` | Nombre | L'ID du fichier à rechercher. | ## files\_by\_ids Renvoie les métadonnées de plusieurs fichiers par ID. Cela accepte un tableau d'ID de fichiers. **Remarque :** cette fonction est limitée à 10 appels par page et peut accepter jusqu'à 100 ID de fichier. ```text hubl.txt theme={null} {% set files = files_by_ids([123,456])%} {% for file in files %} URL:{{file.friendlyUrl}}
{% endfor %} ``` ```text sortie rendue.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 ``` | Paramètre | Type | Description | | --------- | ------ | ------------------------------------------------------------------------- | | `file_id` | Nombre | Les ID des fichiers à rechercher, séparés par des virgules (jusqu'à 100). | Par exemple, vous pouvez utiliser cette fonction pour parcourir les fichiers téléchargés d'une fiche d'informations d'un contact. Pour parcourir les résultats, vous devrez utiliser le [filtre HubL divisé](/docs/cms/reference/hubl/filters#split), car la propriété CRM sera renvoyée sous la forme d'une chaîne séparée par un point-virgule. ```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 Lorsqu'un article de blog est [configuré pour l'accès à l'auto-inscription](https://knowledge.hubspot.com/fr/blog/use-self-registration-for-private-blog-content), les visiteurs devront s'inscrire ou se connecter pour afficher le contenu complet de l'article. Les ressources de listing de blog par défaut de HubSpot incluent automatiquement cette fonctionnalité, et incluront également un indicateur d'icône de cadenas pour les articles qui nécessitent une auto-inscription pour y accéder. En savoir plus sur la [création de solutions personnalisées à l'aide de cette fonction et de son API correspondante](/docs/cms/start-building/features/memberships/overview#private-blog-posts-with-self-registration). Cette fonction vérifie si un article de blog est accessible au visiteur actuel. Lorsqu'elle est appelée, la fonction est remplacée par l'attribut suivant : `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 sortie rendue.txt theme={null}

...

``` | Paramètre | Type | Description | | --------- | ---- | ------------------------------------------------------------------------------- | | `ID` | ID | L'ID du contenu qui sera vérifié par rapport au visiteur actuellement connecté. | ## follow\_me\_links Renvoie les [liens de compte de réseau social définis dans les paramètres du compte](https://knowledge.hubspot.com/fr/design-manager/use-default-modules-in-your-template#add-social-accounts-to-the-follow-me-module). Utilisé dans le [module follow\_me par défaut](/docs/cms/reference/modules/default-modules#follow-me). ```text hubl.txt theme={null} {% set fm = follow_me_links() %} {{ fm }} ``` ```text sortie rendue.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 Formate une adresse en fonction des paramètres régionaux du contexte. ```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 sortie rendue.txt theme={null} [25 First Street, 2nd Floor, Cambridge, MA 02141, United States] ``` | Paramètre | Type | Description | | ---------- | ------ | ------------------------------------------------------------------------- | | `locale` | Chaîne | Les paramètres régionaux selon lesquels formater l'adresse. | | `address` | Chaîne | L'adresse postale. | | `address2` | Chaîne | La deuxième ligne de l'adresse, comme le numéro d'étage ou d'appartement. | | `city` | Chaîne | La ville de l'adresse. | | `state` | Chaîne | L'état de l'adresse. | | `country` | Chaîne | Le pays de l'adresse. | | `zip` | Chaîne | Le code postal de l'adresse. | ## format\_company\_name Formate le nom d'une entreprise en ajoutant des titres honorifiques japonais, le cas échéant. ```text hubl.txt theme={null} {{ format_company_name("companyName", addJapaneseHonorifics) }} ``` ```text sortie rendue.txt theme={null} HubSpot ``` | Paramètre | Type | Description | | -------------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `companyName` | Chaîne | Le nom de l'entreprise. | | `useHonorificIfApplicable` | Booléen | Lorsque cet élément est défini sur `true` et que la langue du contexte est le japonais, un titre honorifique d'entreprise japonais sera ajouté, le cas échéant. | ## format\_name Formate le nom d'une personne en plaçant le nom de famille avant le prénom et ajoute des titres honorifiques japonais, le cas échéant. ```text hubl.txt theme={null} {{ format_name("firstName", "surname", addJapaneseHonorifics) }} ``` ```text sortie rendue.txt theme={null} Hobbes Baron ``` | Paramètre | Type | Description | Par défaut | | -------------------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | `firstName` | Obligatoire | Le prénom de la personne. | | | `surname` | Chaîne | Le nom ou prénom de la personne. | `False` | | `useHonorificIfApplicable` | Booléen | Lorsque cet élément est défini sur `true` et que la langue du contexte est le japonais, un titre honorifique japonais sera ajouté, le cas échéant. | | ## format\_datetime Formate les composants de date et d'heure d'un objet de date, comme pour le filtre HubL [format\_datetime](/docs/cms/reference/hubl/filters#format_datetime). Cette fonction remplace la fonction obsolète `datetimeformat`. ```text hubl.txt theme={null} {{ format_datetime(content.publish_date, "short", "America/New_York", "en") }} ``` ```text sortie rendue.txt theme={null} 12/31/69 7:00 PM ``` | Paramètre | Type | Description | | ---------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | Chaîne | Le format à utiliser. Peut être l'un des éléments suivants :

`short`
`medium`
`long`
`full`
un modèle personnalisé reposant sur [Unicode LDML](https://unicode.org/reports/tr35/tr35-dates.html#Date_Format_Patterns)

| | `timeZone` | Chaîne | Le fuseau horaire de la date de sortie au format [IANA TZDB](https://data.iana.org/time-zones/tzdb/). | | `locale` | Chaîne | Les paramètres régionaux à utiliser pour les formats reposant sur des paramètres régionaux. | ## geo\_distance Cette fonction contient 4 paramètres et calcule la distance ellipsoïdale 2D entre deux points sur la Terre. Utilisez cette fonction comme une requête de filtre pour obtenir des données 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
``` | Paramètre | Type | Description | | ------------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------- | | `point1` | Emplacement | Emplacement à partir d'une colonne HubDB. | | `point2_lat` | Latitude | Latitude du point2. | | `point2_long` | Longitude | Longitude du point2. | | `units` | Chaîne | Unités pour la valeur de renvoi. Les options sont `FT` pour pieds, `MI` pour miles, `M` pour mètres ou `KM` pour kilomètres. | ## get\_asset\_url Cette fonction renvoie l'URL publique d'un modèle ou d'un fichier de code indiqué. Le paramètre de cette fonction est le chemin d'accès de la ressource dans le gestionnaire de conception. Les URL des fichiers codés sont mises à jour à chaque fois que vous les publiez ; par conséquent, en utilisant cette fonction, vous vous assurez de toujours utiliser la dernière version du fichier. Vous pouvez générer automatiquement cette fonction dans l'application, soit en faisant un clic droit sur un **fichier** et en sélectionnant **Copier l'URL publique**, soit en cliquant sur **Actions**, puis en sélectionnant **Copier l'URL publique**. L'exemple ci-dessous permet d'obtenir l'URL d'un fichier JavaScript créé dans le gestionnaire de conception qui peut être inclus comme `src` d'une balise ` ``` ## resize\_image\_url Réécrit l'URL de l'image stockée dans le Gestionnaire de fichiers en une URL qui redimensionnera l'image sur demande. La fonction accepte un paramètre obligatoire et cinq paramètres facultatifs. Au moins un paramètre facultatif doit être transmis. Obligatoire * **URL :** chaîne, URL d'une image hébergée par HubSpot. Facultatif * **width :** nombre, la nouvelle largeur de l'image en pixels. * **height :** nombre, la nouvelle hauteur de l'image en pixels. * **length :** nombre, la nouvelle longueur du plus grand côté, en pixels. * **upscale :** booléen, utilise les dimensions de l'image redimensionnée même si elles augmentent l'échelle de l'image originale (les images peuvent apparaître floues). * **upsize :** booléen, renvoie l'image redimensionnée même si elle est plus grande que l'originale en octets. **Remarque :** les images supérieures à 4 096 pixels en hauteur ou en largeur ne seront pas automatiquement redimensionnées. Au lieu de cela, vous devrez [redimensionner manuellement l'image](https://knowledge.hubspot.com/fr/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 sortie rendue.txt theme={null} http://your.hubspot.site/hubfs/img.jpg?length=300&name=img.jpg ``` | Paramètre | Type | Description | | --------- | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | Chaîne | URL d'une image hébergée par HubSpot. | | `width` | Entier (px) | La nouvelle largeur de l'image, en pixels. | | `height` | Entier (px) | La nouvelle hauteur de l'image, en pixels. | | `length` | Entier (px) | La nouvelle longueur du plus grand côté, en pixels. | | `upscale` | Booléen | Utilise les dimensions de l'image redimensionnée même si elles augmentent l'échelle de l'image originale (les images peuvent apparaître floues). La valeur par défaut est `false`. | | `upsize` | Booléen | Renvoie l'image redimensionnée même si elle est plus grande que l'originale en octets.La valeur par défaut est `false`. | ## reverse Inverse le classement des éléments d'une liste. Il ne prend pas de paramètres. Pour inverser un objet ou renvoyer un itérateur pour parcourir la liste en sens inverse, utilisez [`|reverse`](/docs/cms/reference/hubl/filters#reverse) ```text hubl.txt theme={null} {% set numbers = [1,2,3,4] %} {% do numbers.reverse() %} {{numbers}} ``` ```text sortie rendue.txt theme={null} [4, 3, 2, 1] ``` ## set\_response\_code Définir le code de réponse comme le code indiqué. [404](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404) est le seul code pris en charge pour le moment. Si vous l'utilisez, votre page renverra une erreur `404`. ```text hubl.txt theme={null} {{ set_response_code(404) }} ``` ```text sortie rendue.txt theme={null} ``` | Paramètre | Type | Description | | --------- | ------ | ----------------------------------------------------------------------------- | | `code` | Entier | Le code de réponse HTTP. Actuellement, `404` est le seul code pris en charge. | ## super Cette fonction imprime le contenu du modèle parent dans un modèle enfant en utilisant la balise [extends](/docs/cms/reference/hubl/overview#blocks-and-extends). Par exemple, dans le code ci-dessous, un modèle HTML de base a été créé avec un bloc HubL nommé `sidebar` et enregistré sous `parent.html`. Un deuxième fichier de modèle est créé et va étendre ce fichier parent. Normalement, le `

` serait imprimé dans le bloc de la barre latérale du HTML parent. Mais en utilisant `super`, le contenu du bloc de la barre latérale du modèle parent est combiné avec le contenu du modèle enfant. ```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 Renvoie le début de la journée (12h00). Vous pouvez éventuellement ajouter un paramètre pour modifier le fuseau horaire par rapport à l'UTC par défaut. ```text hubl.txt theme={null} {{ today() }} {{ today("America/New_York") }} {{ unixtimestamp(today("America/New_York").plusDays(1)) }} ``` ```text sortie rendue.txt theme={null} 2018-10-23T00:00Z 2018-10-23T00:00-04:00[America/New_York] 1540353600000 ``` ## to\_local\_time Convertit un horodatage UNIX en heure locale, en fonction des paramètres de votre rapport HubSpot. Vous pouvez ensuite appliquer un filtre datetimeformat pour formater la date. ```text hubl.txt theme={null} {{ to_local_time(eastern_dt) }} ``` ```text sortie rendue.txt theme={null} 2015-05-13 10:37:31 ``` | Paramètre | Type | Description | | --------- | ---------- | --------------------------------- | | `date` | Horodatage | UNIX à convertir en heure locale. | ## topic\_cluster\_by\_content\_id Renvoie un dictionnaire HubL représentant le groupe thématique associé à un élément de contenu (déterminé par l'id de contenu transmis), y compris les métadonnées sur la page pilier associée, le thème principal et les sous-thèmes. Peut être utilisé pour établir un "auto-link" entre un élément de contenu et la page pilier qui lui est associée \[si elle existe]. Les métadonnées disponibles se trouvent dans : attachableContent (les métadonnées du contenu actuel), topic (les métadonnées du thème associé du contenu actuel), coreTopic (les métadonnées du thème principal du groupe associé), et pillarPage (les métadonnées de la page pilier associées). Utilisez `{{ topicCluster|pprint }}` pour obtenir un affichage complet des propriétés/attributs 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
``` Remarque : cette fonction est limitée à 10 appels par page. | Paramètre | Type | Description | | ------------ | ---- | ----------------------------- | | `content_id` | ID | L'id de la page à rechercher. | ## truncate La fonction truncate s'utilise de la même manière que le [filtre truncate](/docs/cms/reference/hubl/filters#truncate), mais utilise la syntaxe de la fonction au lieu de celle du filtre. Le premier paramètre indique la chaîne. Le deuxième paramètre indique la longueur à laquelle il faut tronquer. Le dernier paramètre indique les caractères à ajouter lorsque la troncature se produit. Remarque : comme cette fonction s'appuie sur les espaces entre les mots pour raccourcir les chaînes, il se peut qu'elle ne fonctionne pas comme prévu pour les langues sans espace entre caractères, comme le japonais. ```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 sortie rendue.txt theme={null} string to truncate ... Lorem ipsum dolor sit amet, consectetur ... ``` | Paramètre | Type | Description | | -------------------- | ------- | -------------------------------------------------------------------------------------------- | | `string_to_truncate` | Chaîne | Chaîne qui sera tronquée. | | `length` | Entier | indique la longueur à laquelle le texte doit être tronqué (y compris les caractères HTML). | | `killwords` | Booléen | Si elle est vraie, la chaîne coupera le texte en longueur, même si c'est au milieu d'un mot. | | `end` | Chaîne | Les caractères qui seront ajoutés pour indiquer où le texte a été tronqué. | ## type Cette fonction accepte un argument et renvoie le type d'un objet. La valeur de renvoie peut être : `"bool"`, `"datetime"`, `"dict"`, `"float"`, `"int"`, `"list"`, `"long"`, `"null"`, `"str"` ou `"tuple"`. ```text hubl.txt theme={null} {{ type("Blog") }} {% set my_type = type("Blog") %}
{{my_type}}
``` ```text sortie rendue.txt theme={null}
str
``` ## unixtimestamp Cette fonction renvoie un horodatage unix lorsque vous fournissez un objet datetime. ```text hubl.txt theme={null} {{ unixtimestamp(d) }} ``` ```text sortie rendue.txt theme={null} 1565983117868 ``` ## update Met à jour le dictionnaire avec les éléments d'un autre objet dictionnaire ou d'une table itérative de paires clé/valeur. Utilisez cette fonction pour combiner ou fusionner des objets. ```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 sortie rendue.txt theme={null} {authorName=Douglas Judy, authorTitle=Mastermind, authorFriend=Jake, authorLocation=unknown} ```