HubL-Funktionen

Last updated:

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 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.

{% set numbers_under_5 = [1,2,3] %} {% do numbers_under_5.append(4) %} {{numbers_under_5}}[1, 2, 3, 4]
ParameterTypeDescription
item
Beliebig

An die Liste anzufügendes Element.

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.

<a href="{{ blog_all_posts_url("default") }}">All Marketing blog posts</a><a href="http://www.hubspot.com/marketing/all">All Marketing blog posts</a>
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

blog_author_url

Die blog_autor_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.

<a href="{{ blog_author_url("default", "brian-halligan") }}">Brian Halligan</a><a href="http://blog.hubspot.com/marketing/author/brian-halligan">Brian Halligan</a>
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, in welchem Blog die Listing-Seite des Autors vorhanden ist. Sie können einen Blog nach ID angeben oder "default" verwenden, um den Standard-blog auszuwählen. Die Blog-ID wird vom Modul-Blog-Feld 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.

Bitte beachten: 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.

{{ blog_authors("default", 250) }} {% set my_authors = blog_authors("default", 250) %} <ul> {% for author in my_authors %} <li><a href="{{ blog_author_url(group.id, author.slug) }}">{{ author }}</a></li> {% endfor %} </ul>[ Brian Halligan, Dharmesh Shah, Katie Burke, Kipp Bodnar] <ul> <li><a href="http://blog.hubspot.com/marketing/author/brian-halligan">Brian Halligan</a></li></li> <li><a href="http://blog.hubspot.com/marketing/author/dharmesh-shah">Dharmesh Shah</a></li></li> <li><a href="http://blog.hubspot.com/marketing/author/katie-burke">Katie Burke</a></li></li> <li><a href="http://blog.hubspot.com/marketing/author/kipp-bodnar">Kipp Bodnar</a></li></li> </ul>
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default". Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

limit
Ganzzahl

Legt das Limit für die Anzahl der abgerufenen Autoren fest.

blog_by_id

Die blog_by_id-Funktion gibt ein Blog nach ID zurück. Der folgende Beispielcode zeigt, wie diese Funktion verwendet wird, um ein mit einem Hyperlink versehenes Listenelement zu erzeugen.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

{% set my_blog = blog_by_id(47104297) %} <ul> <li> <a href="{{ my_blog.absolute_url }}">{{my_blog.html_title}}</a> </li> </ul><ul> <li> <a href="http://blog.bikinginearnest.com/outdoors">Outdoor biking for the earnest</a> </li> </ul>
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default". Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

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.

<a href="{{ blog_page_link(current_page_num) }}">Current page</a> <a href="{{ blog_page_link(7) }}">Page 7</a> <a href="{{ blog_page_link(next_page_num) }}">Next</a> <a href="{{ blog_page_link(current_page_num + 4) }}">Page Plus 4</a><a href="http://designers.hubspot.com/blog/page/1">Page 1</a> <a href="http://designers.hubspot.com/blog/page/7">Page 7</a> <a href="http://designers.hubspot.com/blog/page/2">Next</a> <a href="http://designers.hubspot.com/blog/page/5">Page Plus 4</a>
Use this table to describe parameters / fields
ParameterTypeDescription
page
Zahl oder HubL-Variable

Seitennummer, die zur Generierung der URL oder der HubL-Variable für die Seitennummer verwendet wird.

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 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 verwendet wird. Alle Blog-Beitragsvariablen 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.

Bitte beachten: 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.

{% set pop_posts = blog_popular_posts("default", 5, ["marketing-tips", "sales-tips"], "popular_past_month", "AND") %} {% for pop_post in pop_posts %} <div class="post-title">{{ pop_post.name }}</div> {% endfor %}[Popular post title 1, Popular post title 2, Popular post title 3, Popular post title 4, Popular post title 5] <div class="post-title">Popular post title 1</div> <div class="post-title">Popular post title 2</div> <div class="post-title">Popular post title 3</div> <div class="post-title">Popular post title 4</div> <div class="post-title">Popular post title 5</div>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default".

limit
Ganzzahl

Gibt die Anzahl der Beiträge an, die der Sequenz hinzugefügt werden sollen (Limit von 200). Wenn nicht angegeben, wird standardmäßig 10 verwendet.

tag_slug
Array

Optionale Liste von Tags, nach denen Beiträge gefiltert werden können.

time_frame
Zeichenfolge

Optionaler Analytics-Zeitraum, nach dem Beiträge gefiltert werden sollen. Standardwert ist "popular_past_year". Muss einer der folgenden sein:

  • "popular_all_time" 
  • "popular_past_year"
  • "popular_past_six_months" 
  • "popular_past_month"

Dieser Parameter ist erforderlich, wenn der 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 time_frame erforderlich.

blog_post_archive_url

Die blog_post_archive_url-Funktion gibt eine vollständige URL zur Archiv-Listing-Seite für die angegebenen Datumswerte im angegebenen Blog zurück. Diese Funktion hat zwei erforderliche Parameter und zwei optionale Parameter. Der erste Parameter ist eine Blog-ID oder einfach das Keyword "default". Das zweite ist das Jahr der archivierten Beiträge, die Sie anzeigen möchten.

Die optionalen Parameter umfassen den Monat und den Tag der archivierten Beiträge, die Sie anzeigen möchten.

Das folgende Beispiel zeigt, wie diese Funktion als href eines Anchors verwendet werden kann.

<a href="{{ blog_post_archive_url("default", 2017, 7, 5) }}">Posts from July 5th, 2017</a><a href="http://blog.hubspot.com/marketing/archive/2017/07/05">Posts from July 5th, 2017</a>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default".

year
Ganzzahl

Das Jahr.

month
Ganzzahl

Der optionale Monat.

day
Ganzzahl

Der optionale Tag.

blog_recent_author_posts

Die blog_recent_author_posts-Funktion gibt eine Sequenz von Blog-Beitragsobjekten für den angegebenen Autor zurück, sortiert nach den neuesten. Diese Sequenz von Beiträgen kann in einer Variablen gespeichert und mit einer for-Schleife durchlaufen werden, um eine benutzerdefiniertes Beitragsauflistung mit Beiträgen eines bestimmten Autors zu erstellen. 

Die Funktion akzeptiert drei Parameter. Der erste Parameter gibt an, von welchem Blog die Beiträge eines Autors gesammelt werden sollen. Der Wert sollte "default" oder die Blog-ID eines bestimmten Blogs sein (verfügbar in der URL des Blog-Dashboards). Der zweite Parameter gibt an, welcher Autor verwendet werden soll. Dieser Parameter kann das content.blog_post_author.slug verwenden, um den Autor des aktuellen Beitrags zu verwenden, oder einen Namen mit Bindestrich in Kleinbuchstaben wie „bernd-wagner"akzeptieren. Der dritte Parameter gibt an, wie viele Beiträge abgerufen werden. 

