Roteiro
• Documentação no Codex
• As paginas do template
• Trabalhando com tags
• Loop
Objetivo
• Conhecer as principais características de desenvolvimento ou customização de um template com wordpress
Documentação no Codex
• O codex é um manual no formato de wiki.
• Permite acesso a todas as funções do wordpress
http://codex.wordpress.org/
AS PAGINAS DO TEMPLATE
Principais arquivos
• Abaixo a lista dos principais arquivos de um template, nem todos são obrigatórios:
– index.php
– header.php
– footer.php
– single.php
– page.php
– search.php
– category.php
– sidebar.php
Index.php
• É o arquivo home da página.
• Caso não exista um template especifico para a pagina acessada ele voltará sempre para home.
Header.php
• É o arquivo responsável por encapsular o cabeçalho das paginas do wordpress.
• Informações como titulo, ou qualquer outro meta dados deverão ser incluídos neste arquivo.
• Geralmente, tem o menu do site.
Footer.php
• É o rodapé da página.
• Este arquivo será utilizado em todo o site.
Single.php
• Arquivo utilizado para a exibição de um único post.
Page.php
• É responsável por renderizar cada pagina existente no wordpress.
• Caso necessário, uma pagina pode ter seu template especifico (page-n.php)
Search.php
• Código responsável pela busca no site.
Category.php
• Pagina que lista as categorias do site.
• Pode existir paginas customizadas para cada categoria.
Sidebar.php
• Área da barra de plug-ins.
• Em um site pode existir múltiplas áreas de plug-ins.
TRABALHANDO COM TAGS
Incluindo tags
• Uma lista das tags existentes:
– get_header()
– get_footer()
– get_sidebar()
– get_template_part()
get_header()
• Responsável o cabeçalho.
• Chamará o arquivo header.php
• Seu uso facilita a reutilização e a organização de seu código
Get_footer()
• Chamará o footer.php
• Responsável por desenhar o rodapé de uma página.
Get_sidebar()
• Responsável por desenhar a sidebar.
• Pode passar parâmetros para obter a site bar especifica desejada.
• Auxilia na modularidade e reutilização
Get_template_part()
• Chama qualquer pagina que se queria incluir em um template;
• A pagina deve ser passada por parâmetro, assim como seu complemento.
• Muito útil para modularização e organização do código.
Tags condicionais
• Algumas tags podem lhe ajudar a fazer um tratamento especial em alguns casos, como por exemplo: quando não for encontrada uma pagina o wordpress redirecionará para o index com a flag is_404 ativa. Isto lhe permite tratar este erro e aplicar uma mensagem apropriada.
• Vejamos algumas tags condicionais.
• Existem diversas tags condicionais, das mais utilizadas são na criação de templates:
– is_home()
– is_category()
– is_single()
– is_page()
– has_tag()
– is_404()
Is_home()
• Permite ao desenvolvedor saber se o conteúdo esta sendo exibido na home
Is_category()
• Permite saber se o conteúdo exibido é de uma categoria específica.
• Por exemplo, textos de esportes podem ter um fundo diferente.
Is_single()
• Permite saber se o texto exibido veio de um post.
• Também permite saber se o post é um post especifico, ou seja, utilizando o id como comparação podemos saber se o post exibido é o post que desejamos.
Is_page()
• Permite ao desenvolvedor saber se a página é uma página especifica.
Has_tag()
• Permite ao desenvolvedor saber se o conteúdo exibido tem a ele uma tag em especial aplicada.
• Podemos mudar as características visuais de acordo com as tags. Por exemplo, um noticia com a tag “bombástica”, pode ter uma borda vermelha para destaca-la.
Is_404()
• Permite saber se a requisição foi encaminhada a partir de um erro 404.
LOOP
O loop
• Loop básico:
As funções associadas ao loop
• Aqui estão algumas das funções utilizadas dentro do loop para aquisição dos dados.
• Para mais informações sobre funções, consulte o codex.
• Abaixo a lista:– the_permalink();
– the_contente();
– the_excerpt()
– the_ID();
– is_stick();
The_permalink()
• Obtém o link permanente do post
The_content()
• Obtém o conteúdo do post.
The_excerpt()
• Exibe o conteúdo do conteúdo (tira algumas formatações)
The_ID()
• Exibe o id do conteúdo
Is_stick()
• Verifica se o post tem a característica de stick.
• Stick são post marcados na hora da publicação para serem exibidos na primeira página.
Conclusão
• Baseado em pequenas funções (ou tags) podemos ter grande capacidade de criação. Seja alterando templates ou criando nossos próprios, o wordpress é uma ferramenta que permite ao desenvolvedor uma grande liberdade de trabalho