Funções do HubL

As funções no HubL são semelhantes aos filtros, pois aceitam parâmetros e geram um valor. No entanto, nem todas as funções precisam ser aplicadas a um valor de modelo inicial e, em vez disso, elas interagem com outras áreas do seu ambiente da HubSpot.

Caso mantenha um site mais antigo, você também pode querer verificar a lista de funções HubL descontinuadas.

Saiba mais sobre cada função HubL e sua sintaxe.

Adiciona um único item ao final de uma lista.

A função blog_all_posts_url retorna uma URL completa para a página de listagem de todos os posts do blog especificado.

O exemplo abaixo mostra como esta função pode ser usada como um href de âncora.

A função blog_author_url retorna uma URL completa para a página de listagem do autor do blog especificado.

O exemplo abaixo mostra como esta função pode ser usada como um href de âncora. Isso pode ser combinado com blog_authors, como você pode ver nos exemplos que usam essa função.

A função blog_authors retorna uma sequência de objetos de autor de blog para o blog especificado, classificados de forma ascendente por slug. Essa sequência pode ser armazenada em uma variável e ser iterada para criar filtros personalizados para os posts do autor.

O número de posts publicados de cada autor pode ser acessado com author.live_posts.

A primeira linha do exemplo abaixo mostra como a função retorna uma sequência de objetos de autor. O resto do exemplo mostra um caso de uso ao gravar uma sequência em uma variável e depois iterar pelos objetos de autor, imprimindo um conjunto de links de listagem de autores. O exemplo assume que o blog tem quatro autores.

A função blog_by_id retorna um blog por ID. O código de exemplo abaixo mostra como essa função foi usada para gerar um item de lista com hiperlinks.

A função blog_page_link gera a URL de uma exibição paginada da listagem do seu blog. A função assume um parâmetro numérico, que lhe permite gerar links para a página atual, para a próxima página, para a página anterior ou para uma página específica. Esta função é geralmente usada no atributo href das tags de ancoragem de paginação e deve ser usada no modelo de listagem do seu blog.

Os exemplos abaixo mostram como esta função pode ser usada como uma âncora href. O primeiro exemplo renderiza a página atual. O segundo exemplo assume o parâmetro número sete para especificar a sétima página. O terceiro exemplo usa a variável next_page_num para gerar um link relativo ao número da página atual (você também pode usar a variável last_page_num para a página anterior). O último exemplo usa a variável current_page_num e o operador + para criar um link quatro vezes maior do que a página atual.

A função transforma um número definido de posts populares em uma sequência. Esta sequência pode ser salva em uma variável e iterada em loop, criando uma listagem personalizada de seus posts mais populares.

Os resultados dessa função são armazenados em cache por seis horas. Para recuperar os posts de blog usando o HubL a fim de evitar o cache, use blog_recent_tag_posts.

No código de exemplo abaixo, a primeira linha mostra como a função retorna uma sequência. A sequência é salva como uma variável que é usada em um loop for. Quaisquer variáveis de post de blog devem usar o nome do item de loop individual em vez de content.. No exemplo, é utilizado pop_post.name. Esta técnica pode ser usada em modelos de blog e páginas do site.

A função blog_post_archive_url retorna o URL completo da página de listagem do arquivo para os valores de data no blog especificado. Esta função tem dois parâmetros obrigatórios e dois parâmetros opcionais. O primeiro parâmetro é a ID do blog, ou simplesmente a palavra-chave "default". O segundo é o ano dos posts arquivados que você gostaria de exibir.

Os parâmetros opcionais incluem o mês e o dia dos posts arquivados que você gostaria de exibir, respectivamente.

O exemplo abaixo mostra como esta função pode ser usada como um href de âncora.

A função blog_recent_author_posts retorna uma sequência de objetos de post de blog para o autor especificado, classificados do mais recente para o menos recente. Esta sequência de posts pode ser gravada em uma variável e iterada em um loop, criando uma listagem personalizada de posts de um determinado autor.

A função tem três parâmetros. O primeiro parâmetro especifica o blog do qual coletar os posts de um autor. O valor deve ser "default" ou o ID de um determinado blog (disponível na URL do painel do blog). O segundo parâmetro especifica o autor que deve ser utilizado. Este parâmetro pode usar a função content.blog_post_author.slug para usar o autor do post atual, ou aceita um nome em letras minúsculas separado por hifens, como "brian-halligan". O terceiro parâmetro especifica a quantidade de posts que devem ser recuperados.