Die erste Zeile des folgenden Beispiels zeigt, wie die Funktion eine Sequenz von Beiträgen eines Autors zurückgibt. In diesem Beispiel wird nicht der genaue Autorenname angegeben, sondern der aktuelle Autor des Beitrags. Die Sequenz wird in einer Variablen gespeichert und in einer Schleife durchlaufen.Alle Blog-Beitragsvariablen sollten den Namen des einzelnen Schleifenelements und nicht content. verwenden. In diesem Beispiel wird author_post.name verwendet. Dieses Verfahren kann für Blog- und Seitenvorlagen verwendet werden.

Bitte beachten: Diese Funktion ist auf 200 Beiträge und 10 Aufrufe pro Seite begrenzt.

{{ blog_recent_author_posts("default", content.blog_post_author.slug, 5 ) }} {% set author_posts = blog_recent_author_posts("default", content.blog_post_author.slug, 5) %} {% for author_post in author_posts %} <div class="post-title">{{ author_post.name }}</div> {% endfor %}[Post by author title 1, Post by author title 2, Post by author title 3, Post by author title 4, Post by author title 5] <div class="post-title">Post by author title 1</div> <div class="post-title">Post by author title 2</div> <div class="post-title">Post by author title 3</div> <div class="post-title">Post by author title 4</div> <div class="post-title">Post by author title 5</div>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

author_slug
Zeichenfolge

Gibt an, nach welchem Autor gefiltert werden soll.

limit
Ganzzahl

Gibt die Anzahl der Beiträge an, die der Sequenz hinzugefügt werden sollen (Limit von 200).

blog_recent_posts

Die blog_recent_posts-Funktion gibt eine Sequenz von Blog-Beitragsobjekten für den angegebenen Blog zurück, sortiert nach dem neuesten. Diese Sequenz von Beiträgen kann in einer Variablen gespeichert und mit einer for-Schleife durchlaufen werden, um eine benutzerdefinierte Beitragsauflistung mit Ihren beliebtesten Beiträgen zu erstellen. 

Die Funktion nimmt zwei Parameter an. Der erste Parameter gibt an, von welchem Blog beliebte Beiträge gesammelt werden sollen. Der Wert sollte "default" oder die Blog-ID eines bestimmten Blogs sein (verfügbar in der URL des Blog-Dashboards). Der zweite Parameter gibt an, wie viele Beiträge abgerufen werden. 

Die erste Zeile des folgenden Beispiels zeigt, wie die Funktion eine Sequenz zurückgibt. Die Sequenz wird in einer Variablen gespeichert und in einer Schleife durchlaufen. Alle Blog-Beitragsvariablen sollten den Namen des einzelnen Schleifenelements und nicht content. verwenden. In diesem Beispiel wird rec_post.name verwendet. Dieses Verfahren kann nicht nur für Blog-Vorlagen verwendet werden, sondern auch für normale Seiten.

Bitte beachten: Diese Funktion ist auf 200 Beiträge und 10 Aufrufe pro Seite begrenzt.

{{ blog_recent_posts("default", 5) }} {% set rec_posts = blog_recent_posts("default", 5) %} {% for rec_post in rec_posts %} <div class="post-title">{{ rec_post.name }}</div> {% endfor %}[Recent post title 1, Recent post title 2, Recent post title 3, Recent post title 4, Recent post title 5] <div class="post-title">Recent post title 1</div> <div class="post-title">Recent post title 2</div> <div class="post-title">Recent post title 3</div> <div class="post-title">Recent post title 4</div> <div class="post-title">Recent post title 5</div>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default". Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

limit
Ganzzahl

Gibt die Anzahl der Beiträge an, die der Sequenz hinzugefügt werden sollen, maximal 200.

blog_recent_tag_posts

Die blog_recent_tag_posts-Funktion gibt eine Sequenz von Blog-Beitragsobjekten für ein bestimmtes Tag oder mehrere Tags zurück, sortiert nach dem neuesten. Diese Sequenz von Beiträgen kann in einer Variablen gespeichert und mit einer for-Schleife durchlaufen werden, um eine benutzerdefiniertes Beitragsauflistung mit Beiträgen eines bestimmten Tags oder mehrerer Tags zu erstellen.

Im folgenden Beispielcode:

  • Die erste Zeile zeigt, wie die Funktion eine Sequenz von Beiträgen nach Tag zurückgibt. 
  • Die zweite Zeile zeigt, wie die Funktion in einer Sequenzvariablen gespeichert wird. Der Rest des Codes verwendet dann eine for-Schleife, um die Variablenwerte zu durchlaufen. Alle Blog-Beitragsvariablen sollten den Namen des einzelnen Schleifenelements und nicht content. verwenden. In diesem Beispiel wird tag_post.name verwendet. Sie können dieses Verfahren sowohl auf Blog- als auch auf Website-Seiten verwenden. 

Erfahren Sie mehr über das Erstellen eines zugehörigen Blog-Beitrags-Listings.

Bitte beachten: Diese Funktion ist auf 100 Beiträge und 10 Aufrufe pro Seite begrenzt.

{{ blog_recent_tag_posts("default", "marketing-tips", 5) }} {% set tag_posts = blog_recent_tag_posts("default", ["marketing", "fun", "inbound"], 3, "AND") %} {% for tag_post in tag_posts %} <div class="post-title">{{ tag_post.name }}</div> {% endfor %}[Post about Marketing 1, Post about Marketing 2, Post about Marketing 3, Post about Marketing 4, Post about Marketing 5] <div class="post-title">Post about Marketing</div> <div class="post-title">Post about Fun</div> <div class="post-title">Post about Inbound</div>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default". Die Blog-ID wird vom Modul-Blog-Feld 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 Kleinbuchstaben sein, 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 hrefeines Anchors verwendet werden kann.

<a href="{{ blog_tag_url("default", "inbound-marketing") }}">Inbound Marketing</a><a href="http://blog.hubspot.com/marketing/tag/inbound-marketing">Inbound Marketing</a>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll, entweder ein bestimmter Blog durch seine ID oder der Standard-Blog durch "default".

tag_slug
Zeichenfolge

Gibt an, zu welchem Tag verlinkt werden soll.

blog_tags

Die blog_tags-Funktion 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. 

Bitte beachten: Diese Funktion ist auf 250 Tags begrenzt.

{{ blog_tags("default", 250) }} {% set my_tags = blog_tags("default", 250) %} <ul> {% for item in my_tags %} <li><a href="{{ blog_tag_url(group.id, item.slug) }}">{{ item }}</a></li> {% endfor %} </ul>[ Blogging, Inbound Marketing, SEO, Social Media] <ul> <li><a href="http://blog.hubspot.com/marketing/tag/blogging"></a></li></li> <li><a href="http://blog.hubspot.com/marketing/tag/inbound-marketing">Inbound Marketing</a></li></li> <li><a href="http://blog.hubspot.com/marketing/tag/seo">SEO</a></li> <li><a href="http://blog.hubspot.com/marketing/tag/social-media">Social Media</a></li></li> </ul>
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom Modul-Blog-Feld 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 "Standard" 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.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

{{ blog_total_post_count }} {{ blog_total_post_count(359485112) }}16 54
Use this table to describe parameters / fields
ParameterTypeDescription
selected_blog
Blog-ID oder "default"

