Guia de referência de variáveis

Lista de variáveis do HyperFluxCMS

Veja a listagem das Variáveis do HyperFluxCMS que você pode utilizar no código das páginas.

Tipos de Variáveis

O HyperFluxCMS permito o uso de dois tipos de variáveis nos templates e conteúdos das páginas. As variáveis de Tempo de Compilaçao (Compile-time) e as variáveis de Tempo de Execução (Runtime)

Variáveis Compile-time

Variáveis de tempo de compilação, compile-time, são avaliadas e substituídas pelo respectivo valor no momento em que a postagem é criada ou editada.

Podem ser usadas, por exemplo, para inserir no meio do texto o título da própria página, ou a data da última atualização.

Uma variável Compile-time é indicada usando o símbolo de "@" seguido de "C" ou "c" (de Compile-time), depois ":" e em seguida o nome da variável, tudo isso sem espaços nem quebra de linha.

Por exemplo, @c:page.title é substituído pelo título da página.

Lista de variáveis Compile-Time

Variáveis Runtime

Variáveis de tempo de execução, Runtime, são avaliadas e substituídas pelo repectivo valor no momento em que a postagem é acessada pelo visitante do site.

Podem ser usadas, por exemplo, para inserir no meio do texto o nome do site ou o endereço Web original do site.

Uma variável Runtime é indicada usando o símbolo de "@" seguido de "R" ou "r" (de Runtime), depois ":" e em seguida o nome da variável, tudo isso sem espaços nem quebra de linha.

Por exemplo, @r:site.name é substituído pelo Nome do Site, conforme estiver configurado nas opções de Configurações do Site.

Lista de variáveis Runtime

Dados do autor

Há uma certa sobreposição entre page.authorname e author.name. Pode parecer que fazem a mesma coisa. Mas há uma sutil diferença.

A variável page.authorname é avaliada em Tempo de Compilação. Se quando a postagem foi postada ou atualizada, o nome do author era John Doe, as referências à variável @c:page.authorname são todas substituídas por "John Doe" no momento em que a postagem é salva, e o código é gravado assim até que ela eventualmente seja atualizada novamente. Se o autor atualizar seu nome para "John Smith Doe", as postagens que já tinham sido salvas com "John Doe" não são automaticamente atualizadas.

A variável author.name é avaliada em Tempo de Execução. A pçostagem é salva não com o valor da variável no momento, mas com uma marcação indicando ao HyperFluxCMS para buscar e enviar a informação atualizada sempre que a postagem for acessada. Se a postagem foi salva quando o usuário se chamava John Doe, mas quando ela foi acessada o usuário já tinha atualizado seu nome para "John Smith Doe", a página que será exibida ao visitante já terá o dado atualizado.

A desvantagem de usar a segunda forma é que isso implica um overhead um pouco maior. Ou seja, exige um pouco mais de processamento e memória do servidor onde seu site está hospedado. Mas para a imensa maioria dos sites, a diferença é imperceptível, mesmo com milhares de acessos diários.

O mesmo se aplica às variáveis page.authorusername (Compile-time) e author.username (Runtime)