A primeira linha do exemplo abaixo demonstra como a função retorna uma sequência de posts de um autor. Neste exemplo, em vez de especificar exatamente o nome do autor, é usado o autor do post atual. A sequência é salva em uma variável e é exectada em loop. Quaisquer variáveis de post de blog devem usar o nome do item de loop individual em vez de content.. No exemplo, é utilizado author_post.name. Esta técnica pode ser usada em modelos de blog e página.

A função blog_recent_posts retorna uma sequência de objetos de post de blog para o blog especificado, classificados do mais recente para o menos recente. Esta sequência de posts pode ser gravada em uma variável e iterada em loop, criando uma listagem personalizada de seus posts mais populares.

A função assume dois parâmetros. O primeiro parâmetro especifica de qual blog coletar posts populares. O valor deve ser "default" ou o ID de um determinado blog (disponível na URL do painel do blog). O segundo parâmetro especifica a quantidade de posts que devem ser recuperados.

A primeira linha do exemplo abaixo demonstra como a função retorna uma sequência. A sequência é salva em uma variável e é exectada em loop. Quaisquer variáveis de post de blog devem usar o nome do item de loop individual em vez de content.. No exemplo, é utilizado rec_post.name. Esta técnica pode ser usada não só em modelos de blogs como também em páginas regulares.

A função blog_recent_tag_postsretorna uma sequência de objetos de post de blog para a tag ou as tags especificadas, classificados do mais recente para o menos recente. Esta sequência de posts pode ser gravada em uma variável e iterada em um loop, criando uma listagem personalizada de posts de uma determinada tag ou tags.

No exemplo de código abaixo:

Saiba mais sobre como criar uma lista de posts de blog relacionados.

A função blog_tag_url retorna uma URL completa para a página de listagem da tag do blog especificado.

Esta função aceita dois parâmetros. O primeiro parâmetro especifica o blog em que a página de listagem da tag existe. O segundo parâmetro especifica a tag a ser vinculada. Este parâmetro pode usar a função topic.slug para uma determinada tag de content.topic_list ou aceita um nome separado por hifens em letras minúsculas, como "marketing-tips".

O exemplo abaixo mostra como esta função pode ser usada como um href âncora.

A função blog_tags retorna uma sequência das 250 tags mais blogadas (com base no número de posts associados ao blog) para o blog especificado, classificadas por contagem de posts do blog. Esta sequência pode ser armazenada em uma variável e iterada para criar filtros de post com tags personalizadas. O número de posts para cada tag pode ser acessado com tag.live_posts.

Esta função aceita dois parâmetros. O primeiro parâmetro especifica o blog no qual buscar as tags. O segundo parâmetro estabelece um limite para o número de tags buscadas.

A primeira linha do exemplo abaixo demonstra como a função retorna uma sequência de objetos de tag. O resto do exemplo demonstra um caso de uso ao gravar uma sequência em uma variável e depois iterar pelos objetos de tag, imprimindo um conjunto de links de tag. O exemplo assume que o blog tem quatro tags.

Esta função retorna o número total de posts publicados no blog especificado. Se nenhum parâmetro for especificado, ele contará seus posts padrão no blog. Como alternativa, você pode especificar "default" ou o ID de um blog diferente para fazer a contagem. O ID do blog está disponível na URL do painel de um determinado blog.

Remove todos os itens de uma lista. Ao contrário depop(), não retorna nada.

Essa função valida o contraste de cores com base nas normas WCAG. Você precisará incluir duas cores como argumentos e poderá incluir um argumento opcional para especificar a classificação (AA ou AAA). Retorna true ou false com base em se as cores atendem/excedem o padrão.

