Como Adicionar Suporte a Tags do WordPress ao Seu Tema

Jeff Chandler escreveu uma análise no WPCandy do nosso tema Nature Blog há alguns dias. Uma das coisas que ele disse nesta análise foi o seguinte:

Eu não vejo suporte imediato para tags, mas isso é algo que não seria muito difícil de adicionar. No entanto, acho que as tags deveriam ser uma qualidade padrão nos temas hoje em dia, considerando que é tão simples quanto adicionar essa função ao tema.

Concordo plenamente e, desde essa análise, tenho tentado garantir que todos os futuros lançamentos do Theme Lab tenham suporte a tags, além de trabalhar no suporte a tags em lançamentos de temas anteriores. Neste guia, ensinarei como adicionar suporte a tags aos seus próprios temas que podem não tê-lo. Como Jeff disse, é realmente "tão simples quanto adicionar essa função ao tema".

O que é uma tag?

Ok, se você não sabe o que é uma tag e qual a diferença entre categoria e tag – leia o artigo Categoria versus Tags em Lorelle on WordPress. Não consigo explicar melhor do que isso, então vá até lá se não tiver certeza.

Listar tags no Loop

A função the_tags() é a função usada para exibir tags dentro de o Loop, semelhante às categorias. Vamos "pegar emprestado" um código do meu tema favorito do WordPress de todos os tempos, o Kubrick (o padrão).
<?php the_tags('Tags: ', ', ', '<br />'); ?>
É um pouco difícil ler os argumentos, mas o primeiro argumento é o que é exibido antes (atualmente Tags:, depois o separador de vírgula (entre cada tag) e, em seguida, o que vem depois – a quebra de linha. Como o código antes e depois está incluído na função, não há necessidade de formatação HTML externa – então nada será exibido se você não tiver tags em uma postagem específica. Para cercar suas tags com uma tag de parágrafo em vez disso, você faria isso:

<?php the_tags('<p>Tags: ', ', ', '</p>'); ?>

Você pode colocar este código onde quer que haja um Loop, seja no seu Modelo de Índice Principal (index.php) ou no Modelo de Postagem Única (single.php).

Adicionando uma nuvem de tags na sua barra lateral

A função wp_tag_cloud é o que exibe a nuvem de tags. Aqui está um exemplo básico de uma nuvem de tags exibida em uma barra lateral.
<?php wp_tag_cloud('smallest=8&largest=22'); ?>

smallest e largest são tamanhos de fonte. Colocar o seguinte código na sua barra lateral produzirá algo como isto.

Claro, você pode diminuir o tamanho da fonte no parâmetro maior se achar que é muito grande. Uma lista completa de parâmetros pode ser encontrada na página wp_tag_cloud no Codex.

Exibir tags como categorias na barra lateral

Eu sei que existem alguns haters de nuvem de tags por aí, então se você quiser exibir tags em formato de lista, você pode adicionar alguns parâmetros à função wp_tag_cloud para fazer isso.
<?php wp_tag_cloud('smallest=10&largest=10&format=list&unit=px'); ?>

Isso fará com que as fontes tenham o mesmo tamanho (10px) e sejam formatadas em uma lista.

Conclusão

Se você prefere tags a categorias, ou em conjunto com categorias e seu tema não o suporta – espero que tenha sido fácil de seguir para você. Me diga nos comentários o que você achou. Obrigado novamente a Jeff pela inspiração para este tutorial.