Processo de pré-renderização
O processo de pré-renderização é acionado automaticamente ao realizar as seguintes ações:- Publicar uma edição no modelo de uma página
- Atualizando dados compartilhados, como algumas configurações do site
- Atualizando um módulo incluído em um modelo ou página
Verifique se uma página foi pré-renderizada
Há duas maneiras de verificar se uma página foi pré-renderizada:?hsDebugOnly=true: carregue a página com um parâmetro?hsDebugOnly=truede consulta. Isso incluirá uma indicação se a página pode ser pré-renderizada. Se não puder ser pré-renderizado, uma lista de problemas que impedem a pré-renderização será exibida, juntamente com arquivos específicos e números de linhas de modelo. Se a formatação das informações de depuração for difícil de ler, você pode usar o parâmetro?hsDebug=trueem vez de. Ao inspecionar a página com esse parâmetro de consulta, as mesmas informações de depuração aparecerão em um comentário HTML formatado próximo ao final da página.
X-HS-Prerendered: procure o cabeçalhoX-HS-Prerenderednos cabeçalhos de resposta HTTP da solicitação de página. Este cabeçalho só estará presente se a página for pré-renderizada e incluirá o valor da última vez que a página foi pré-renderizada. Você pode encontrar essas informações inspecionando a página, clicando na guia de rede e observando os cabeçalhos de resposta da solicitação de página.
Recursos incompatíveis
As seguintes variáveis HubL, funções HubL e recursos de conteúdo impedirão que uma página seja pré-renderizada. Esses recursos impedem que a mesma resposta seja exibida para todos os usuários, impedindo assim a exibição de uma página estática pré-renderizada. As páginas que utilizam alguns desses recursos podem ser veiculadas usando pré-renderização parcial.Variáveis HubL incompatíveis
accountcompanycontactlocal_dtownerrequest_contactrequest.cookiesrequest.full_urlrequest.headersrequest.path_and_queryrequest.queryrequest.query_dictrequest.referrerrequest.remote_ip
request variáveis não sejam compatíveis com a pré-renderização, elas geralmente têm Alternativas ao JavaScript que você pode usar para acessar informações semelhantes.
Funções HubL incompatíveis
personalization_token()today()
Funcionalidades incompatíveis
- Páginas que usam testes adaptativos
- Páginas que incluem conteúdo inteligente são suportados via pré-renderização parcial.
Pré-renderização parcial
A pré-renderização parcial permite que a HubSpot veicule páginas parcialmente pré-renderizadas. Por exemplo, uma página pode ser totalmente estática, exceto pelo nome de um contato exibido na página. A página pode ser pré-renderizada, exceto pelo nome do contato. Pouco antes de retornar a página ao usuário, a HubSpot executará uma renderização apenas desses valores dinâmicos. Páginas que usam pré-renderização parcial não podem ser armazenadas em cache no CDN ou no navegador. No entanto, páginas parcialmente pré-renderizadas são mais rápidas de entregar do que páginas que não podem ser parcialmente pré-renderizadas. Páginas parcialmente pré-renderizadas também têm a capacidade de retornar a um estado não personalizado em caso de interrupção ou ataque. Embora a pré-renderização parcial possa ajudar na velocidade e confiabilidade do seu site, remover os recursos do HubL que tornam as páginas não pré-renderizáveis terá um efeito positivo muito maior no desempenho geral da sua página.Verifique se há pré-renderização parcial
Para verificar se uma página pode ser parcialmente pré-renderizada, carregue a página com um parâmetro?hsPrcDebug=true de consulta, e haverá uma saída adicional sobre o conteúdo pré-renderizado para essa página. Se a página for pré-renderizada, o cabeçalho X-HS-Prerendered estará presente e conterá partial antes do momento em que a página foi parcialmente pré-renderizada.
Abaixo está uma lista de variáveis e filtros do HubL que atualmente são suportados com pré-renderização parcial. As páginas que incluem essas variáveis e filtros serão parcialmente pré-renderizadas, e quaisquer expressões que os incluam serão avaliadas no momento da exibição.
Variáveis HubL
accountcompanycontactlocal_dtownerqueryrequestrequest_contactyear
Filtros HubL
|random|shuffle
Alternativas JavaScript para HubL incompatível
Enquanto os várias variáveis HubLrequest não são compatíveis com pré-renderização; essas variáveis geralmente têm alternativas JavaScript que você pode usar para acessar informações semelhantes.
Por exemplo, em vez da variávelrequest.cookies, você pode usar a propriedade de cookie. Abaixo está um exemplo de uso do HubL vs. JavaScript para exibir conteúdo dinamicamente com base na experiência do usuário com o site (com base em seus cookies).
- Método HubL
- Método JS