Hoje vamos continuar com a parte 5 da série de posts onde mostro o passo-a-passo da criação de um tema pra WordPress.
Se você ainda não está acompanhando, veja as outras partes dessa sequência de artigos:
- Parte 1 - Estrutura inicial do tema
- Parte 2 - HTML5, Funções básicas do WordPress, Feed RSS e Atom
- Parte 3 - Topo e listagem de posts
- Parte 4 - Header, Footer e Sidebar
Página interna do post (single.php)
Eu não sei exatamente por que chamo esse tipo de página de “interna do post” ou “interna da notícia”, mas essa é a página que mostra todo o conteúdo do post em questão.
Segundo a hierarquia de templates do WordPress, ele irá mostrar o template criado nos seguintes arquivos (sempre o primeiro que ele achar):
- single-{post_type}.php - Se o post que está sendo acessado é do post-type “produto”, o WP iria procurar por um single-produto.php
- single.php
- index.php
Então, como nós queremos criar uma single para os posts normais, vamos criar o single.php, já que o index.php está sendo usado pela home do blog.
Podemos começar o single.php copiando todo o index.php, que ele já vai funcionar:
Porém, se for pra deixar ele exatamente igual ao index.php não precisaríamos criar o single.php, é só deixar que o WordPress use o index.php (ultima opção na hierarquia de templates).
Então vamos fazer algumas mudanças..
Listando as categorias e tags de um post
Vamos criar um rodapé no post, dentro dele vamos mostrar a lista das categorias e tags (separadas por vírgulas):
Usamos agora duas novas funções:
- the_category - Lista as categorias de um post
- the_tags - Lista as tags de um post
Tirando a diferença nos parâmetros, ambas funções funcionam de forma bem parecida.
Exibindo o thumbnail principal de um post
Podemos também editar o cabeçalho do post e exibir seu thumbnail com a função the_post_thumbnail( tamanho, atributos ), assim:
Percebam que não usei nenhum dos parâmetros da função, pois quero justamente o tamanho padrão (configurado por dentro do painel de controle) e manter os atributos (alt, title) originais.
Mas agora tem uma pegadinha! Você precisa habilitar os thumbnails (no seu tema) caso queira que seus posts e páginas possam ter uma imagem destacada, no caso o thumbnail que estamos exibindo ali em cima.
Habilitando thumbnails em um tema
Para habilitar os thumbnails é só criar na raiz do seu tema (ou editar se ele já existir) o arquivo functions.php, que é - basicamente - o arquivo central do seu tema, onde você define todo tipo de configuração ligada ao tema:
Usamos a função add_theme_support( feature ) que serve pra habilitar uma feature no seu tema, as features que podem ser habilitadas são:
- post-formats - Formatos diferentes de post, vide: http://codex.wordpress.org/Post_Formats
- post-thumbnails - Thumbnails (imagens destacadas) para posts e páginas
- custom-background - Background customizável (imagem/cor) através do admin
- custom-header - Header customizável (imagem, logo, texto) através do admin
- automatic-feed-links - Links para feeds RSS e ATOM gerados automaticamente no wp_head(), que eu não gosto de usar por alguns motivos
Finalizando
Agora nosso template já tem a estrutura básica (e recomendada) de um template pro WordPress, incluindo a listagem e a página interna do post.
Aceito sugestões sobre o que abordar na próxima parte! :)
Gostou? Então comenta, compartilha e recomenda!
Abraços e até a próxima!