This is the parent template

> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.de/docs/llms.txt > Use this file to discover all available pages before exploring further. # HubL-Funktionen > Eine Referenzliste aller verfügbaren HubL-Funktionen. Funktionen in HubL ähneln Filtern insofern, als sie Parameter akzeptieren und einen Wert erzeugen. Allerdings müssen nicht alle Funktionen auf einen ursprünglichen Vorlagenwert angewendet werden, sondern sie interagieren mit anderen Bereichen Ihrer HubSpot-Umgebung. Wenn Sie eine ältere Website betreiben, sollten Sie sich auch die [Liste der veralteten HubL-Funktionen](/cms/versions-deprecations/deprecated/hubl/filters-functions) ansehen. Im Folgenden erfahren Sie mehr über die einzelnen HubL-Funktionen und ihre Syntax. ## append Fügt ein einzelnes Element an das Ende einer Liste hinzu. ```text hubl.txt theme={null} {% set numbers_under_5 = [1,2,3] %} {% do numbers_under_5.append(4) %} {{numbers_under_5}} ``` ```text gerenderte ausgabe.txt theme={null} [1, 2, 3, 4] ``` | Parameter | Typ | Beschreibung | | --------- | -------- | ----------------------------------------------- | | `item` | Beliebig | Element, das an die Liste angefügt werden soll. | ## blog\_all\_posts\_url Die `blog_all_posts_url`-Funktion gibt eine vollständige URL zur Listing-Seite für alle Blog-Beiträge für den angegebenen Blog zurück. Das folgende Beispiel zeigt, wie diese Funktion als `href` eines Anchors verwendet werden kann. ```html example.html theme={null} All Marketing blog posts ``` ```html example.html theme={null} All Marketing blog posts ``` | Parameter | Typ | Beschreibung | | --------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | ## blog\_author\_url Die `blog_author_url`-Funktion gibt eine vollständige URL zur Listing-Seite des angegebenen Blog-Autors zurück. Das folgende Beispiel zeigt, wie diese Funktion als `href` eines Anchors verwendet werden kann. Dies kann mit `blog_authors` kombiniert werden, wie in den Beispielen für diese Funktion gezeigt. ```html example.html theme={null} Brian Halligan ``` ```html example.html theme={null} Brian Halligan ``` | Parameter | Typ | Beschreibung | | --------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | Blog-ID oder "default" | Gibt an, in welchem Blog die Listing-Seite des Autors vorhanden ist. Sie können einen Blog per ID angeben oder `"default"` verwenden, um den Standardblog auszuwählen. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | | `author_slug` | Zeichenfolge oder HubL-Variable | Gibt an, zu welchem Autor verlinkt werden soll. Kann entweder `content.blog_post_author.slug` oder einen Namen mit Bindestrich in Kleinbuchstaben verwenden. Beispiel: `"jane-doe"`. | ## blog\_authors Die `blog_authors`-Funktion gibt eine Sequenz von Blog-Autorenobjekten für den angegebenen Blog zurück, aufsteigend sortiert nach Kürzel. Diese Sequenz kann in einer Variablen gespeichert und durchlaufen werden, um benutzerdefinierte Autorenbeitragsfilter zu erstellen. Die Anzahl der Live-Beiträge eines jeden Autors kann mithilfe von `author.live_posts` abgerufen werden. **Hinweis:** Diese Funktion verfügt über ein Limit von 250 Autoren. Für diese Funktion besteht außerdem ein Limit von 10 Aufrufen pro Seite. Die erste Zeile des folgenden Beispiels zeigt, wie die Funktion eine Sequenz von Autorenobjekten zurückgibt. Der Rest des Beispiels demonstriert einen Anwendungsfall, bei dem eine Sequenz in einer Variablen gespeichert und dann durch die Autorenobjekte iteriert wird, um eine Reihe von Autor-Listing-Links zu drucken. Das Beispiel geht davon aus, dass der Blog 4 Autoren hat. ```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

``` | Parameter | Typ | Beschreibung | | --------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog per ID oder der Standard-Blog mit `"default"`. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | ## blog\_page\_link Die `blog_page_link`-Funktion generiert die URL einer paginierten Ansicht Ihres Blog-Listings. Die Funktion nimmt einen numerischen Parameter an, mit dem Sie Links für die aktuelle, nächste, vorherige oder eine bestimmte Seite erzeugen können. Diese Funktion wird in der Regel im `href`-Attribut von Anchor-Tags für die Seitennummerierung verwendet und muss in Ihrer Blog-Listing-Vorlage verwendet werden. Die folgenden Beispiele zeigen diese Funktion in der Verwendung als Anchor-`href`. Das erste Beispiel gibt die aktuelle Seite aus. Das zweite Beispiel nimmt den Parameter 7 an, um die siebte Seite anzugeben. Das dritte Beispiel verwendet die `next_page_num`-Variable, um einen Link zu erzeugen, der sich auf die aktuelle Seitenzahl bezieht (Sie können auch die `last_page_num`-Variable für die vorherige Seite verwenden). Das letzte Beispiel verwendet die `current_page_num`-Variable und einen `+`-Operator, um einen Link zu erstellen, der um 4 größer ist als die aktuelle Seite. ```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 ``` | Parameter | Typ | Beschreibung | | --------- | ----------------------- | ----------------------------------------------------------------------------------------------------- | | `page` | Zahl oder HubL-Variable | Seitennummer, die zur Generierung der URL oder der HubL-Variable für die Seitennummer verwendet wird. | ## blog\_popular\_posts Diese Funktion stellt eine bestimmte Anzahl von beliebten Beiträgen in einer Sequenz dar. Die Sequenz kann dann in einer Variablen gespeichert und mit einer for-Schleife durchlaufen werden. Dabei wird eine benutzerdefinierte Beitragsauflistung mit Ihren beliebtesten Beiträgen erstellt. Die Ergebnisse dieser Funktion werden für sechs Stunden zwischengespeichert. Um Blog-Beiträge mithilfe von HubL auf eine Weise abzurufen, bei der Caching vermieden wird, sollten Sie stattdessen [blog\_recent\_tag\_posts](#blog-recent-tag-posts) verwenden. Im folgenden Beispielcode zeigt die erste Zeile, wie die Funktion eine Sequenz zurückgibt. Die Sequenz wird als Variable gespeichert, die dann in einer [for-Schleife](/cms/reference/hubl/loops) verwendet wird. [Alle Blog-Beitragsvariablen](/cms/reference/hubl/variables#blog-variables) sollten den Namen des einzelnen Schleifenelements und nicht `content.` verwenden. In diesem Beispiel wird `pop_post.name` verwendet. Dieses Verfahren kann für Blog-Vorlagen und Website-Seiten verwendet werden. **Hinweis:** Diese Funktion verfügt über ein Limit von 200 Beiträgen. Für diese Funktion besteht außerdem ein Limit von 10 Aufrufen pro Seite. ```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