Esta função clareia ou escurece um valor hexadecimal ou uma variável de cor por uma quantidade definida. O primeiro parâmetro é a cor hexadecimal (por exemplo ("#FFDDFF") ou uma variável que armazena um valor hexadecimal. O segundo parâmetro é a quantidade pela qual ajustar, de zero a 255. Esta função pode ser usada em arquivos CSS para criar uma variação de cor. Outro bom caso de uso é utilizá-lo com um parâmetro de cor de um módulo de cor para permitir aos usuários especificar uma cor primária que gera automaticamente uma variação de cor.

No exemplo abaixo, a cor hexadecimal #3A539B é armazenada em uma variável chamada base_color. A cor é modificada por -80, resultando em um azul mais escuro (#00034B).

A função content_by_id retorna uma landing page, uma página do site ou um post de blog por ID. O único parâmetro aceito por essa função é um ID de conteúdo numérico.

O código de exemplo abaixo mostra como essa função foi usada para gerar um item de lista com hiperlinks.

Dada uma lista de IDs de conteúdo, retorna um dicionário de landing pages, páginas do site ou posts de blog que correspondem a esses IDs.

Essa função exige um parâmetro, uma lista de IDs de páginas ou de posts de blog para procurar, colocado dentro de uma matriz. Até 100 objetos de conteúdo podem ser passados. O código de exemplo abaixo mostra como essa função foi usada para gerar um item de lista com hiperlinks.

Retorna uma cópia superficial da lista. Equivalente a a[:].

Uma cópia superficial cria um novo objeto composto e (na medida do possível) insere nele referências aos objetos encontrados no original.

Retorna o número de vezes que uma variável existe em uma lista.

Retorna uma lista de registros do CRM associados a outro registro por seu ID, categoria de associação e ID de definição de associação.

Esta função retorna um objeto com os seguintes atributos: has_more, total, offset e results.

Obtém um único registro de CRM por consulta ou por ID. Os registros são retornados como um dicionário de propriedades e valores.

Esta função também pode ser usada com objetos personalizados e integradores.

Obtém uma lista de registros para um tipo de objeto específico do HubSpot CRM.

Esta função retorna um objeto com os seguintes atributos: has_more, total, offset e results.

Os resultados podem ser classificados usando pelo menos um parâmetro de classificação na consulta. Por exemplo,crm_objects("contact", "firstname=Bob&order=lastname&order=createdate") classificará os contatos com nome "Bob" por sobrenome e depois por createdate. Para reverter a ordem de classificação, inicie o nome da propriedade com -, como em order=-createdate. A função de objetos do CRM também pode ser usada com objetos personalizados e integradores.

Obtém a definição de propriedade para um determinado tipo de objeto e nome de propriedade.

Os tipos de objetos suportados são objetos padrão do HubSpot (por exemplo, contatos), objetos específicos do portal e objetos integradores.

Obtém as definições das propriedades para um determinado tipo de objeto e conjunto de nomes de propriedades.

Os tipos de objetos suportados são objetos padrão do HubSpot (por exemplo, contatos), objetos específicos do portal e objetos integradores.

Como os módulos de CTA têm vários parâmetros que contêm variações de seu código, você pode usar a função CTA para gerar facilmente uma determinada CTA em um modelo, página ou e-mail. Esta função é o que o editor de rich text usa quando você adiciona uma CTA por meio dele.

Estenda uma lista anexando todos os itens de um iterável. Em outras palavras, insira todos os itens de uma lista em outra lista.

Esta função retorna os metadados de um arquivo por ID. Ela aceita um parâmetro, a identificação numérica do arquivo que deve ser procurado. Para recuperar vários arquivos ao mesmo tempo, use a função files_by_ids.

Retorna os metadados de vários arquivos por ID. Aceita uma matriz de IDs de arquivo.

Por exemplo, você pode usar essa função para percorrer os arquivos carregados de um contato. Para percorrer os resultados, você precisará usar o filtro de HubL dividido, pois a propriedade do CRM será retornada como uma string separada por ponto e vírgula.

Quando um post de blog é configurado para acesso com autorregistro, os visitantes terão que se registrar ou iniciar sessão para ver o conteúdo completo do post. Os recursos de listagem de blog padrão da HubSpot incluem automaticamente essa funcionalidade e também incluirão um ícone de cadeado para posts que exigem autorregistro. Saiba mais sobre como criar soluções personalizadas usando esta função e a API correspondente.

Essa função verifica se um post de blog pode ser acessado pelo visitante atual. Quando chamada, a função é substituída pelo seguinte atributo:

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.

Retorna os links da conta de mídia social definidos nas configurações de conta. Usado no módulo follow_me padrão.

Formata um endereço com base na localidade do contexto.

Formata o nome de uma empresa, adicionando honoríficos japoneses quando apropriado.

Formata o nome de uma pessoa colocando o sobrenome antes do primeiro nome e adiciona honoríficos japoneses, quando apropriado

Formata os componentes de data e hora de um objeto de data, semelhante ao filtro de HubL format_datetime. Esta função substitui a função datetimeformat descontinuada.

Esta função contém quatro parâmetros e calcula a distância elipsoidal 2D entre dois pontos na Terra. Use esta função como uma consulta de filtro para obter dados do HubDB.

Essa função retorna a URL pública de um modelo ou arquivo de código especificado. O parâmetro desta função é o caminho do ativo no gerenciador de design. URLs de arquivo codificadas são atualizadas sempre que você as publica; portanto, usando essa função, você garante que está sempre usando a última versão do arquivo.

Você pode gerar automaticamente essa função no aplicativo clicando com o botão direito do mouse em um arquivo e selecionando Copiar URL público, ou clicando em Ações e selecionando Copiar URL público.

O exemplo abaixo obtém a URL de um arquivo Javascript criado no Gerenciador de design que pode ser incluído como src de uma tag <script>.

Esta função funciona como get_public_template_url, retornando a URL pública de um modelo ou arquivo de código especificado. A única diferença é que o parâmetro dessa função é o ID do modelo (disponível na URL do modelo ou arquivo codificado), em vez do caminho do gerenciador de design.

O HubDB é um recurso disponível no Content Hub Professional e Enterprise.

A função hubdb_table pode ser usada para ter as informações em uma tabela, incluindo nome, colunas, última atualização etc.

As seguintes informações podem ser obtidas ao chamar os atributos apropriados:

O HubDB é um recurso disponível no Content Hub Professional e Enterprise.

A função hubdb_table_column pode ser usada para ter as informações de uma coluna em uma tabela, como rótulo, tipo e opções. Esta função aceita dois parâmetros.

Estas informações sobre a coluna podem ser obtidas chamando os atributos apropriados:

Além dos atributos acima, há também um método que pode ser chamado**: getOptionByName("<option name>")** em que para colunas do tipo "select", isso obterá informações de opção pelo nome da opção.

O HubDB é um recurso disponível no Content Hub Professional e Enterprise.

A função hubdb_table_row pode ser usada para obter uma linha de uma tabela do HubDB. A partir desta linha, você pode obter as informações de cada célula da tabela, chamando o atributo correspondente:

HubDB é um recurso disponível em Content Hub_ Professional e Enterprise.

A função hubdb_table_rows pode ser usada para listar as linhas de uma tabela do HubDB e ser iterada. Uma única chamada de hubdb_table_rows() é limitada a 10 verificações de tabela por página.

Por padrão, essa função retornará um máximo de 1.000 linhas. Para recuperar mais linhas, especifique um limit na consulta, conforme mostrado no código abaixo.

Essa função gera uma tag de link que faz referência ao Arquivo principal do CSS (default_custom_style.min.css). Esse arquivo foi projetado para ser um arquivo CSS global que pode ser adicionado a todos os modelos. Para renderizar, a função requer um valor de parâmetro booleano de True.

Retorna a localização do primeiro item correspondente em uma arrayde base zero.

Esta função aceita três parâmetros, o primeiro é obrigatório. O primeiro parâmetro é o item que você está tentando encontrar na array. O segundo (start) e o terceiro (end) permitem encontrar esse item em uma parte do array.

Coloca um elemento em uma lista no índice específico fornecido.

Esta função aceita dois parâmetros:

Retorna uma representação em string legível por humanos de um código de idioma, opcionalmente traduzido para um idioma de destino.

Carrega as traduções de um determinado caminho de pasta _locales e retorna um mapa dos valores.

Saiba mais sobre como incluir traduções de campos em módulos e temas personalizados.

Retorna a estrutura de links aninhados de um menu avançado. Os nós de menu têm uma variedade de propriedades que podem ser usadas nos objetos que são retornados. Se você passar null para a função de menu, ele retornará uma lista vazia. Você também pode especificar um menu por nome. Na maioria dos casos, é mais seguro usar o ID do menu, pois renomear um menu não afeta o ID. Ao construir para o marketplace, faz sentido usar "default" como padrão se o menu for null.

Obtém a URL de um ativo anexado a um módulo personalizado por meio de Arquivos vinculados > Outros arquivos.

Cria um objeto de namespace que pode conter atributos arbitrários. Ele pode ser inicializado de um dicionário ou com argumentos de palavras-chave.

Retorna o dicionário de dados OEmbed para uma determinada solicitação. Somente funciona em e-mails.