Gibt an, welcher Blog gezählt werden soll. Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben.

clear

Entfernt alle Elemente aus einer Liste. Im Gegensatz zu pop() wird nichts zurückgegeben.

{% set words = ["phone","home"] %} {% do words.clear() %} {{words}}[]

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).

{% set base_color ="#3A539B" %} {{ color_variant(base_color, -80) }}#00034b
Use this table to describe parameters / fields
ParameterTypeDescription
base_color
HEX-Farbzeichenfolge

Die zu ändernde Ausgangsfarbe (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.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
{% set my_content = content_by_id(4715624297) %} <ul> <li> <a href="{{ my_content.absolute_url }}">{{my_content.title}}</a> </li> </ul><ul> <li> <a href="http://www.hubspot.com/blog/articles/kcs_article/email/how-do-i-create-default-values-for-my-email-personalization-tokens">How do I create default values for my email or smart content personalization tokens?</a> </li> </ul>
Use this table to describe parameters / fields
ParameterTypeDescription
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.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. 

{% set contents = content_by_ids([4715624297, 4712623297, 5215624284]) %} <ul> {% for content in contents %} <li> <a href="{{ content.absolute_url }}">{{content.title}}</a> </li> {% endfor %} </ul><ul> <li> <a href="http://www.hubspot.com/blog/articles/kcs_article/email/how-do-i-create-default-values-for-my-email-personalization-tokens">How do I create default values for my email or smart content personalization tokens?</a> </li> <li> <a href="https://blog.hubspot.com/marketing/content-marketing-strategy-guide">Content Marketing Strategy: A Comprehensive Guide for Modern Marketers</a> </li> </ul>
Use this table to describe parameters / fields
ParameterTypeDescription
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.

{% set a = ["ham"] %} {% set b = a.copy() %} a: {{a}} b: {{b}} After Append {% do a.append("swiss") %} a: {{a}} b: {{b}}a: [ham] b: [ham] After Append a: [ham, swiss] b: [ham]

count

Gibt die Anzahl der Vorkommen einer Variablen in einer Liste zurück.

{% set attendees = ["Jack","Jon","Jerry","Jessica"] %} {% set jon_count = attendees.count("Jon") %} There are {{jon_count}} Jon's in the list. <p>After append:</p> {% do attendees.append("Jon") %} {% set jon_count_after_append = attendees.count("Jon") %} There are now {{jon_count_after_append}} Jon's in the list.There are 1 Jon's in the list. <p>After append:</p> 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.

Bitte beachten: Aus Sicherheitsgründen können von den HubSpot-Standardobjekttypen nur die Objekte product und marketing_event auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standard-Objekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschütztist oder eine Anmeldung als registriertes CMS-Mitglied erfordert.  Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.

{% set associated_contacts = crm_associations(847943847, "HUBSPOT_DEFINED", 2, "limit=3&years_at_company__gt=2&orderBy=email", "firstname,email", false) %} {{ associated_contacts }}{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}]}

Bitte beachten: 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.

Use this table to describe parameters / fields
ParameterTypeDescription
id
Erforderlich
ID

ID des Datensatzes, von dem Zuordnungen gesucht werden sollen.

association category
Erforderlich
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
Erforderlich
Ganzzahl

Die ID der zu verwendenden Zuordnungsdefinition. Für standardmäßig von HubSpot unterstützte Objekte siehe ID des zu verwendenden Zuordnungstyps.
Andernfalls kann diese Zuordnungs-ID in der CRM-Objektschema-API 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
  • not_in
  • 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ätternvon Ergebnissen, wenn die Anzahl der zurückgegebenen Ergebnisse den limit-Parameter übersteigt. Zum 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 und alle Unternehmenseigenschaften abrufen.

formatting
Boolesch

Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Lassen Sie ihn aus oder übergeben Sie false für Rohzeichenfolgen.

crm_object

Ruft einen einzelnen CRM-Datensatz per Abfrage oder anhand seiner ID ab. Datensätze werden als ein Dictionary von Eigenschaften und Werten zurückgegeben.

Diese Funktion kann auch mit benutzerdefinierten und Integrator-Objekten verwendet werden.

Bitte beachten: Aus Sicherheitsgründen können von den HubSpot-Standardobjekttypen nur die Objekte product und marketing_event auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standard-Objekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschütztist oder eine Anmeldung als registriertes CMS-Mitglied 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.

<!-- by query --> {% set contact = crm_object("contact", "email=contact@company.com", "firstname,lastname", false) %} <!-- by id --> {% set contact = crm_object("contact", 123) %} {{ contact.firstname }} {{ contact.lastname }}Brian Halligan

Bitte beachten: Diese Funktion kann maximal 10 Mal auf einer Seite aufgerufen werden.

Use this table to describe parameters / fields
ParameterTypeDescription
object_type
Zeichenfolge

Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden.
Die unterstützten Objekttypen

Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die CRM-Objektschema-API, um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Er enthält den internen Objekttypnamen, der in der Funktion verwendet werden soll

Für integrator- und accountspezifische Objekttypen, die denselben Namen wie die eingebauten Objekte haben, verwenden Sie den vollständig qualifizierten Namen (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
  • not_in
  • 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ätternvon Ergebnissen, wenn die Anzahl der zurückgegebenen Ergebnisse den limit-Parameter übersteigt. Zum 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 und alle Unternehmenseigenschaften abrufen.

formatting
Boolesch

Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Übergeben Sie false für Rohzeichenfolgen.

Bitte beachten: 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 HubSpot CRM 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 (itotal > 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=Gerd&order=lastname&order=createdate") ordnet Kontakte mit dem Vornamen "Gerd" 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 werden.

Bitte beachten: Aus Sicherheitsgründen können von den HubSpot-Standardobjekttypen nur die Objekte product und marketing_event auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standard-Objekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschütztist oder eine Anmeldung als registriertes CMS-Mitglied erfordert.  Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.

{% set objects = crm_objects("contact", "firstname__not_null=&limit=3", "firstname,lastname") %} {{ objects }}{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}]}

Bitte beachten: Diese Funktion kann maximal 10 Mal pro Seite aufgerufen werden. Jeder crm_objects-Aufruf kann höchstens 100 Objekte zurückgeben. Die Standardobergrenze liegt bei 10 Objekten.