``` | Parameter | Typ | Beschreibung | | ------------------ | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog per ID oder der Standard-Blog mit `"default"`. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | | `tag_slug` | Zeichenfolge | Gibt an, für welches Tag gefiltert werden soll. Sie können bis zu 10 Tags einbeziehen, durch Kommas getrennt. Tags mit mehreren Wörtern müssen in Kleinbuchstaben geschrieben werden, wobei Leerzeichen durch Bindestriche ersetzt werden müssen. | | `limit` | Ganzzahl | Gibt die Anzahl der Beiträge an, die der Sequenz hinzugefügt werden sollen. Dieser Parameter ist erforderlich, wenn ein `logical_operator`-Parameter einbezogen wird. | | `logical_operator` | Zeichenfolge | Wenn `tag_slug` mehrere Tags enthält, verwenden Sie diesen Operator, um Ergebnisse mit einer `AND`- oder `OR`-Logik zu filtern. Standardmäßig verwendet diese Funktion `OR`-Logik, um Beiträge zurückzugeben, die mit einem der angegebenen Tags markiert sind. Bei Einbeziehen dieses Parameters ist `limit` erforderlich. | ## blog\_tag\_url Die `blog_tag_url`-Funktion gibt eine vollständige URL zur Listing-Seite des angegebenen Blog-Tags zurück. Diese Funktion akzeptiert zwei Parameter. Der erste Parameter gibt an, in welchem Blog sich die Listing-Seite des Tags befindet. Der zweite Parameter gibt an, welches Tag verknüpft werden soll. Dieser Parameter kann das **`topic.slug`** für ein bestimmtes Tag von `content.topic_list` verwenden oder einen Namen mit Bindestrich in Kleinbuchstaben akzeptieren, z. B. `"marketing-tips"`. Das folgende Beispiel zeigt, wie diese Funktion als href eines Anchors verwendet werden kann. ```html example.html theme={null} Inbound Marketing ``` ```html example.html theme={null} Inbound Marketing ``` | Parameter | Typ | Beschreibung | | --------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------ | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog per ID oder der Standard-Blog mit `"default"`. | | `tag_slug` | Zeichenfolge | Gibt an, zu welchem Tag verlinkt werden soll. | ## blog\_tags Die `blog_tags`-gibt eine Sequenz der 250 meistgebloggten Tags (basierend auf der Anzahl der zugehörigen Blog-Beiträge) für den angegebenen Blog zurück, sortiert nach der Anzahl der Blog-Beiträge. Diese Sequenz kann in einer Variablen gespeichert und durchlaufen werden, um benutzerdefinierte Tag-Beitragsfilter zu erstellen. Die Anzahl der Beiträge für die einzelnen Tags kann mit `tag.live_posts` abgerufen werden. Diese Funktion akzeptiert zwei Parameter. Der erste Parameter gibt an, von welchem Blog die Tags abgerufen werden sollen. Der zweite Parameter legt eine Obergrenze für die Anzahl der abgerufenen Tags fest. Die erste Zeile des folgenden Beispiels zeigt, wie die Funktion eine Sequenz von Tag-Objekten zurückgibt. Der Rest des Beispiels demonstriert einen Anwendungsfall, bei dem eine Sequenz in einer Variablen gespeichert und dann durch die Tag-Objekte iteriert wird, um eine Reihe von Tag-Links zu drucken. Das Beispiel geht davon aus, dass der Blog über 4 Tags verfügt. **Hinweis:** Diese Funktion ist auf 250 Tags begrenzt. ```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]

``` | Parameter | Typ | Beschreibung | | --------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | | `limit` | Ganzzahl | Die maximale Anzahl der zurückzugebenden Tags. | ## blog\_total\_post\_count Diese Funktion gibt die Gesamtzahl der veröffentlichten Beiträge im angegebenen Blog zurück. Wird kein Parameter angegeben, werden Ihre Standard-Blog-Beiträge gezählt. Alternativ können Sie auch `"default"` oder die Blog-ID eines anderen Blogs angeben. Die Blog-ID ist in der URL Ihres Blog-Dashboards für einen bestimmten Blog verfügbar. **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. ```text hubl.txt theme={null} {{ blog_total_post_count }} {{ blog_total_post_count(359485112) }} ``` ```text gerenderte ausgabe.txt theme={null} 16 54 ``` | Parameter | Typ | Beschreibung | | --------------- | ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `selected_blog` | Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom [Modul-Blog-Feld](/cms/reference/fields/module-theme-fields#blog) zurückgegeben. | ## clear Entfernt alle Elemente aus einer Liste. Im Gegensatz zu `pop()` wird nichts zurückgegeben. ```text hubl.txt theme={null} {% set words = ["phone","home"] %} {% do words.clear() %} {{words}} ``` ```text gerenderte ausgabe.txt theme={null} [] ``` ## color\_contrast Diese Funktion validiert den Farbkontrast basierend auf [WCAG-Standards](https://www.w3.org/WAI/WCAG21/Understanding/contrast-minimum). Sie müssen zwei Farben als Argumente angeben, und Sie können ein optionales Argument angeben, um die Bewertung zu spezifizieren (`AA` oder `AAA`). Gibt `true` oder `false` zurück, je nachdem, ob die Farben den Standard erfüllen/übertreffen. ```text hubl.txt theme={null} {{color_contrast('#FFFFFF','#273749')}} {{color_contrast('rgb(255, 255, 255)','rgb(229, 237, 245)','AAA')}}

Hey there

``` ```text gerenderte ausgabe.txt theme={null} true false Hey there ``` | Parameter | Typ | Beschreibung | | --------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `color_1` | Farbe | Die erste Farbe zum Vergleichen. Akzeptiert:

6-stellige Hex-Codes (`#FFFFFF`)
3-stellige Hex-Codes (`#F0A`)
RGB-Farbcodes (`rgb(12,31,1)`)

