HubL-Funktionen
Funktionen in HubL ähneln Filtern insofern, als sie Parameter akzeptieren und einen Wert erzeugen. Allerdings müssen nicht alle Funktionen auf einen ursprünglichen Vorlagenwert angewendet werden, sondern sie interagieren mit anderen Bereichen Ihrer HubSpot-Umgebung.
Wenn Sie eine ältere Website betreiben, sollten Sie sich auch die Liste der veralteten HubL-Funktionen ansehen.
Im Folgenden erfahren Sie mehr über die einzelnen HubL-Funktionen und ihre Syntax.
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.
Parameter | Type | Description |
---|---|---|
selected_blog
| Blog-ID oder "default" | Gibt an, welcher Blog verwendet werden soll. Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben. |
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.
Parameter | Type | Description |
---|---|---|
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 |
author_slug
| Zeichenfolge oder HubL-Variable | Gibt an, zu welchem Autor verlinkt werden soll. Kann entweder |
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.
Parameter | Type | Description |
---|---|---|
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 |
limit
| Ganzzahl | Legt das Limit für die Anzahl der abgerufenen Autoren fest. |
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.
Parameter | Type | Description |
---|---|---|
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 |
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.
Parameter | Type | Description |
---|---|---|
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.
Parameter | Type | Description |
---|---|---|
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 |
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
Dieser Parameter ist erforderlich, wenn der |
logical_operator
| Zeichenfolge | Wenn Bei Einbeziehen dieses Parameters ist |
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.
Parameter | Type | Description |
---|---|---|
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 |
year
| Ganzzahl | Das Jahr. |
month
| Ganzzahl | Der optionale Monat. |
day
| Ganzzahl | Der optionale Tag. |
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.
Parameter | Type | Description |
---|---|---|
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). |
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.
Parameter | Type | Description |
---|---|---|
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 |
limit
| Ganzzahl | Gibt die Anzahl der Beiträge an, die der Sequenz hinzugefügt werden sollen, maximal 200. |
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 wirdtag_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.
Parameter | Type | Description |
---|---|---|
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 |
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
| Zeichenfolge | Wenn Bei Einbeziehen dieses Parameters ist |
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
Parameter | Type | Description |
---|---|---|
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 |
tag_slug
| Zeichenfolge | Gibt an, zu welchem Tag verlinkt werden soll. |
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.
Parameter | Type | Description |
---|---|---|
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. |
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.
Parameter | Type | Description |
---|---|---|
selected_blog
| Blog-ID oder "default" | Gibt an, welcher Blog gezählt werden soll. Die Blog-ID wird vom Modul-Blog-Feld zurückgegeben. |
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).
Parameter | Type | Description |
---|---|---|
base_color
| HEX-Farbzeichenfolge | Die zu ändernde Ausgangsfarbe (Beispiel: |
brightness_offset
| Ganzzahl | Eine positive oder negative Zahl, die zum Aufhellen oder Verdunkeln der Grundfarbe verwendet wird. |
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.
Parameter | Type | Description |
---|---|---|
id
| ID | Die ID des zu suchenden Inhalts. |
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.
Parameter | Type | Description |
---|---|---|
ids
| Liste | Eine Liste von Seiten- oder Blog-Beitrags-IDs, die gesucht werden sollen. Es können bis zu 100 Inhaltsobjekte übergeben werden. |
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.
Gibt die Anzahl der Vorkommen einer Variablen in einer Liste zurück.
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.
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.
Parameter | Type | Description |
---|---|---|
id
Erforderlich
| ID | ID des Datensatzes, von dem Zuordnungen gesucht werden sollen. |
association category
Erforderlich
| Zeichenfolge | Die Kategorie der Zuordnungsdefinition. Mögliche Werte sind |
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. |
query
| Zeichenfolge | Die
Abfragen können die folgenden Parameter enthalten:
|
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 |
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.
Bitte beachten: Diese Funktion kann maximal 10 Mal auf einer Seite aufgerufen werden.
Parameter | Type | Description |
---|---|---|
object_type
| Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. 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
Abfragen können die folgenden Parameter enthalten:
|
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 |
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=
).
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.
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.
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.
Parameter | Type | Description |
---|---|---|
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. 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 Unterstützte Operatoren sind:
Beispiel: |
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 |
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=
).
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.
Parameter | Type | Description |
---|---|---|
object_type
| Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. Die unterstützten Objekttypen. 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. |
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.
Parameter | Type | Description |
---|---|---|
object_type
| Zeichenfolge | Der Name des Objekttyps. Bei Objekttypnamen wird zwischen Groß- und Kleinschreibung unterschieden. Die unterstützten Objekttypen. 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. |
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.
Parameter | Type | Description |
---|---|---|
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: |
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.
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.
Parameter | Type | Description |
---|---|---|
file_id
| ID | Die ID der Datei, in der gesucht werden soll. |
Gibt die in den Account-Einstellungen festgelegten Social-Media-Konto-Links zurück. Wird im follow_me-Standardmodul verwendet.
Formatiert eine Adresse basierend auf dem Gebietsschema des Kontexts.
Parameter | Type | Description | 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. |
Formatiert den Namen eines Unternehmens, indem gegebenenfalls eine japanische Anrede hinzugefügt wird.
Parameter | Type | Description | Default |
---|---|---|---|
companyName
Erforderlich
| Zeichenfolge | Der Name des Unternehmens. | |
useHonorificIfApplicable
Erforderlich
| Boolesch | Wenn dies auf |
Parameter | Type | Description | Default |
---|---|---|---|
firstName
Erforderlich
| Zeichenfolge | Der Vorname der Person. | |
surname
Erforderlich
| Zeichenfolge | Der Nachname der Person. |
False
|
useHonorificIfApplicable
Erforderlich
| Boolesch | Wenn dies auf |
Formatiert sowohl die Datums- als auch die Uhrzeitkomponente eines Datumsobjekts, ähnlich dem format_datetime-HubL-Filter. Diese Funktion ersetzt die veraltete datetimeformat
-Funktion.
Parameter | Type | Description | Default |
---|---|---|---|
format
Erforderlich
| Zeichenfolge | Das zu verwendende Format. Kann eines der folgenden sein:
| |
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. |
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.
Parameter | Type | Description |
---|---|---|
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 |
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.
Parameter | Type | Description |
---|---|---|
path
| Zeichenfolge | Der Dateipfad des Design-Managers zur Vorlage oder Datei. |
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.
Parameter | Type | Description |
---|---|---|
template_id
| ID | Die ID-Nummer der Vorlage der Datei. |
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.
Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
Parameter | Type | Description |
---|---|---|
table_id
| Zeichenfolge | ID oder Name der Tabelle. |
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 vonoptionId
zu Optionsinformationen. - foreignIds: für Spalten vom Typ
"foreignId"
eine Liste vonforeignIds
(mit den Eigenschaftenid
undname
).
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.
Parameter | Type | Description |
---|---|---|
table_id
| Zeichenfolge | ID oder Name der Tabelle. |
column
| Zeichenfolge | ID oder Name der Spalte. |
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.
Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
Parameter | Type | Description |
---|---|---|
table_id
| Zeichenfolge | ID oder Name der Tabelle. |
row_id
| Ganzzahl | ID der Zeile der Tabelle. |
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.
Parameter | Type | Description |
---|---|---|
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 Neben der Sortierung nach einer Spalte können Sie auch die folgenden Funktionen einbeziehen:
Diese Funktionen unterstützen auch das Anordnen in umgekehrter Reihenfolge. Beispiel: |
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=
).
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
.
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.
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.
Gibt eine menschenlesbare Zeichenfolgendarstellung eines Sprachcodes zurück, optional übersetzt in eine Zielsprache.
Parameter | Type | Description |
---|---|---|
language_code
| Zeichenfolge | Der Sprachcode. |
target_language_code
| Zeichenfolge | Die Sprache, in die die Ausgabe übersetzt werden soll. |
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.
Parameter | Type | Description |
---|---|---|
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 |
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.
Wenn Sie die menu()
-Funktion verwenden, um ein Menü zu erstellen, sind Sie in vollem Umfang dafür verantwortlich, dass Ihr Menü barrierefrei ist.
Parameter | Type | Description |
---|---|---|
menu_id
| ID | Erforderlich. Die ID des Menüs wird als Zahl übergeben. |
root_type
| Aufzählung | Stammtyp des Menüs (
|
root_key
| Zeichenfolge | Root-Key (id oder name) bei Verwendung von |
Ruft die URL für ein Element ab, das über Verlinkte Dateien > Andere Dateien an ein benutzerdefiniertes Modul angehängt ist.
Parameter | Type | Description |
---|---|---|
name
| Zeichenfolge | Der Name des Elements. |
Erstellt ein namespace-Objekt, das beliebige Attribute enthalten kann. Es kann aus einem Dictionar oder mit Keyword-Argumenten initialisiert werden.
Parameter | Type | Description |
---|---|---|
dictionary
| Map | Das Dictionary, mit dem initialisiert werden soll. |
kwargs
| Zeichenfolge | Keyword-Argumente, die in das namespace-Dictionary eingefügt werden sollen. |
Parameter | Type | Description |
---|---|---|
request
| Zeichenfolge | Anfrageobjekt, |
Parameter | Type | Description |
---|---|---|
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. |
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.Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
Parameter | Type | Description |
---|---|---|
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
Variablennamen in Dictionarys unterstützt.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.
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.
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
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
Parameter | Type | Description |
---|---|---|
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 |
upsize
| Boolesch | Gibt das verkleinerte Bild zurück, auch wenn es in Bytes größer als das Original ist. |
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
.
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.
Parameter | Type | Description |
---|---|---|
code
| Ganzzahl | Der HTTP-Antwortcode. Derzeit ist |
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.
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.
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.
Parameter | Type | Description |
---|---|---|
date
| Datetime | UNIX-Zeitstempel zur Konvertierung in die lokale Zeit. |
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.
Bitte beachten: Diese Funktion ist auf 10 Aufrufe pro Seite begrenzt.
Parameter | Type | Description |
---|---|---|
content_id
| ID | Die ID der zu suchenden Seite. |
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.
Parameter | Type | Description |
---|---|---|
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. |
Aktualisiert das Dictionary mit den Elementen aus einem anderen dict-Objekt oder aus einer Iterable von Schlüssel-Wert-Paaren.
Vielen Dank, dass Sie Ihr Feedback mit uns geteilt haben.