Use this table to describe parameters / fields
ParameterTypeDescription
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

Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die CRM-Objektschema-API, 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 (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
  • not_in
  • contains (gilt für Eigenschaften mit mehreren Werten oder Zeichenfolgeneigenschaften, z. B. "firstname__contains=Tim".

Beispiel: "email=kontakt@unternehmen.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 und alle Unternehmenseigenschaften abrufen.

Die Datensatz-ID ist immer in den zurückgegebenen Objekteigenschaften enthalten, auch wenn sie nicht ausdrücklich in der Eigenschaftsliste aufgeführt ist.

formatting
Boolesch

Optional. Formatieren Sie Werte wie Datum und Währung entsprechend den Einstellungen dieses Portals. Übergeben Sie false für Rohzeichenfolgen.

Bitte beachten: 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.

Bitte beachten: Aus Sicherheitsgründen können von den HubSpot-Standardobjekttypen nur die Objekte product und marketing_event auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standard-Objekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschütztist oder eine Anmeldung als registriertes CMS-Mitglied erfordert.  Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.

{{ crm_property_definition("house_listing", "agent_name") }}
Use this table to describe parameters / fields
ParameterTypeDescription
object_type
Zeichenfolge

Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. Die unterstützten Objekttypen

Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die CRM-Objektschema-API, um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Er enthält den internen Objekttypnamen, der in der Funktion verwendet werden soll

Für integrator- und accountspezifische Objekttypen, die denselben Namen wie die eingebauten Objekte haben, verwenden Sie den vollständig qualifizierten Namen (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.

Bitte beachten: Aus Sicherheitsgründen können von den HubSpot-Standardobjekttypen nur die Objekte product und marketing_event auf einer öffentlich zugänglichen Seite abgerufen werden. Alle anderen Standard-Objekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschütztist oder eine Anmeldung als registriertes CMS-Mitglied erfordert.  Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.

{{ crm_property_definitions("house_listing", "agent_name,address") }}
Use this table to describe parameters / fields
ParameterTypeDescription
object_type
Zeichenfolge

Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. Die unterstützten Objekttypen

Um die Namen der in Ihrem Account verfügbaren accountspezifischen und Integrator-Objekttypen zu finden, verwenden Sie die CRM-Objektschema-API, um die Typdefinitionen abzurufen und die Namenseigenschaft zu suchen. Er enthält den internen Objekttypnamen, der in der Funktion verwendet werden soll

Für integrator- und accountspezifische Objekttypen, die denselben Namen wie die eingebauten Objekte haben, verwenden Sie den vollständig qualifizierten Namen (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.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

{{ cta("ccd39b7c-ae18-4c4e-98ee-547069bfbc5b") }} {{ cta("ccd39b7c-ae18-4c4e-98ee-547069bfbc5b", "justifycenter") }}<span class="hs-cta-wrapper" id="hs-cta-wrapper-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b"> <span class="hs-cta-node hs-cta-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b" id="hs-cta-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b" style="visibility: visible;"> <a id="cta_button_158015_19a9097a-8dff-4181-b8f7-955a47f29826" class="cta_button " href="//cta-service-cms2.hubspot.com/ctas/v2/public/cs/c/?cta_guid=19a9097a-8dff-4181-b8f7-955a47f29826&placement_guid=ccd39b7c-ae18-4c4e-98ee-547069bfbc5b&portal_id=158015&redirect_url=APefjpH34lXcq1H4FhyHhE3DNeHPNigbBluiv6t07-N80GLkyj2Dn9PizhW8bo4ecrS47RmyslLg7QQKWLG7n2oNkvrumL9dWUjMMEjVYvStZ-IMyulMBvdU8AddI6nFXL0G_VPP_VXmnFi66RKPPjPvx6kbyPO6k566noP4CTZMyADHkGsGBf4S95YdTNtTTFabShT62cVAiV_oWlXbpfPWQc4G3IvkoDoAhmpQVW-ggUcKa4Ft_5A&hsutk=683eeb5b499fdfdf469646f0014603b4&utm_referrer=http%3A%2F%2Fwww.davidjosephhunt.com%2F%3Fhs_preview%3DNVkCLfFf-2857453560&canon=http%3A%2F%2Fwww.davidjosephhunt.com%2F-temporary-slug-63bb220d-eda6-44d0-9738-af928e787237" style="" cta_dest_link="http://www.hubspot.com/free-trial" title="Start a HubSpot trial"> Start a HubSpot trial </a> </span> <script charset="utf-8" src="//js.hscta.net/cta/current.js"></script> <script type="text/javascript"> hbspt.cta.load(158015, 'ccd39b7c-ae18-4c4e-98ee-547069bfbc5b'); </script> </span> <span class="hs-cta-wrapper" id="hs-cta-wrapper-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b"> <span class="hs-cta-node hs-cta-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b" id="hs-cta-ccd39b7c-ae18-4c4e-98ee-547069bfbc5b" style="display: block; text-align: center; visibility: visible;"> <a id="cta_button_158015_19a9097a-8dff-4181-b8f7-955a47f29826" class="cta_button " href="//cta-service-cms2.hubspot.com/ctas/v2/public/cs/c/?cta_guid=19a9097a-8dff-4181-b8f7-955a47f29826&placement_guid=ccd39b7c-ae18-4c4e-98ee-547069bfbc5b&portal_id=158015&redirect_url=APefjpH34lXcq1H4FhyHhE3DNeHPNigbBluiv6t07-N80GLkyj2Dn9PizhW8bo4ecrS47RmyslLg7QQKWLG7n2oNkvrumL9dWUjMMEjVYvStZ-IMyulMBvdU8AddI6nFXL0G_VPP_VXmnFi66RKPPjPvx6kbyPO6k566noP4CTZMyADHkGsGBf4S95YdTNtTTFabShT62cVAiV_oWlXbpfPWQc4G3IvkoDoAhmpQVW-ggUcKa4Ft_5A&hsutk=683eeb5b499fdfdf469646f0014603b4&utm_referrer=http%3A%2F%2Fwww.davidjosephhunt.com%2F%3Fhs_preview%3DNVkCLfFf-2857453560&canon=http%3A%2F%2Fwww.davidjosephhunt.com%2F-temporary-slug-63bb220d-eda6-44d0-9738-af928e787237" style="" cta_dest_link="http://www.hubspot.com/free-trial" title="Start a HubSpot trial"> Start a HubSpot trial </a> </span> <script charset="utf-8" src="//js.hscta.net/cta/current.js"></script> <script type="text/javascript"> hbspt.cta.load(158015, 'ccd39b7c-ae18-4c4e-98ee-547069bfbc5b'); </script> </span>
Use this table to describe parameters / fields
ParameterTypeDescription
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. Werte: 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.

{% set vehicles = ["boat","car","bicycle"] %} {% set more_vehicles = ["airplane","motorcycle"] %} {% do vehicles.extend(more_vehicles) %} {{vehicles}}[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.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

{% set file = file_by_id(123) %} {{ file.friendlyUrl }}https://www.hubspot.com/hubfs/HubSpot_Logos/HSLogo_color.svg
Use this table to describe parameters / fields
ParameterTypeDescription
file_id
ID

Die ID der Datei, in der gesucht werden soll.

{% set fm = follow_me_links() %} {{ fm }}[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. 

{{ format_address('en-us', { address: "25 First Street", address2: "2nd Floor", city: "Cambridge", state: "MA", country: "United States", zip: "02141"}) }}[25 First Street, 2nd Floor, Cambridge, MA 02141, United States]
Use this table to describe parameters / fields
ParameterTypeDescription Default
locale
Erforderlich
Zeichenfolge

Das Gebietsschema, in dem die Adresse formatiert werden soll.

address
Erforderlich
Zeichenfolge

Die Straße.

address2
Optional
Zeichenfolge

Die zweite Zeile der Adresse, z. B. Stockwerk oder Hausnummer.

city
Erforderlich
Zeichenfolge

Die Stadt der Adresse.

state
Erforderlich
Zeichenfolge

Der Bundesland der Adresse.

country
Erforderlich
Zeichenfolge

Das Land der Adresse.

zip
Erforderlich
Zeichenfolge

Die Postleitzahl der Adresse.

format_company_name

Formatiert den Namen eines Unternehmens, indem gegebenenfalls eine japanische Anrede hinzugefügt wird.

{{ format_company_name("companyName", addJapaneseHonorifics) }}HubSpot
Use this table to describe parameters / fields
ParameterTypeDescription Default
companyName
Erforderlich
Zeichenfolge

Der Name des Unternehmens.

useHonorificIfApplicable
Erforderlich
Boolesch

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
{{ format_name("firstName", "surname", addJapaneseHonorifics) }}Hobbes Baron
Use this table to describe parameters / fields
ParameterTypeDescription Default
firstName
Erforderlich
Zeichenfolge

Der Vorname der Person.

surname
Erforderlich
Zeichenfolge

Der Nachname der Person.

False
useHonorificIfApplicable
Erforderlich
Boolesch

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-HubL-Filter. Diese Funktion ersetzt die veraltete datetimeformat-Funktion.

{{ format_datetime(content.publish_date, "short", "America/New_York", "en") }} 12/31/69 7:00 PM
Use this table to describe parameters / fields
ParameterTypeDescription Default
format
Erforderlich
Zeichenfolge

Das zu verwendende Format. Kann eines der folgenden sein:

  • short
  • medium
  • long
  • full
  • ein benutzerdefiniertes Muster gemäß Unicode LDML
timeZone
Optional
Zeichenfolge

Die Zeitzone des Ausgabedatums im IANA-TZDB-Format.

locale
Optional
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.

{% for row in hubdb_table_rows(1234567, "geo_distance(loc,1.233,-5.678,mi)__gt=500") %} {{row.name}} <br> {% endfor %}Cambridge, MA<br> Salem, MA<br> San Diego, CA<br> Chicago, IL<br>
Use this table to describe parameters / fields
ParameterTypeDescription
point1
Platzierung

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 <script>-Tag einbezogen werden kann.

copy-public-url
{{ get_asset_url("/custom/styles/style.css") }} //cdn2.hubspot.net/hub/1234567/hub_generated/template_assets/1565970767575/custom/styles/style.min.css
Use this table to describe parameters / fields
ParameterTypeDescription
path
Zeichenfolge

Der Dateipfad des Design-Managers zur Vorlage oder Datei.

get_public_template_url_by_id

Diese Funktion funktioniert genau wie get_public_template_url und liefert die öffentliche URL einer angegebenen Vorlage oder Code-Datei. Der einzige Unterschied besteht darin, dass der Parameter dieser Funktion die ID der Vorlage ist (die in der URL der Vorlage oder der Code-Datei verfügbar ist) und nicht der Pfad des Design-Managers.

{{ get_public_template_url_by_id("2778457004") }} //cdn2.hubspot.net/hub/327485/hub_generated/style_manager/1431479563436/custom/page/Designers_2015/designer-doc-2105.min.js
Use this table to describe parameters / fields
ParameterTypeDescription
template_id
ID

Die ID-Nummer der Vorlage der Datei.

hubdb_table

HubDB ist eine Funktion, die in CMS Hub Professional und Enterprise verfügbar ist.

Die hubdb_table-Funktion kann verwendet werden, um Informationen zu einer Tabelle zu erhalten, einschließlich ihres Namens, ihrer Spalten, der letzten Aktualisierung usw. 

Die folgenden Informationen können durch Aufrufen der entsprechenden Attribute übernommen werden:

  • ID: die ID der Tabelle.
  • name: der Name der Tabelle.
  • columns: eine Liste von Spalteninformationen.
  • created_at: der Zeitstempel, zu dem diese Tabelle erstmals erstellt wurde.
  • published_at: der Zeitstempel, zu dem diese Tabelle veröffentlicht wurde.
  • updated_at: der Zeitstempel, zu dem diese Tabelle zuletzt aktualisiert wurde.
  • row_count: die Anzahl der Zeilen in der Tabelle.
{% set table_info = hubdb_table(1548215) %} {{ table_info.row_count }}25

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

Use this table to describe parameters / fields
ParameterTypeDescription
table_id
Zeichenfolge

ID oder Name der Tabelle.

hubdb_table_column

HubDB ist eine Funktion, die in CMS Hub Professional und Enterprise verfügbar ist.

Die hubdb_table_column-Funktion kann verwendet werden, um Informationen zu einer Spalte in einer Tabelle zu erhalten, z. B. ihr Label, ihren Typ und ihre Optionen. Diese Funktion akzeptiert zwei Parameter. 

Diese Informationen über die Spalte können durch Aufrufen der entsprechenden Attribute übernommen werden:

  • ID: die ID der Spalte.
  • name: der Name der Spalte.
  • label: die für die Spalte zu verwendende Bezeichnung.
  • type: der Typ der Spalte.
  • options: für Spalten vom Typ select, eine Zuordnung von optionId zu Optionsinformationen.
  • foreignIds: für Spalten vom Typ "foreignId" eine Liste von foreignIds (mit den Eigenschaften id und name).

Zusätzlich zu den oben genannten Attributen gibt es auch eine Methode, die aufgerufen werden kann: getOptionByName("<option name>"), wobei für Spalten vom Typ "select" die Optionsinformationen anhand des Namens der Option abgerufen werden.

Bei den Spaltennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Zum Beispiel sind HS_ID und hs_id beide gültig.

{% set column_info = hubdb_table_column(123456, 6) %} {{ column_info.label }}role
Use this table to describe parameters / fields
ParameterTypeDescription
table_id
Zeichenfolge

ID oder Name der Tabelle.

column
Zeichenfolge

ID oder Name der Spalte.

hubdb_table_row

HubDB ist eine Funktion, die in CMS Hub Professional und Enterprise verfügbar ist.

Die hubdb_table_row-Funktion kann verwendet werden, um eine einzelne Zeile aus einer HubDB-Tabelle zu übernehmen. In dieser Zeile können Sie Informationen aus jeder Tabellenzelle übernehmen, indem Sie das entsprechende Attribut aufrufen: 

  • hs_id: die global eindeutige ID für diese Zeile.
  • hs_created_at: ein Zeitstempel, der angibt, wann diese Zeile erstellt wurde.
  • hs_path: bei Verwendung mit dynamischen Seiten ist diese Zeichenfolge das letzte Segment des Pfades der URL für die Seite.
  • hs_name: bei Verwendung mit dynamischen Seiten ist dies der Titel der Seite.
  • <column name> oder ["<column name>"]: Rufen Sie den Wert der Spalte für diese Zeile anhand des name der Spalte ab.

Bei den Spaltennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Zum Beispiel sind HS_ID und hs_id beide gültig.

{% set row = hubdb_table_row(1548264, 6726439331) %} {{ row.role }}CTO

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

Use this table to describe parameters / fields
ParameterTypeDescription
table_id
Zeichenfolge

ID oder Name der Tabelle.

row_id
Ganzzahl
ID der Zeile der Tabelle.

hubdb_table_rows

HubDB ist eine Funktion, die in CMS Hub Professional und Enterprise verfügbar ist.

Die hubdb_table_rows-Funktion kann verwendet werden, um Zeilen einer HubDB-Tabelle aufzulisten, die dann durchlaufen werden können. Ein einzelner Aufruf von hubdb_table_rows() ist auf 10 Tabellen-Scans pro Seite beschränkt.

Standardmäßig gibt diese Funktion maximal 1.000 Zeilen zurück. Um mehr Zeilen abzurufen, geben Sie ein limit in der Abfrage an, wie im folgenden Code gezeigt.

Bitte beachten: Wenn Sie einen zufälligen Filter für diese Funktion verwenden, wird die Seite regelmäßig vorgerendert. Dies bedeutet, dass der gefilterte Inhalt nicht bei jedem erneuten Laden der Seite aktualisiert wird.

{% for row in hubdb_table_rows(1546258, "years_at_company__gt=3&orderBy=count&limit=1500") %} the value for row {{ row.hs_id }} is {{ row.name }} {% endfor %}the value for row 6726439331 is Brian Halligan the value for row 8438997836 is Dharmesh Shah
Use this table to describe parameters / fields
ParameterTypeDescription
table_id
Zeichenfolge

ID oder Name der abzufragenden Tabelle.

query
Zeichenfolge

Eine Abfrage im gleichen Format wie eine URL-Abfragezeichenfolge. Wenn nicht übergeben, werden alle Zeilen zurückgegeben. Erfahren Sie mehr über die verfügbaren Filter für die Abfrage von HubDB-Tabellenzeilen.

Sie können die Sortierung umkehren, indem Sie ein - an den Spaltennamen anhängen: orderBy=-bar. Sie können diesen Parameter mehrfach angeben, um nach mehreren Spalten zu sortieren.

Neben der Sortierung nach einer Spalte können Sie auch die folgenden Funktionen einbeziehen:

  • geo_distance(location_column_name, latitude, longitude):
    nimmt den Namen einer Standortspalte und Koordinaten an und gibt die Zeilen danach geordnet zurück, wie weit der Wert der angegebenen Standortspalte von den angegebenen Koordinaten entfernt ist.
  • length(column_name):
    nimmt den Namen einer Spalte an und gibt die Zeilen geordnet nach der Länge des Spaltenwerts (berechnet als Zeichenfolge) zurück
  • random():
    gibt die Zeilen in zufälliger Reihenfolge zurück.

Diese Funktionen unterstützen auch das Anordnen in umgekehrter Reihenfolge. Beispiel:
orderBy=-geo_distance(location_column,42.37,-71.07)
gibt zuerst die am weitesten entfernten Elemente zurück.

Bitte beachten: 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=).

include_default_custom_css

Diese Funktion erzeugt ein Link-Tag, das auf die primäre CSS-Datei(default_custom_style.min.css) verweist. Diese Datei ist als globale CSS-Datei konzipiert, die zu allen Vorlagen hinzugefügt werden kann. Zum Rendern benötigt die Funktion einen booleschen Parameterwert von True.

{{ include_default_custom_css(True) }} <link href="//cdn2.hubspot.net/hub/327485/hub_generated/style_manager/1420345777097/custom/styles/default/hs_default_custom_style.min.css" rel="stylesheet">

index

Gibt die Position des ersten übereinstimmenden Elements in einem 0-basierten Array zurück.

Diese Funktion akzeptiert 3 Parameter. Der erste Parameter ist erforderlich. Der erste Parameter ist das Element, das Sie im Array suchen. Mit dem zweiten (start) und dritten (end) können Sie das Element in einem Teil des array finden. 

{% set shapes = ["triangle","square","trapezoid","triangle"] %} triangle index: {{shapes.index("triangle")}} <br> trapezoid index: {{shapes.index("trapezoid")}} <hr> adjusted start and end <br> triangle index: {{shapes.index("triangle",1,5)}}triangle index: 0<br> trapezoid index: 2 <hr> adjusted start and end<br> triangle index: 3

insert

Platziert ein Element in einer Liste an dem angegebenen Index.

Diese Funktion akzeptiert zwei Parameter:

  • Index: die Position, an der ein Element eingefügt werden soll.
  • Element: das einzufügende Element.
{% set even_numbers = [2,4,8,10] %} {% do even_numbers.insert(2,6) %} {{even_numbers}}[2, 4, 6, 8, 10]

locale_name

Gibt eine menschenlesbare Zeichenfolgendarstellung eines Sprachcodes zurück, optional übersetzt in eine Zielsprache.

{{ locale_name("es") }} {{ locale_name("es", "en") }}Español Spanish
Use this table to describe parameters / fields
ParameterTypeDescription
language_code
Zeichenfolge

Der Sprachcode.

target_language_code
Zeichenfolge

Die Sprache, in die die Ausgabe übersetzt werden soll.

load_translations

Lädt Übersetzungen aus einem bestimmten _locales-Ordnerpfad und gibt eine Karte der Werte zurück.

Erfahren Sie mehr über das Berücksichtigen von Feldübersetzungen in benutzerdefinierten Modulen und Designs.

{% set template_translations = load_translations('../_locales', 'fr', 'en') %} {{ partial_footer_address }}123 Rue du Pont, Ville, Région, 12300
Use this table to describe parameters / fields
ParameterTypeDescription
path
Zeichenfolge

Der Dateipfad zum the _locales-Verzeichnis der Übersetzungen.

language_code
Zeichenfolge

Der Sprachcode.

language_code_fallback
Zeichenfolge

Der Sprachcode-Fallback, wenn der angegebene language_code nicht vorhanden ist.

Gibt die verschachtelte Link-Struktur eines erweiterten Menüs zurück. Menüknoten verfügen über eine Vielzahl von Eigenschaften, die für die zurückgegebenen Objekte verwendet werden können. Wenn Sie der Menüfunktion null übergeben, wird eine leere PyList zurückgegeben. Sie können ein Menü auch nach Namen angeben. In den meisten Fällen ist es sicherer, die Menü-ID zu verwenden, da ein Menü, das umbenannt wird, keine Auswirkungen auf die ID hat. Wenn man für den Marketplace entwickelt, ist es sinnvoll, als Standard "default" festzulegen, wenn das Menü leer ist.

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt. 

{% set node = menu(987) %} {% for child in node.children %} {{ child.label }}<br> {% endfor %} {% set default_node = menu("default") %} {% for child in default_node.children %} {{ child.label }}<br> {% endfor %}page1<br> page2<br> page3<br>

Wenn Sie die menu()-Funktion verwenden, um ein Menü zu erstellen, sind Sie in vollem Umfang dafür verantwortlich, dass Ihr Menü barrierefrei ist.

Use this table to describe parameters / fields
ParameterTypeDescription
menu_id
ID

Erforderlich. Die ID des Menüs wird als Zahl übergeben.

root_type
Aufzählung

Stammtyp des Menüs ("site_root", "top_parent", "parent", "page_name", "page_id", "breadcrumb").

  • "site_root" bezeichnet statisch – es werden immer Top-Level-Seiten im Menü angezeigt.
  • "top_parent" bezeichnet dynamisch nach Bereich – Seiten im Menü abhängig vom angezeigten Bereich anzeigen
  • "parent" bezeichnet dynamisch nach Seite - Seiten im Menü anzeigen, die mit der angezeigten Seite in Verbindung stehen
  • "breadcrumb" bezeichnet Breadcrumb-Pfadmenüs (horizontaler Verlauf)
root_key
Zeichenfolge

Root-Key (id oder name) bei Verwendung von "page_name" oder "page_id".

module_asset_url

Ruft die URL für ein Element ab, das über Verlinkte Dateien > Andere Dateien an ein benutzerdefiniertes Modul angehängt ist.

{{ module_asset_url("smile.jpg") }} https://cdn2.hubspot.net/hubfs/6178146/logo-black-color.png
Use this table to describe parameters / fields
ParameterTypeDescription
name
Zeichenfolge

Der Name des Elements.

namespace

Erstellt ein namespace-Objekt, das beliebige Attribute enthalten kann. Es kann aus einem Dictionar oder mit Keyword-Argumenten initialisiert werden.

{% set ns = namespace({"name": "item name", "price":"100"}, b=false) %} {{ns.name}}, {{ns.b}}item name, false
Use this table to describe parameters / fields
ParameterTypeDescription
dictionary
Map

Das Dictionary, mit dem initialisiert werden soll.

kwargs
Zeichenfolge

Keyword-Argumente, die in das namespace-Dictionary eingefügt werden sollen.

oembed

Gibt das OEmbed-Data-Dictionary für die angegebene Anfrage zurück. Funktioniert nur in E-Mails.
{{ oembed({ url: "https://www.youtube.com/watch?v=KqpFNtbEOh8"}) }}OEmbedResponse{type=video, version=1.0, html=<iframe width="480" height="270" src="https://www.youtube.com/embed/KqpFNtbEOh8?feature=oembed" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>, title=Marketing Is a Marathon — Build a Complete Customer Experience, authorName=HubSpot, authorUrl=https://www.youtube.com/user/HubSpot, providerName=YouTube, providerUrl=https://www.youtube.com/, thumbnailUrl=https://i.ytimg.com/vi/KqpFNtbEOh8/hqdefault.jpg, thumbnailWidth=480, thumbnailHeight=360}
Use this table to describe parameters / fields
ParameterTypeDescription
request
Zeichenfolge

Anfrageobjekt, {url: string, max_width: long, max_height: long}.

personalization_token

Gibt den Wert eines Kontakts odereiner kontaktbezogenen Eigenschaft oder einen Standardwert zurück.
Hi {{ personalization_token("contact.firstname", "there") }}!<!-- If the contact is known --> Hi Dharmesh! <!-- If the contact is unknown --> Hi there!
Use this table to describe parameters / fields
ParameterTypeDescription
expression
Zeichenfolge

Ein Ausdruck für das zu rendernde Objekt und die Eigenschaft.

default
Zeichenfolge

Optional. Ein Standardwert, der verwendet wird, wenn der Ausdruck keinen Wert hat.

pop

Entfernt das Element mit dem Index aus der Liste. Gibt auch das entfernte Element zurück, wenn es gedruckt wurde.
{% set even_numbers = [2,3,4,6,8,9,10] %} {% do even_numbers.pop(1) %} {{even_numbers.pop(4)}} {{even_numbers}}9 [2, 4, 6, 8, 10]

postal_location

Die postal_location-Funktion gibt das Standort-Paar aus Breiten- und Längengrad für eine bestimmte Postleitzahl und einen bestimmten Ländercode (beschränkt auf USA, CA und GB) zurück.
{{ postal_location("02139") }} {% set location = postal_location("02139", "US") %} {{ location.latitude }} {{ location.longitude }}LatLon{latitude=42.3647, longitude=-71.1042} 42.3647 -71.1042

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

Use this table to describe parameters / fields
ParameterTypeDescription
postal_code
Zeichenfolge

Postleitzahl des Ortes.

country_code
Zeichenfolge

Ländercode für die Postleitzahl. Wenn keine Angaben gemacht werden, wird versucht, das Land aus der Postleitzahl abzuleiten.

put

Ähnlich wie bei der Update-Funktion, die ein Dictionary mit den Elementen aus einem anderen dict-Objekt oder aus einem Iterable von Schlüssel-Wert-Paaren aktualisiert, mit der Ausnahme, dass put Variablennamen in Dictionarys unterstützt.
{% set dict_var = {"authorName": "Tim Robinson"} %} {% set key = "key" %} {% set value = "value" %} {% do dict_var.put(key, value) %} {{ dict_var }}{authorName=Tim Robinson, key=value}

range

Gibt eine Liste zurück, die eine arithmetische Progression von Ganzzahlen enthält. Mit einem Parameter gibt range eine Liste von 0 bis zu (aber nicht einschließlich) dem Wert zurück. Bei zwei Parametern beginnt der Bereich beim ersten Wert und erhöht sich um 1 bis zum zweiten Wert (aber nicht einschließlich). Der dritte Parameter gibt die Schrittweite an. Alle Werte können negativ sein. Unmögliche Bereiche ergeben eine leere Liste. Bereiche können bis zu 1.000 Werte erzeugen.

range kann innerhalb einer for-Schleife verwendet werden, um die Anzahl der Iterationen anzugeben, die ausgeführt werden sollen.

{{ range(11) }} {{ range(5, 11) }} {{ range(0, 11, 2) }} {% for number in range(11) %} {{ number }} {% endfor %}[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10] [5, 6, 7, 8, 9, 10] [0, 2, 4, 6, 8, 10] 0 1 2 3 4 5 6 7 8 9 10

require_css

Diese Funktion stellt eine CSS-Datei in die Warteschlange, die im head-Element gerendert werden soll. Alle CSS-link-Tags werden gruppiert und vor allen JavaScript-Tags gerendert. Der HubL wird durch eine leere Zeile ersetzt, und dann wird ein link-Tag zu {{ standard_header_includes }} hinzugefügt. Diese Methode erfordert eine absolute URL; CMS-Inhalte mit einer bekannten relativen URL können durch Verwendung der get_asset_url()-Funktion angefordert werden.

Um einen Inline-Style im head über ein style-Tag-Element zu rendern, verwenden Sie stattdessen das {% require_css %} and {% end_require_css %}-Tag mit Ihren style-Tags und CSS darin.

Der zweite Parameter ist ein Dictionary mit Optionen zur Änderung des erzeugten Tags. Unterstützt async (true/false) (eine auf web.dev beschriebene Technik) und jedes andere Schlüssel-Wert-Paar wird als HTML-Attribut zum style-Tag hinzugefügt.

{{ standard_header_includes }} <!-- more html --> {{ require_css("http://example.com/path/to/file.css") }} {{ require_css(get_asset_url("/relative/path/to/file.css")) }} <!-- you can tell the browser to load the file asynchronously --> {{ require_css(get_asset_url("./style.css"), { async: true }) }}<!-- other standard header html --> <link type="text/css" rel="stylesheet" href="http://example.com/path/to/file.css"> <link type="text/css" rel="stylesheet" href="http://example.com/relative/path/to/file.css"> <!-- you can tell the browser to load the file asynchronously --> <link rel="preload" href="//cdn2.hubspot.net/hub/6333443/hub_generated/template_assets/39079350918/1608661506628/example.css" as="style" onload="this.onload=null;this.rel='stylesheet'"> <noscript><link rel="stylesheet" href="//cdn2.hubspot.net/hub/6333443/hub_generated/template_assets/39079350918/1608661506628/example.css"></noscript> <!-- more html -->

require_js

Gibt an, ob ein Skript in die Warteschlange gestellt werden soll, um im Header oder Footer gerendert zu werden (Standard). Geben Sie den Rendering-Speicherort an, indem Sie den head- oder footer-Parameter einbeziehen. Der HubL wird durch eine Leerzeile ersetzt und entweder in die Header- und Footer-Incudes einbezogen.

Um ein Inline-Skript, das im Footer gerendert werden soll, über ein script-Element in die Warteschlange zu stellen, umschließen Sie Ihre <script>-Tags mit {% require_js %} und {% end_require_js %}

Sie können auch zusätzliche Rendering-Optionen in diese Funktion einschließen. Diese werden als HTML-Attribute in das script-Tag eingefügt. Folgende Renderoptionen sind verfügbar:

  • position: head/footer
  • defer: true/false
  • async: true/false
  • type: string
{{ standard_header_includes }} <!-- more html --> {{ require_js("http://example.com/path/to/footer-file.js", "footer") }} {{ require_js("http://example.com/path/to/head-file.js", "head") }} <!-- you can add async or defer attributes to the tags that are added. --> {{ require_js(get_asset_url("./path/to/file.js"), { position: "footer", async: true }) }} {{ require_js(get_asset_url("./jquery-latest.js"), { position: "footer", defer:true }) }} {{ standard_footer_includes }}<!-- other standard header html --> <script async defer src="//cdn2.hubspot.net/hub/6333443/hub_generated/template_assets/37785718838/1605816776975/jquery-latest.min.js"></script> <script src="http://example.com/path/to/head-file.js"></script> <!-- more html --> <script src="http://example.com/path/to/footer-file.js"></script> <!-- you can add async or defer attributes to the tags that are added. --> <script async src="//cdn2.hubspot.net/hub/######/hub_generated/template_assets/#############/######/jquery-latest.min.js"></script> <script defer src="//cdn2.hubspot.net/hub/######/hub_generated/template_assets/#############/######/jquery-latest.min.js"></script> <!-- other standard footer html -->

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

  • width: Zahl, die die neue Bildbreite in Pixeln angibt.
  • height: Zahl, die die neue Bildhöhe in Pixeln angibt.
  • length: Zahl, die die neue Länge der größten Seite in Pixeln angibt.
  • upscale: boolescher Wert, die geänderten Bildmaße werden auch dann verwendet, wenn das Originalbild dadurch vergrößert wird (Bilder können unscharf erscheinen).
  • upsize: boolescher Wert, gibt das verkleinerte Bild zurück, auch wenn es in Bytes größer als das Original ist.

Bitte beachten: 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 

{{ resize_image_url("http://your.hubspot.site/hubfs/img.jpg", 0, 0, 300) }}http://your.hubspot.site/hubfs/img.jpg?length=300&name=img.jpg
Use this table to describe parameters / fields
ParameterTypeDescription
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
Boolesch

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
Boolesch

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.

{% set numbers = [1,2,3,4] %} {% do numbers.reverse() %} {{numbers}}[4, 3, 2, 1]

set_response_code

Legen Sie den Antwortcode als den angegebenen Code fest. 404 ist im Moment der einzige unterstützte Code. Wenn Sie dies verwenden, gibt Ihre Seite einen 404-Fehler zurück.

{{ set_response_code(404) }} <!-- this will cause the page to result in a 404 error -->
Use this table to describe parameters / fields
ParameterTypeDescription
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-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 <h3> 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. 

{% extends "custom/page/web_page_basic/parent.html" %} {% block sidebar %} <h3>Table Of Contents</h3> {{ super() }} {% endblock %}<!doctype html> <html> <head> <meta charset="utf-8"> <title>This is the parent template </title> </head> <body> <h3>Table of contents</h3> Sidebar content from parent. </body> </html>

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.

{{ today() }} {{ today("America/New_York") }} {{ unixtimestamp(today("America/New_York").plusDays(1)) }}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.

{{ to_local_time(eastern_dt) }} 2015-05-13 10:37:31
Use this table to describe parameters / fields
ParameterTypeDescription
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.

{{ 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" -%} <div>Topic: <a href="{{ topicCluster.pillarPage.url.value }}">{{ topicCluster.coreTopic.phrase }}</a></div> {%- endif -%} {%- endif -%}{ 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}]}) <div> Topic: <a href="#-link-to-pillar-page-url"> core topic phrase </a> </div>

Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

Use this table to describe parameters / fields
ParameterTypeDescription
content_id
ID

Die ID der zu suchenden Seite.

truncate

Die truncate-Funktion funktioniert genau wie die trunkieren-Filter-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.

{{ 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, "...") }} string to truncate ... Lorem ipsum dolor sit amet, consectetur ...
Use this table to describe parameters / fields
ParameterTypeDescription
string_to_truncate
Zeichenfolge

Zeichenfolge, die abgeschnitten werden soll.

length
integer

Gibt die Länge an, bei der der Text abgeschnitten werden soll (einschließlich HTML-Zeichen).

killwords
boolean

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".

{{ type("Blog") }} {% set my_type = type("Blog") %} <p>{{my_type}}</p><p>str</p>

unixtimestamp

Diese Funktion gibt einen Unix-Zeitstempel zurück. Standardmäßig wird der Zeitstempel von jetzt zurückgegeben oder Sie können optional ein datetime-Objekt angeben, das in einen Unix-Zeitstempel konvertiert wird.

{{ unixtimestamp() }} {{ unixtimestamp(d) }} 1582822133978 1565983117868

update

Aktualisiert das Dictionary mit den Elementen aus einem anderen dict-Objekt oder aus einer Iterable von Schlüssel-Wert-Paaren.

{% set dict_var = {"authorName": "Douglas Judy", "authorTitle": "Mastermind" } %} {% do dict_var.update({"authorFriend": "Jake"}) %} {% do dict_var.update({"authorLocation": "unknown"}) %} {{ dict_var }}{authorName=Douglas Judy, authorTitle=Mastermind, authorFriend=Jake, authorLocation=unknown}

War dieser Artikel hilfreich?
Dieses Formular dient dazu, Feedback zu unserer Entwicklerdokumentation zu sammeln. Wenn Sie uns Ihre Meinung zu HubSpot-Produkten mitteilen möchten, teilen Sie diese bitte im Ideenforum der Community.