Kann auch eine Variable verwenden, die einen Hex- oder RGB-Farbcode speichert. Beispiel:`theme.primary_color.color` | | `color_2` | Farbe | Die zweite Farbe, die mit der ersten verglichen werden soll. | | `rating` | Zeichenfolge | Der WCAG-Standard, der für die Bewertung verwendet werden soll. Kann entweder `AA` (Standard) oder `AAA` sein. | ## color\_variant Diese Funktion macht einen Hex-Wert oder eine Farbvariable um einen bestimmten Wert heller oder dunkler. Der erste Parameter ist die Hex-Farbe (zum Beispiel „#FFDDFF“) oder eine Variable, die einen Hex-Wert speichert. Der zweite Parameter ist der Wert, um den er angepasst werden soll, von 0 bis 255. Diese Funktion kann in CSS-Dateien verwendet werden, um eine Farbvariante zu erzeugen. Ein weiterer guter Anwendungsfall ist die Verwendung mit einem Farbparameter eines Farbmoduls, um dem Benutzer die Möglichkeit zu geben, eine Primärfarbe anzugeben, die automatisch eine Farbvariante erzeugt. Im folgenden Beispiel wird die Hex-Farbe #3A539B in einer Variablen namens `base_color` gespeichert. Die Farbe wird um -80 verändert, was ein dunkleres Blau ergibt (#00034B). ```text hubl.txt theme={null} {% set base_color ="#3A539B" %} {{ color_variant(base_color, -80) }} ``` ```text gerenderte ausgabe.txt theme={null} #00034b ``` | Parameter | Typ | Beschreibung | | ------------------- | -------------------- | -------------------------------------------------------------------------------------------------- | | `base_color` | HEX-Farbzeichenfolge | Die zu ändernde Ausgangsfarbe. Zum Beispiel: `#F7F7F7`. | | `brightness_offset` | Ganzzahl | Eine positive oder negative Zahl, die zum Aufhellen oder Verdunkeln der Grundfarbe verwendet wird. | ## content\_by\_id Die **`content_by_id`**-Funktion gibt eine Landingpage, eine Website-Seite oder einen Blog-Beitrag nach ID zurück. Der einzige von dieser Funktion akzeptierte Parameter ist eine numerische Inhalts-ID. Der folgende Beispielcode zeigt, wie diese Funktion verwendet wird, um ein mit einem Hyperlink versehenes Listenelement zu erzeugen. **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. ```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?

``` | Parameter | Typ | Beschreibung | | --------- | --- | -------------------------------- | | `id` | ID | Die ID des zu suchenden Inhalts. | ## content\_by\_ids Gibt bei einer Liste von Inhalts-IDs ein Dictionary von Landingpages, Website-Seites oder Blog-Beiträgen zurück, die diesen IDs entsprechen. Diese Funktion nimmt einen Parameter an, eine Liste von Seiten- oder Blog-Beitrags-IDs, die in einem Array platziert sind. Es können bis zu 100 Inhaltsobjekte übergeben werden. Der folgende Beispielcode zeigt, wie diese Funktion verwendet wird, um eine Liste von Listenelementen mit Hyperlinks zu erzeugen. **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. ```html example.html theme={null} {% set contents = content_by_ids([4715624297, 4712623297, 5215624284]) %}

{{content.title}}

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

