Zum Hauptinhalt springen
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.

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.

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.

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.

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.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
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.
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.
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.

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.

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 "brian-halligan" 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.
Hinweis: Diese Funktion ist auf 200 Beiträge und 10 Aufrufe pro Seite begrenzt.

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. Dabei wird eine benutzerdefinierte Beitragsauflistung mit Ihren beliebtesten Beiträgen erstellt. 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.
Hinweis: Diese Funktion ist auf 200 Beiträge und 10 Aufrufe pro Seite begrenzt.

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.
Hinweis: Diese Funktion ist auf 100 Beiträge und 10 Aufrufe pro Seite begrenzt.

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.

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.

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.

clear

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

color_contrast

Diese Funktion validiert den Farbkontrast basierend auf WCAG-Standards. 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.

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

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.

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.

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.

count

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

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 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 oder eine Anmeldung als registriertes CMS-Mitglied erfordert. Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.
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.

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 werden.
Hinweis: 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 Standardobjekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschützt ist 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.
Hinweis: Diese Funktion kann maximal 10 Mal auf einer Seite aufgerufen werden.
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 werden.
Hinweis: 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 Standardobjekttypen müssen auf einer Seite gehostet werden, die entweder passwortgeschützt ist oder eine Anmeldung als registriertes CMS-Mitglied erfordert. Für benutzerdefinierte Objekte gilt diese Einschränkung nicht.
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.
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.

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.

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.

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.

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.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

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.
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 verwenden, da die CRM-Eigenschaft als durch Semikolon getrennte Zeichenfolge zurückgegeben wird.

flag_content_for_access_check

Wenn ein Blog-Beitrag für den Zugriff über Selbstregistrierung konfiguriert 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. 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=<true/false> A value of true indicates that the blog post requires the visitor to log in to view the full content.
Gibt die in den Account-Einstellungen festgelegten Social-Media-Konto-Links zurück. Wird im follow_me-Standardmodul verwendet.

format_address

Formatiert eine Adresse basierend auf dem Gebietsschema des Kontexts.

format_company_name

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

format_name

Formatiert den Namen einer Person, indem der Nachname vor den Vornamen gestellt wird, und fügt gegebenenfalls eine japanische Anrede hinzu

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.

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.

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

hubdb_table

HubDB ist eine Funktion, die in Content 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.
  • Spalten: 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: Zeitstempel des Zeitpunkts, zu dem diese Tabelle zuletzt aktualisiert wurde.
  • row_count: die Anzahl der Zeilen in der Tabelle.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

hubdb_table_column

HubDB ist eine Funktion, die in Content 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.
  • Typ: der Typ der Spalte.
  • Optionen: für Spalten vom Typ select, eine Zuordnung von optionId für optionale Informationen.
  • 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("&lt;option name&gt;")**, 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: HS_ID und hs_id sind beide gültig.

hubdb_table_row

HubDB ist eine Funktion, die in Content 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: HS_ID und hs_id sind beide gültig.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

hubdb_table_rows

HubDB ist eine Funktion, die in Content 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.
Hinweis: 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.
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=).

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.

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.

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.

locale_name

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

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.
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ü null ist.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
Wenn Sie die menu()-Funktion verwenden, um ein Menü zu erstellen, sind Sie in vollem Umfang dafür verantwortlich, dass Ihr Menü barrierefrei ist.

module_asset_url

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

namespace

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

oembed

Gibt das OEmbed-Data-Dictionary für die angegebene Anfrage zurück. Funktioniert nur in E-Mails.

personalization_token

Gibt den Wert eines Kontakts odereiner kontaktbezogenen Eigenschaft oder einen Standardwert zurück.

pop

Entfernt das Element mit dem Index aus der Liste. Gibt auch das entfernte Element zurück, wenn es gedruckt wurde.

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.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

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.

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 value zurück. Bei zwei Parametern beginnt der Bereich beim ersten Wert und erhöht sich um 1 bis zum zweiten value (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.

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

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
  • Verzögern: true/false
  • Asynchron: true/false
  • Typ: string

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.

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

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.

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.

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.

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.
Hinweis: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.

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

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

unixtimestamp

Diese Funktion gibt einen Unix-Zeitstempel zurück, wenn Sie ein datetime-Objekt angeben.

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.
Zuletzt geändert am 10. Februar 2026