Template Tag

Template Tag WordPress são funções PHP nativas usadas em arquivos de tema para gerar conteúdo dinâmico — título do post, conteúdo, autor, data, link permanente, informações do site. Em vez de você escrever HTML estático ou consultar o banco de dados manualmente, o WordPress oferece dezenas dessas funções prontas, com nomes auto-explicativos como the_title(), the_content() e bloginfo(). É a base de qualquer tema clássico WordPress.

O que é uma Template Tag

Template tag é o nome dado pela documentação oficial do WordPress às funções PHP que produzem ou retornam dados específicos do contexto atual da página. Quando você está dentro do Loop, uma chamada a the_title() retorna o título do post atual; uma chamada a the_content() retorna o conteúdo formatado.

O conceito apareceu desde as primeiras versões do WordPress, no início dos anos 2000, e segue como pilar dos chamados temas clássicos (PHP-based themes). Mesmo após a chegada dos block themes (FSE), a maior parte dos temas em produção no Brasil ainda usa template tags — é a forma de programar tema com a qual milhões de desenvolvedores estão familiarizados.

Tecnicamente, são funções globais PHP que dependem do contexto carregado pelo WordPress antes da renderização. A função sabe qual é o post atual porque o WordPress popula uma variável global ($post) durante a query. As template tags consultam essa variável e retornam ou imprimem o dado correto.

Existem dois tipos quando você olha pelo nome: tags que começam com the_ imprimem direto na tela (echo embutido), e tags que começam com get_ retornam o valor para você manipular antes de imprimir. the_title() imprime; get_the_title() retorna. Saber dessa diferença evita bug clássico de iniciante.

Template Tags mais usadas

As template tags mais comuns em qualquer tema são poucas. the_title() e the_content() dominam — aparecem em praticamente todo template de single post e página. the_permalink() gera o link da página atual. the_excerpt() retorna o resumo. the_date() mostra a data de publicação.

Para informações do autor, the_author() e the_author_meta() entregam dados do escritor. the_post_thumbnail() renderiza a imagem destacada do post. the_category() e the_tags() imprimem categorias e tags do post. comments_template() carrega o template de comentários no formato correto.

Fora do Loop, tags do site inteiro são igualmente importantes. bloginfo() retorna informações configuradas em Configurações Gerais — nome do site (bloginfo(‘name’)), descrição (bloginfo(‘description’)), URL principal (bloginfo(‘url’)). É o que alimenta o cabeçalho e o rodapé de qualquer tema.

Tags de menu e widgets também são template tags. wp_nav_menu() renderiza um menu cadastrado em Aparência → Menus. dynamic_sidebar() renderiza uma área de widgets. get_sidebar(), get_header() e get_footer() incluem outros arquivos de template do tema. São tags que estruturam a página inteira, não apenas o conteúdo.

Como usar Template Tags em temas

O uso é direto: dentro de um arquivo .php do tema, abre PHP, chama a função, fecha PHP. Por exemplo, em single.php para mostrar o título do post: <h1><?php the_title(); ?></h1>. O WordPress executa a função durante a renderização da página e o título aparece no HTML final.

Template tags do tipo the_ aceitam parâmetros para personalizar o output. the_title(‘<h2>’, ‘</h2>’) envolve o título em uma h2 automaticamente. the_excerpt() aceita filtros via apply_filters para mudar tamanho do resumo. Cada tag tem documentação própria no Codex e no Developer Resources do WordPress.

Tags get_ são usadas quando você precisa do valor antes de imprimir — para concatenar com outra string, comparar, transformar. $titulo = get_the_title(); echo strtoupper($titulo); imprime o título em caixa alta. É padrão em customizações onde você precisa controlar a saída antes de mostrar para o usuário.

Conditional tags são variações que retornam booleano para controlar o que renderizar. is_single(), is_page(), is_home(), is_archive() indicam o tipo de página atual. Combinadas com if/else, permitem que um único template carregue lógica diferente conforme o contexto. É o padrão em arquivos como sidebar.php que mudam de comportamento entre página inicial e single post.

Template Tags vs Block Templates

Block Templates é o modelo introduzido pelo Full Site Editing (FSE) a partir do WordPress 5.9. Em vez de arquivos PHP com template tags, os temas modernos usam arquivos HTML com markup de blocos Gutenberg. O título não vem mais via the_title(), mas via um bloco core/post-title que renderiza o mesmo dado de forma declarativa.

Para o usuário final, a diferença é gigante. Em tema clássico, mudar a estrutura do header exige editar header.php no código. Em tema FSE, o cliente arrasta blocos no editor visual e salva. Para o desenvolvedor, é uma reformulação mental: pensar em blocos compostos, não em funções procedurais sequenciais.

Template tags continuam funcionais mesmo em projetos FSE, especialmente em hooks customizados, em código de plugins, em templates específicos que precisam de PHP. Não são deprecadas — apenas deixaram de ser o caminho default para construir temas novos. Em 2025, ambos coexistem em projetos reais.

A escolha entre os dois modelos depende do projeto. Tema customizado complexo, com lógica condicional pesada, ainda fica mais limpo em PHP com template tags. Tema editorial que o cliente vai modificar visualmente é melhor em FSE. Combinar template tags com WP_Query em hybrid themes (parcialmente FSE) é o meio do caminho que muitos times adotaram.

Para projetos que partem de uma base sólida e flexível com suporte completo a customização via PHP e blocos, a FULL Services entrega o Astra PRO licenciado e configurado dentro do painel, com hooks documentados e arquitetura que aceita tanto template tags clássicas quanto blocos modernos sem fricção. É a forma de iniciar projetos WordPress sem precisar montar a estrutura de tema do zero.