``` | Parameter | Typ | Beschreibung | | --------- | ----- | ------------------------------------------------------------------------------------------------------------------------------- | | `ids` | Liste | Eine Liste von Seiten- oder Blog-Beitrags-IDs, die gesucht werden sollen. Es können bis zu 100 Inhaltsobjekte übergeben werden. | ## copy Gibt eine flache Kopie der Liste zurück. Äquivalent zu `a[:]`. Eine *flache Kopie* konstruiert ein neues zusammengesetztes Objekt und fügt dann (soweit möglich) *Verweise* auf die im Original gefundenen Objekte ein. ```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 gerenderte ausgabe.txt theme={null} a: [ham] b: [ham] After Append a: [ham, swiss] b: [ham] ``` ## count Gibt die Anzahl der Vorkommen einer Variablen in einer Liste zurück. ```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 Ruft eine Liste von CRM-Datensätzen ab, die mit einem anderen Datensatz anhand der Datensatz-ID, der Zuordnungskategorie und der Zuordnungsdefinitions-ID verknüpft sind. Diese Funktion gibt ein Objekt mit den folgenden Attributen zurück: `has_more`, `total`, `offset` und `results`. * `has_more` zeigt an, dass über diesen Stapel hinaus weitere Ergebnisse verfügbar sind (total > offset). * `total` ist die Gesamtzahl der verfügbaren Ergebnisse. * `offset` ist der Offset, der für den nächsten Stapel von Ergebnissen verwendet werden soll. * *`results`* gibt ein Array mit den angegebenen zugehörigen Objekten zurück, die den Parametern der Funktion entsprechen. **Hinweis:** Aus Sicherheitsgründen können von den [HubSpot-Standardobjekttypen](https://knowledge.hubspot.com/de/get-started/manage-your-crm-database#standard-objects) nur die Objekte `product` und `marketing_event` auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standardobjekttypen müssen auf einer Seite gehostet werden, die entweder [passwortgeschützt ist](https://knowledge.hubspot.com/de/website-pages/password-protect-a-page) oder eine [Anmeldung als registriertes CMS-Mitglied](https://knowledge.hubspot.com/de/website-pages/require-member-registration-to-access-private-content) erfordert. Für benutzerdefinierte Objekte gilt diese Einschränkung nicht. ```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 gerenderte ausgabe.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}]} ``` **Hinweis:** Diese Funktion kann maximal 10 Mal pro Seite aufgerufen werden. Jeder Aufruf von `crm_associations` kann höchstens 100 Objekte zurückgeben. Die Standardobergrenze liegt bei 10 Objekten. | Parameter | Typ | Beschreibung | | ---------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | ID | ID des Datensatzes, von dem Zuordnungen gesucht werden sollen. | | `association category` | Zeichenfolge | Die Kategorie der Zuordnungsdefinition. Mögliche Werte sind `HUBSPOT_DEFINED`, `USER_DEFINED` und `INTEGRATOR_DEFINED`. Dieser Parameter kann bei von HubSpot definierten integrierten Zuordnungstypen weggelassen werden. | | `association type id` | Ganzzahl | Die ID der zu verwendenden Zuordnungsdefinition. Für standardmäßig von HubSpot unterstützte Objekte siehe [ID des zu verwendenden Zuordnungstyps](https://developers.hubspot.de/docs/guides/api/crm/associations). Andernfalls kann diese Zuordnungs-ID in der [CRM-Objektschema-API](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) gefunden werden. | | `query` | Zeichenfolge | Die `id` des Datensatzes ODER eine Abfragezeichenfolge, getrennt durch `&`. Alle Ausdrücke werden mit UND verknüpft. Unterstützte Operatoren sind:

`eq` (Standard)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (gilt für Eigenschaften mit mehreren Werten oder Zeichenfolgeneigenschaften, z. B. *"firstname\_\_contains=Tim"*).

Abfragen können die folgenden Parameter enthalten:

`limit`: die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden. Zum Beispiel `limit=50`.
`offset`: zum Durchblättern von Ergebnissen, wenn die Anzahl der zurückgegebenen Ergebnisse den limit-Parameter übersteigt. Beispiel: `offset=51`.
`orderBy`: ordnet die Ergebnisse nach einer bestimmten Eigenschaft an. Zum Beispiel: `orderBy=email`.

| | `properties` | Zeichenfolge | Optional. Eine durch Kommata getrennte Liste von Eigenschaften, die zurückgegeben werden sollen. Standardmäßig wird ein kleiner Satz allgemeiner Eigenschaften zurückgegeben. Die ID-Eigenschaft wird immer zurückgegeben. Eine vollständige Liste der Eigenschaften kann über die Endpunkte [alle Kontakteigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) und [Alle Unternehmenseigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-companies#get-all-company-properties) abgerufen werden. | | `formatting` | Boolescher Wert | Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Übergeben Sie `false` für Rohzeichenfolgen. | ## crm\_object Ruft einen einzelnen CRM-Datensatz per Abfrage oder ID ab. Datensätze werden als ein Dictionary von Eigenschaften und Werten zurückgegeben. Diese Funktion kann auch [mit benutzerdefinierten und Integrator-Objekten verwendet](/cms/start-building/features/data-driven-content/crm-objects) werden. **Hinweis:** Aus Sicherheitsgründen können von den [HubSpot-Standardobjekttypen](https://knowledge.hubspot.com/de/get-started/manage-your-crm-database#standard-objects) nur die Objekte `product` und `marketing_event` auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standardobjekttypen müssen auf einer Seite gehostet werden, die entweder [passwortgeschützt ist](https://knowledge.hubspot.com/de/website-pages/password-protect-a-page) oder eine [Anmeldung als registriertes CMS-Mitglied](https://knowledge.hubspot.com/de/website-pages/require-member-registration-to-access-private-content) erfordert. Für benutzerdefinierte Objekte gilt diese Einschränkung nicht. Was ist der Unterschied zwischen `in` und `contains`? `in` gibt zurück, ob der Eigenschaftswert mit einem der angegebenen Werte übereinstimmt. `contains` Hingegen gibt zurück, ob die Eigenschaftswerte für die Mehrfachauswahl alle angegebenen Werte enthalten. ```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 gerenderte ausgabe.txt theme={null} Brian Halligan ``` **Hinweis:** Diese Funktion kann maximal 10 Mal auf einer Seite aufgerufen werden. | Parameter | Typ | Beschreibung | | ------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden.[Die unterstützten Objekttypen](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die [CRM-Objektschema-API](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details), um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Sie enthält den internen Objekttypnamen, der im functionFor-Integrator verwendet werden soll. Accountspezifische Objekttypen mit dem gleichen Namen wie die eingebauten Objekte verwenden den [vollständig qualifizierten Namen](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (Fully Qualified Name, FQN) des Objekts. | | `query` | Zeichenfolge | Optional. Die `id` des Datensatzes ODER eine Abfragezeichenfolge, getrennt durch `&`. Alle Ausdrücke werden mit UND verknüpft. Unterstützte Operatoren sind:

`eq` (Standard)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (gilt für Eigenschaften mit mehreren Werten oder Zeichenfolgeneigenschaften, z. B. *"firstname\_\_contains=Tim"*).

Abfragen können die folgenden Parameter enthalten:

`limit`: die maximale Anzahl von Ergebnissen, die in der Antwort zurückgegeben werden. Zum Beispiel `limit=50`.
`offset`: zum Durchblättern von Ergebnissen, wenn die Anzahl der zurückgegebenen Ergebnisse den limit-Parameter übersteigt. Beispiel: `offset=51`.
`orderBy`: ordnet die Ergebnisse nach einer bestimmten Eigenschaft an. Zum Beispiel: `orderBy=email`.

| | `properties` | Zeichenfolge | Optional. Eine durch Kommata getrennte Liste von Eigenschaften, die zurückgegeben werden sollen. Standardmäßig wird ein kleiner Satz allgemeiner Eigenschaften zurückgegeben. Die ID-Eigenschaft wird immer zurückgegeben. Eine vollständige Liste der Eigenschaften kann über die Endpunkte [alle Kontakteigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) und [Alle Unternehmenseigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-companies#get-all-company-properties) abgerufen werden. | | `formatting` | Boolescher Wert | Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Übergeben Sie `false` für Rohzeichenfolgen. | **Hinweis:** Wenn Sie eine Abfrage erstellen, sind die Werte von `range`, `distinct`, `ndistinct` und `startswith` reservierte Keywords. Um eine Eigenschaft abzufragen, die einen dieser Namen verwendet, müssen Sie das folgende Format verwenden: `range__eq=` (anstelle von `range=`). ## crm\_objects Ruft eine Liste von Datensätzen für einen bestimmten Objekttyp aus dem CRM von HubSpot ab. Diese Funktion gibt ein Objekt mit den folgenden Attributen zurück: `has_more`, `total`, `offset` und `results`. * `has_more` zeigt an, dass über diesen Stapel hinaus weitere Ergebnisse verfügbar sind (total > offset). * `total` ist die Gesamtzahl der verfügbaren Ergebnisse. * `offset` ist der Offset, der für den nächsten Stapel von Ergebnissen verwendet werden soll. * `results` gibt ein Array mit den angegebenen Objekten zurück, die den Parametern der Funktion entsprechen. Die Ergebnisse können mit mindestens einem Reihenfolgeparameter in der Abfrage sortiert werden. Zum Beispiel `crm_objects("contact", "firstname=Bob&order=lastname&order=createdate")` ordnet Kontakte mit dem Vornamen `"Bob"` nach dem Nachnamen und dann nach `createdate` an. Um eine Sortierung rückgängig zu machen, stellen Sie dem Eigenschaftsnamen `-` voran, z. B. `order=-createdate`. Die crm\_objects-Funktion kann auch [mit benutzerdefinierten und Integratorobjekten verwendet](/cms/start-building/features/data-driven-content/crm-objects) werden. **Hinweis:** Aus Sicherheitsgründen können von den [HubSpot-Standardobjekttypen](https://knowledge.hubspot.com/de/get-started/manage-your-crm-database#standard-objects) nur die Objekte `product` und `marketing_event` auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standardobjekttypen müssen auf einer Seite gehostet werden, die entweder [passwortgeschützt ist](https://knowledge.hubspot.com/de/website-pages/password-protect-a-page) oder eine [Anmeldung als registriertes CMS-Mitglied](https://knowledge.hubspot.com/de/website-pages/require-member-registration-to-access-private-content) erfordert. Für benutzerdefinierte Objekte gilt diese Einschränkung nicht. ```text hubl.txt theme={null} {% set objects = crm_objects("contact", "firstname__not_null=&limit=3", "firstname,lastname") %} {{ objects }} ``` ```text gerenderte ausgabe.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}]} ``` **Hinweis:** Diese Funktion kann maximal 10 Mal pro Seite aufgerufen werden. Jeder Aufruf von `crm_objects` kann höchstens 100 Objekte zurückgeben. Die Standardobergrenze liegt bei 10 Objekten. | Parameter | Typ | Beschreibung | | ------------- | --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Zeichenfolge | Der Typ des Objekts nach Name. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. Singular und Plural werden für Standardobjekttypen akzeptiert (z. B. `contact`, `contacts`). Erfahren Sie mehr über die [unterstützten Objekttypen](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die [CRM-Objektschema-API](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details), um die Typdefinitionen und die Namenseigenschaft abzurufen. Für integrator- und accountspezifische Objekttypen, die denselben Namen wie die eingebauten Objekte haben, verwenden Sie den [vollständig qualifizierten Namen](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (Fully Qualified Name, FQN) des Objekts. | | `query` | Zeichenfolge | Optional. Die ID des Datensatzes oder eine Abfragezeichenfolge, getrennt durch `&`. Alle Ausdrücke werden mit UND verknüpft. Unterstützte Operatoren sind:

`eq` (Standard)
`neq`
`lt`
`lte`
`gt`
`gte`
`is_null`
`not_null`
`in`
`nin`
`contains` (gilt für Eigenschaften mit mehreren Werten oder Zeichenfolgeneigenschaften, z. B. *"firstname\_\_contains=Tim"*).

Beispiel: `"email=contact@company.com"` | | `properties` | Zeichenfolge | Optional. Eine durch Kommata getrennte Liste von Eigenschaften, die zurückgegeben werden sollen. Standardmäßig wird ein kleiner Satz allgemeiner Eigenschaften zurückgegeben. Die ID-Eigenschaft wird immer zurückgegeben. Eine vollständige Liste der Eigenschaften kann über die Endpunkte [alle Kontakteigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-contacts#get-all-contact-properties) und [Alle Unternehmenseigenschaften abrufen](https://developers.hubspot.de/docs/reference/api/crm/properties/v1-companies#get-all-company-properties) abgerufen werden. Die Datensatz-ID ist immer in den zurückgegebenen Objekteigenschaften enthalten, auch wenn sie nicht ausdrücklich in der Eigenschaftsliste aufgeführt ist. | | `formatting` | Boolescher Wert | Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Übergeben Sie `false` für Rohzeichenfolgen. | **Hinweis:** Wenn Sie eine Abfrage erstellen, sind die Werte von `range`, `distinct`, `ndistinct` und `startswith` reservierte Keywords. Um eine Eigenschaft abzufragen, die einen dieser Namen verwendet, müssen Sie das folgende Format verwenden: `range__eq=` (anstelle von `range=`). ## crm\_property\_definition Rufen Sie damit die Eigenschaftsdefinition für einen bestimmten Objekttyp und Eigenschaftsnamen ab. Unterstützte Objekttypen sind HubSpot-Standardobjekte (z. B. Kontakte), portalspezifische Objekte und Integratorobjekte. ```hubl theme={null} {{ crm_property_definition("house_listing", "agent_name") }} ``` | Parameter | Typ | Beschreibung | | --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. [Die unterstützten Objekttypen](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die [CRM-Objektschema-API](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details), um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Sie enthält den internen Objekttypnamen, der im functionFor-Integrator verwendet werden soll. Accountspezifische Objekttypen mit dem gleichen Namen wie die eingebauten Objekte verwenden den [vollständig qualifizierten Namen](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (Fully Qualified Name, FQN) des Objekts. | | `property_name` | Zeichenfolge | Der Eigenschaftsname ohne Unterscheidung der Groß-/Kleinschreibung, für den die Definition abgerufen werden soll. | ## crm\_property\_definitions Rufen Sie damit die Eigenschaftsdefinitionen für einen bestimmten Objekttyp und eine Reihe von Eigenschaftsnamen ab. Unterstützte Objekttypen sind HubSpot-Standardobjekte (z. B. Kontakte), portalspezifische Objekte und Integratorobjekte. ```hubl theme={null} {{ crm_property_definitions("house_listing", "agent_name,address") }} ``` | Parameter | Typ | Beschreibung | | --------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `object_type` | Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. [Die unterstützten Objekttypen](/cms/start-building/features/data-driven-content/crm-objects#supported-crm-object-types). Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die [CRM-Objektschema-API](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details), um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Sie enthält den internen Objekttypnamen, der im functionFor-Integrator verwendet werden soll. Accountspezifische Objekttypen mit dem gleichen Namen wie die eingebauten Objekte verwenden den [vollständig qualifizierten Namen](/cms/start-building/features/data-driven-content/crm-objects#getting-a-custom-object-type-s-details) (Fully Qualified Name, FQN) des Objekts. | | `property_name` | Zeichenfolge | Optional. Die durch Kommata getrennten Eigenschaftsnamen ohne Unterscheidung der Groß-/Kleinschreibung, für die die Definition abgerufen werden soll. Wenn leer, werden die Definitionen für alle Eigenschaften abgerufen. | ## cta Da CTA-Module so viele Parameter haben, die Variationen ihres Codes enthalten, können Sie die CTA-Funktion verwenden, um ganz einfach einen bestimmten CTA in einer Vorlage, Seite oder E-Mail zu erzeugen. Diese Funktion wird vom Rich-Text-Editor verwendet, wenn Sie einen CTA über den Editor hinzufügen. **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. ```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 ``` | Parameter | Typ | Beschreibung | | ----------- | ------------ | -------------------------------------------------------------------------------------------------------------------- | | `guid` | Zeichenfolge | Die ID des zu rendernden CTA. Sie finden sie in der URL des Detailbildschirms des CTA. | | `align_opt` | Aufzählung | Passt die Ausrichtung des CTA an. Die Werte umfassen: `justifyleft`, `justifycenter`, `justifyright`, `justifyfull`. | ## extend Erweitert eine Liste durch Anhängen aller Elemente von einer Iterablen. Mit anderen Worten, es werden alle Listenelemente aus einer Liste in eine andere Liste eingefügt. ```text hubl.txt theme={null} {% set vehicles = ["boat","car","bicycle"] %} {% set more_vehicles = ["airplane","motorcycle"] %} {% do vehicles.extend(more_vehicles) %} {{vehicles}} ``` ```text gerenderte ausgabe.txt theme={null} [boat, car, bicycle, airplane, motorcycle] ``` ## file\_by\_id Diese Funktion gibt die Metadaten einer Datei nach ID zurück. Sie akzeptiert einen einzigen Parameter, die numerische ID der Datei, die gesucht werden soll. Um mehrere Dateien gleichzeitig abzurufen, verwenden Sie stattdessen die Funktion [files\_by\_ids](#files_by_ids). **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. ```text hubl.txt theme={null} {% set file = file_by_id(123) %} {{ file.friendlyUrl }} ``` ```text gerenderte ausgabe.txt theme={null} https://www.hubspot.com/hubfs/HubSpot_Logos/HSLogo_color.svg ``` | Parameter | Typ | Beschreibung | | --------- | ------ | --------------------------------------------- | | `file_id` | Nummer | Die ID der Datei, in der gesucht werden soll. | ## files\_by\_ids Gibt die Metadaten mehrerer Dateien nach ID zurück. Sie akzeptiert ein Array von Datei-IDs. **Hinweis:** Diese Funktion ist auf 10 Aufrufe pro Seite beschränkt und kann bis zu 100 Datei-IDs akzeptieren. ```text hubl.txt theme={null} {% set files = files_by_ids([123,456])%} {% for file in files %} URL:{{file.friendlyUrl}}
{% endfor %} ``` ```text gerenderte ausgabe.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 ``` | Parameter | Typ | Beschreibung | | --------- | ------ | --------------------------------------------------------------------- | | `file_id` | Nummer | Die IDs der zu suchenden Dateien, durch Kommas getrennt (bis zu 100). | Sie können diese Funktion beispielsweise verwenden, um die hochgeladenen Dateien eines Kontakts zu durchlaufen. Um die Ergebnisse zu durchlaufen, müssen Sie den [Split HubL-Filter](/cms/reference/hubl/filters#split) verwenden, da die CRM-Eigenschaft als durch Semikolon getrennte Zeichenfolge zurückgegeben wird. ```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 Wenn ein Blog-Beitrag [für den Zugriff über Selbstregistrierung konfiguriert](https://knowledge.hubspot.com/de/blog/use-self-registration-for-private-blog-content) ist, müssen sich Besucher registrieren oder anmelden, um den gesamten Beitragsinhalt anzuzeigen. Die standardmäßigen Blog-Listing-Elemente von HubSpot enthalten diese Funktion automatisch und auch eine Sperr-Symbol-Anzeige für Beiträge, für die eine Selbstregistrierung erforderlich ist. Erfahren Sie mehr über das [Erstellen von benutzerdefinierten Lösungen mit dieser Funktion und der entsprechenden API](/cms/start-building/features/memberships/overview#private-blog-posts-with-self-registration). Diese Funktion prüft, ob ein Blog-Beitrag vom aktuellen Besucher aufgerufen werden kann. Beim Aufruf wird die Funktion durch das folgende Attribut ersetzt: `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 gerenderte ausgabe.txt theme={null}

...

``` | Parameter | Typ | Beschreibung | | --------- | --- | ---------------------------------------------------------------------------------------- | | `ID` | ID | Die ID des Inhalts, der mit dem aktuell angemeldeten Betrachter abgeglichen werden soll. | ## follow\_me\_links Gibt die in den [Account-Einstellungen festgelegten Social-Media-Konto-Links](https://knowledge.hubspot.com/de/design-manager/use-default-modules-in-your-template#add-social-accounts-to-the-follow-me-module) zurück. Wird im [follow\_me-Standardmodul](/cms/reference/modules/default-modules#follow-me) verwendet. ```text hubl.txt theme={null} {% set fm = follow_me_links() %} {{ fm }} ``` ```text gerenderte ausgabe.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 Formatiert eine Adresse basierend auf dem Gebietsschema des Kontexts. ```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 gerenderte ausgabe.txt theme={null} [25 First Street, 2nd Floor, Cambridge, MA 02141, United States] ``` | Parameter | Typ | Beschreibung | | ---------- | ------------ | -------------------------------------------------------------- | | `locale` | Zeichenfolge | Das Gebietsschema, in dem die Adresse formatiert werden soll. | | `address` | Zeichenfolge | Die Straße. | | `address2` | Zeichenfolge | Die zweite Zeile der Adresse, z. B. Stockwerk oder Hausnummer. | | `city` | Zeichenfolge | Die Stadt der Adresse. | | `state` | Zeichenfolge | Das Bundesland der Adresse. | | `country` | Zeichenfolge | Das Land der Adresse. | | `zip` | Zeichenfolge | Die Postleitzahl der Adresse. | ## format\_company\_name Formatiert den Namen eines Unternehmens, indem gegebenenfalls eine japanische Anrede hinzugefügt wird. ```text hubl.txt theme={null} {{ format_company_name("companyName", addJapaneseHonorifics) }} ``` ```text gerenderte ausgabe.txt theme={null} HubSpot ``` | Parameter | Typ | Beschreibung | | -------------------------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | | `companyName` | Zeichenfolge | Der Name des Unternehmens. | | `useHonorificIfApplicable` | Boolescher Wert | Wenn dies auf `true` festgelegt und die Sprache des Kontexts Japanisch ist, wird gegebenenfalls eine japanische Geschäftsanrede hinzugefügt. | ## format\_name Formatiert den Namen einer Person, indem der Nachname vor den Vornamen gestellt wird, und fügt gegebenenfalls eine japanische Anrede hinzu ```text hubl.txt theme={null} {{ format_name("firstName", "surname", addJapaneseHonorifics) }} ``` ```text gerenderte ausgabe.txt theme={null} Hobbes Baron ``` | Parameter | Typ | Beschreibung | Standard | | -------------------------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------- | | `firstName` | Zeichenfolge | Der Vorname der Person. | | | `surname` | Zeichenfolge | Der Nachname der Person. | `False` | | `useHonorificIfApplicable` | Boolescher Wert | Wenn dies auf `true` festgelegt und die Sprache des Kontexts Japanisch ist, wird gegebenenfalls eine japanische Anrede hinzugefügt. | | ## format\_datetime Formatiert sowohl die Datums- als auch die Uhrzeitkomponente eines Datumsobjekts, ähnlich dem [format\_datetime](/cms/reference/hubl/filters#format_datetime)-HubL-Filter. Diese Funktion ersetzt die veraltete `datetimeformat`-Funktion. ```text hubl.txt theme={null} {{ format_datetime(content.publish_date, "short", "America/New_York", "en") }} ``` ```text gerenderte ausgabe.txt theme={null} 12/31/69 7:00 PM ``` | Parameter | Typ | Beschreibung | | ---------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `format` | Zeichenfolge | Das zu verwendende Format. Kann eines der folgenden sein:

`short`
`medium`
`long`
`full`
Ein benutzerdefiniertes Muster gemäß [Unicode LDML](https://unicode.org/reports/tr35/tr35-dates.html#Date_Format_Patterns)

| | `timeZone` | Zeichenfolge | Die Zeitzone des Ausgabedatums im [IANA-TZDB-Format](https://data.iana.org/time-zones/tzdb/). | | `locale` | Zeichenfolge | Das Gebietsschema, das für Formate verwendet werden soll, die das Gebietsschema berücksichtigen. | ## geo\_distance Diese Funktion enthält 4 Parameter und berechnet den ellipsoidischen 2D-Abstand zwischen zwei Punkten auf der Erde. Verwenden Sie diese Funktion als Filterabfrage zum Abrufen von HubDB-Daten. ```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
``` | Parameter | Typ | Beschreibung | | ------------- | ------------ | ----------------------------------------------------------------------------------------------------------------------- | | `point1` | Standort | Standort von einer HubDB-Spalte. | | `point2_lat` | Breitengrad | Breitengrad von Punkt2. | | `point2_long` | Längengrad | Längengrad von Punkt2. | | `units` | Zeichenfolge | Einheiten für den Rückgabewert. Die Optionen sind `FT` für Fuß, `MI` für Meilen, `M` für Meter oder `KM` für Kilometer. | ## get\_asset\_url Diese Funktion gibt die öffentliche URL einer bestimmten Vorlage oder Code-Datei zurück. Der Parameter dieser Funktion ist der Pfad des Elements im Design-Manager. Die Code-Datei-URLs werden bei jeder Veröffentlichung aktualisiert; mit dieser Funktion stellen Sie also sicher, dass Sie immer die neueste Version der Datei verwenden. Sie können diese Funktion in der Anwendung automatisch generieren, indem Sie entweder mit der rechten Maustaste auf eine **Datei** klicken und **Öffentliche URL kopieren** auswählen oder indem Sie auf **Aktionen** klicken und dann **Öffentliche URL kopieren** auswählen. Das folgende Beispiel ruft die URL einer im Design-Manager erstellten JavaScript-Datei ab, die als `src` in ein ` ``` ## resize\_image\_url Schreibt die URL eines im Datei-Manager gespeicherten Bildes in eine URL um, die die Größe des Bildes auf Anfrage ändert. Die Funktion akzeptiert einen erforderlichen Parameter und fünf optionale Parameter. Es muss mindestens ein optionaler Parameter übergeben werden. Erforderlich * **URL:** Zeichenfolge, URL eines von HubSpot gehosteten Bildes. Optional * **Breite:** Zahl, die die neue Bildbreite in Pixeln angibt. * **Höhe:** Zahl, die die neue Bildhöhe in Pixeln angibt. * **Länge:** Zahl, die die neue Länge der größten Seite in Pixeln angibt. * **Skalieren:** Boolescher Wert; die geänderten Bildmaße werden auch dann verwendet, wenn das Originalbild dadurch vergrößert wird (Bilder können unscharf erscheinen). * **Vergrößern:** Boolescher Wert; gibt das verkleinerte Bild zurück, auch wenn es in Bytes größer als das Original ist. **Hinweis:** Bei Bildern mit einer Höhe oder Breite mit mehr als 4096 Pixel wird nicht automatisch die Größe geändert. Stattdessen müssen Sie [die Größe des Bildes manuell ändern](https://knowledge.hubspot.com/de/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 gerenderte ausgabe.txt theme={null} http://your.hubspot.site/hubfs/img.jpg?length=300&name=img.jpg ``` | Parameter | Typ | Beschreibung | | --------- | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `url` | Zeichenfolge | URL eines von HubSpot gehosteten Bildes. | | `width` | Ganzzahl (px) | Die neue Bildbreite in Pixeln. | | `height` | Ganzzahl (px) | Die neue Bildhöhe in Pixeln. | | `length` | Ganzzahl (px) | Die neue Länge der größten Seite, in Pixeln. | | `upscale` | Boolescher Wert | Die geänderten Bildmaße werden auch dann verwendet, wenn das Originalbild dadurch vergrößert wird (Bilder können unscharf erscheinen). Der Standardwert ist `false`. | | `upsize` | Boolescher Wert | Gibt das verkleinerte Bild zurück, auch wenn es in Bytes größer als das Original ist. Der Standardwert ist `false`. | ## reverse Kehrt die Reihenfolge der Elemente in einer Liste um. Nimmt keine Parameter an. Um die Reihenfolge eines Objekt umzukehren oder einen Iterator zurückzugeben, der die Liste in umgekehrter Reihenfolge durchläuft, verwenden Sie [`|reverse`](/cms/reference/hubl/filters#reverse). ```text hubl.txt theme={null} {% set numbers = [1,2,3,4] %} {% do numbers.reverse() %} {{numbers}} ``` ```text gerenderte ausgabe.txt theme={null} [4, 3, 2, 1] ``` ## set\_response\_code Legen Sie den Antwortcode als den angegebenen Code fest. [404](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/404) ist im Moment der einzige unterstützte Code. Wenn Sie dies verwenden, gibt Ihre Seite einen `404`-Fehler zurück. ```text hubl.txt theme={null} {{ set_response_code(404) }} ``` ```text gerenderte ausgabe.txt theme={null} ``` | Parameter | Typ | Beschreibung | | --------- | -------- | ---------------------------------------------------------------------- | | `code` | Ganzzahl | Der HTTP-Antwortcode. Derzeit ist `404` der einzige unterstützte Code. | ## super Diese Funktion druckt den Inhalt der übergeordneten Vorlage in eine untergeordnete Vorlage unter Verwendung des [extends](/cms/reference/hubl/overview#blocks-and-extends)-Tags. Im unten stehenden Code wurde beispielsweise eine einfache HTML-Vorlage mit einem HubL-Block namens `sidebar` erstellt und als `parent.html` gespeichert. Es wird eine zweite Vorlagendatei erstellt, die diese übergeordnete Datei erweitert. Normalerweise würde die `

` im Seitenleistenblock des übergeordneten HTML-Formats gedruckt werden. Durch die Verwendung von `super` wird jedoch der Inhalt des Seitenleistenblocks der übergeordneten Vorlage mit dem Inhalt der untergeordneten Vorlage kombiniert. ```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 Gibt den Beginn des heutigen Tages (12:00 Uhr) zurück. Optional können Sie einen Parameter hinzufügen, um die Zeitzone von der Standard-UTC zu ändern. ```text hubl.txt theme={null} {{ today() }} {{ today("America/New_York") }} {{ unixtimestamp(today("America/New_York").plusDays(1)) }} ``` ```text gerenderte ausgabe.txt theme={null} 2018-10-23T00:00Z 2018-10-23T00:00-04:00[America/New_York] 1540353600000 ``` ## to\_local\_time Konvertiert einen UNIX-Zeitstempel in die lokale Zeit, basierend auf Ihren HubSpot-Berichtseinstellungen. Sie können dann einen datetimeformat-Filter anwenden, um das Datum zu formatieren. ```text hubl.txt theme={null} {{ to_local_time(eastern_dt) }} ``` ```text gerenderte ausgabe.txt theme={null} 2015-05-13 10:37:31 ``` | Parameter | Typ | Beschreibung | | --------- | -------- | ------------------------------------------------------ | | `date` | Datetime | UNIX-Zeitstempel zur Konvertierung in die lokale Zeit. | ## topic\_cluster\_by\_content\_id Gibt ein HubL-Dictionary zurück, das den Themencluster repräsentiert, der mit einem einzelnen Inhalt verbunden ist (bestimmt durch die übergebene Inhalts-ID), einschließlich Metadaten zur zugehörigen Pillar-Seite, das Hauptthema und die Unterthemen. Kann verwendet werden, um einen Inhalt automatisch mit der zugehörigen Pillar-Seite zu verlinken \[falls vorhanden]. Verfügbare Metadaten befinden sich in: attachableContent (Metadaten des aktuellen Inhalts), topic (Metadaten des zugehörigen Themas des aktuellen Inhalts), coreTopic (Metadaten des zugehörigen Kernthemas des Clusters) und pillarPage (Metadaten der zugehörigen Pillar-Seite). Verwenden Sie `{{ topicCluster|pprint }}`, um eine vollständige Anzeige der verfügbaren Eigenschaften/Attribute zu erhalten. ```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
``` Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. | Parameter | Typ | Beschreibung | | ------------ | --- | ------------------------------ | | `content_id` | Id | Die ID der zu suchenden Seite. | ## truncate Die truncate-Funktion funktioniert genau wie die [trunkieren-Filter](/cms/reference/hubl/filters#truncate)-Funktion, verwendet aber Funktionssyntax anstelle von Filtersyntax. Der erste Parameter gibt die Zeichenfolge an. Der zweite Parameter gibt die Länge an, bei der abgeschnitten werden soll. Der letzte Parameter gibt die Zeichen an, die beim Abschneiden hinzugefügt werden sollen. Hinweis: Da diese Funktion auf die Leerzeichen zwischen den Wörtern angewiesen ist, um Zeichenfolgen zu kürzen, funktioniert sie für Sprachen ohne Leerzeichen zwischen Zeichen, wie z. B. Japanisch, möglicherweise nicht wie erwartet. ```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 gerenderte ausgabe.txt theme={null} string to truncate ... Lorem ipsum dolor sit amet, consectetur ... ``` | Parameter | Typ | Beschreibung | | -------------------- | --------------- | ------------------------------------------------------------------------------------------------------------- | | `string_to_truncate` | Zeichenfolge | Zeichenfolge, die abgeschnitten werden soll. | | `length` | Ganzzahl | Gibt die Länge an, bei der der Text abgeschnitten werden soll (einschließlich HTML-Zeichen). | | `killwords` | Boolescher Wert | Bei „true“ wird der Text in der Länge abgeschnitten, unabhängig davon, ob er in der Mitte eines Wortes steht. | | `end` | Zeichenfolge | Die Zeichen, die hinzugefügt werden, um anzuzeigen, wo der Text abgeschnitten wurde. | ## type Diese Funktion akzeptiert ein Argument und gibt den Typ eines Objekts zurück. Der Rückgabewert ist einer der folgenden: `"bool"`, `"datetime"`, `"dict"`, `"float"`, `"int"`, `"list"`, `"long"`, `"null"`, `"str"` oder `"tuple"`. ```text hubl.txt theme={null} {{ type("Blog") }} {% set my_type = type("Blog") %}
{{my_type}}
``` ```text gerenderte ausgabe.txt theme={null}
str
``` ## unixtimestamp Diese Funktion gibt einen Unix-Zeitstempel zurück, wenn Sie ein datetime-Objekt angeben. ```text hubl.txt theme={null} {{ unixtimestamp(d) }} ``` ```text gerenderte ausgabe.txt theme={null} 1565983117868 ``` ## update Aktualisiert das Dictionary mit den Elementen aus einem anderen dict-Objekt oder aus einer Iterable von Schlüssel-Wert-Paaren. Verwenden Sie diese Funktion, um Objekte zu kombinieren oder zusammenzuführen. ```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 gerenderte ausgabe.txt theme={null} {authorName=Douglas Judy, authorTitle=Mastermind, authorFriend=Jake, authorLocation=unknown} ```