Modelos de Temas: Tag.php
Este modelo de temas é conhecido como tag.php, e como o nome já nos diz, é um modelo de template do próprio WordPress, que é usado no seu tema para carregar e exibir as postagens relacionadas a uma tag específica em seu site.
Como você já deve saber, dentro do painel administrativo do WordPress, é possível adicionar tags em cada uma de suas postagens.
Para testar essa funcionalidade, acesse o painel administrativo do WordPress e entre em quaisquer uma de suas postagens publicadas.
No menu direito, você verá uma aba chamada de Tags, expandido-a você será capaz de adicionar tags a sua postagem, separando-as por vírgulas:
No meu caso, adicionei duas novas tags: micilini-tag e minha-tag. Não se esqueça de clicar no botão [Atualizar] para que suas alterações surtam efeito.
Caso desejar, você pode criar e gerenciar suas tags diretamente no menu de categorias, basta ir em: Posts > Tags.
Feito isso, vamos seguir com a criação deste arquivo 😉
Criando o tag.php
Dentro da pasta raíz do seu tema, você vai precisar criar um arquivo chamado de tag.php:
<?php
/**
* O template para exibir páginas de tags.
*
* @link https://codex.wordpress.org/Template_Hierarchy
*
* @package WPMicilini
* @since 1.0
*/
get_header();
?>
<!-- Insira aqui os códigos para mostrar as tags -->
<?php
get_footer();
?>Como podemos ver, o conteúdo inicial sempre começa com a abertura das tags PHP, onde inserimos algumas informações relevantes sobre o arquivo em formato de comentários, e é claro, importamos o cabeçalho e o rodapé por meio das funções get_header() e get_footer().
No local onde está escrito <!-- Insira aqui os códigos para mostrar as tags -->, é onde faremos a mágica acontecer, inserindo um punhado de código, como estes que estamos vendo abaixo:
<div class="tag-div">
<?php
if (have_posts()) :
?>
<h1><?php single_tag_title(); ?></h1>
<?php while (have_posts()) : the_post(); ?>
<h2><?php the_title(); ?></h2>
<div class="data-content"><?php the_content(); ?></div>
<?php endwhile; ?>
<?php else : ?>
<p>Não existem tags relacionadas.</p>
<?php endif; ?>
</div>No comando acima, começamos definindo uma div que vai encapsular todo o conteúdo que será mostrado dali em diante.
Começamos fazendo a validação com a função have_posts(), para checar se existem postagens a serem mostrada que estão relacionadas com uma tag específica, caso negativo, a execução do código pula para o else, que por sua vez, mostra a mensagem: Não existem tags relacionadas.
Em seguida fazemos o uso de algumas tags condicionais em conjunto com algumas funções do WordPress, são elas:
single_tag_title(): Função usada para exibir o título da tag, em páginas que mostram postagens de uma tag específica. Ela pode receber parâmetros adicionais.
the_title():Função que retorna o título daquela postagem, ela pode receber parâmetros adicionais.
the_content(): Função usada para retornar o conteúdo do POST que está relacionado a aquela tag. Se preferir você pode fazer o uso da função the_excerpt() que só exibe um resumo da postagem.
As explicações do loop já foram debatidas em lições anteriores, caso ainda tenha alguma dúvida basta acessar este link.
Variações da tag.php
O arquivo tag.php também conta com variações que visam atender tipos específicos de categorias de conteúdo, vejamos cada uma delas a seguir:
tag-{slug}.php: Você também pode criar arquivos informando a URL da tag. Por exemplo: tag-micilini-tag.php seria específico para a tag que criamos no início desta lição chamada de micilini-tag.
tag-{id}.php: Este formato permite criar modelos específicos com base no id da tag. Por exemplo, tag-5.php seria específico para a categoria com o id 5.
tag.php: Por fim nós temos o modelo mais genérico da categoria, que já aprendemos nesta lição.
É importante ressaltar que ao usar as variações ditas acima, o WordPress irá automaticamente reconhecer esses modelos específicos ao exibir postagens em tags correspondentes.
Caso não exista tais arquivos, o wordpress seguirá a hierarquia de modo a abrir o arquivo mais genérico que é o tag.php.
E caso ele não exista, o wordpress vai procurar pelos arquivos archive.php até chegar no index.php.
Como acessar a URL das tags?
Normalmente em uma instância do wordpress, você pode acessar as suas tags usando a seguinte URL: /tag/nome-da-tag/.
Conclusão
Nesta lição você aprendeu sobre o modelo de tema tag.php e suas variações.
Até a próxima 😁
