Neste tutorial, vou abordar O Loop e como o WordPress o utiliza para exibir suas postagens e páginas. Lembre-se, este é um tópico um pouco mais avançado do que nossos tutoriais anteriores. Espero que você ache este guia definitivo mais fácil de entender do que o que está disponível na documentação do WordPress. Veja o que abordaremos:
- Uma definição de O Loop.
- Fluxo básico do Loop.
- Tags de modelo usadas em O Loop
- O que fazer depois de O Loop
- Hierarquia de arquivos de modelo
Se você quiser entender melhor como um tema do WordPress realmente funciona nos bastidores, continue lendo.
Nota: Este tutorial assume que você está usando um tema padrão do WordPress, como o tema Kubrick padrão. Nada de coisas avançadas com múltiplos loops... ainda.
O que é o Loop?
Você provavelmente ainda está se perguntando o que é o Loop. Basicamente, é o que exibe o conteúdo que você vê em sua página inicial, suas postagens individuais, páginas, arquivos, resultados de pesquisa e muito mais.
Se um usuário acessa sua página inicial, arquivos ou resultados de pesquisa – por padrão, o Loop irá exibir um certo número de posts conforme definido em suas Opções de Leitura.
No momento, minha página inicial exibe 10 posts por página, que é o que defini em Mostrar no máximo * posts. Em posts e páginas individuais – o mesmo código básico do Loop exibirá apenas aquela página específica.
Fluxo básico do loop
Vamos dividir o Loop em 3 partes.
<?php if (have_posts()) : ?><br>
<?php while (have_posts()) : the_post(); ?>
1. O que você quer que seja exibido no Loop
2. O que é exibido quando o Loop termina
3. Se não houver nada para exibir
Se houver posts disponíveis na consulta, ele começará a exibi-los em um loop while, o que é definido na parte 1. Quando o while terminar, ele exibirá o que está na parte 2. Se nenhum post for encontrado, ou houver algum outro erro 404, a parte 3 será exibida.
Tags de Modelo usadas dentro do Loop
A menos que você queira que 1. O que você quer exibido no Loop seja repetido na página inicial do seu blog WordPress 10 vezes, você provavelmente deveria aprender algumas das tags de modelo básicas. Vamos dar uma olhada no código do index.php no modelo padrão do WordPress.
Como você pode ver, existem várias tags de modelo dentro do Loop que exibirão coisas como o título do post, o permalink, o conteúdo, etc. Vou detalhar cada uma das tags de modelo no tema padrão do WordPress.
- <?php the_permalink() ?> – Isso exibirá o link permanente do post, ou seja, http://www.themelab.com/?p=1
- <?php the_title(); ?> – Isso exibe o título do post, ou seja, Olá Mundo!
- <?php the_time(‘F jS, Y’) ?> – Isso exibirá a data, ou seja, 4 de abril de 2008. Uma lista completa de maneiras de formatar a data pode ser encontrada em php.net
- <?php the_author() ?> – Isso exibirá o nome do autor, ou seja, Leland. Isso está comentado no tema padrão.
- <?php the_tags(‘Tags: ‘, ‘, ‘, ‘<br />’); ?> – Isso exibirá as tags atribuídas à postagem, separadas por vírgulas e seguidas por uma quebra de linha
- <?php the_category(‘, ‘) ?> – Isso exibirá as categorias de forma semelhante às tags acima.
- <?php edit_post_link(‘Editar’, ”, ‘ | ‘); ?> – O link de edição da postagem ficará visível apenas para aqueles com permissão.
- <?php comments_popup_link(‘Sem Comentários »’, ‘1 Comentário »’, ‘% Comentários »’); ?> – Exibirá o link para os comentários. Isso não será exibido em postagens ou páginas individuais.
Existem muitos outros listados na página Tags de Modelo no WordPress.org. Algumas delas podem funcionar no Loop, enquanto outras podem não funcionar.
Após o Loop
Vamos dar uma olhada no código após o loop parar de iterar no tema padrão.
Como você deve ter adivinhado, isso exibirá a paginação que você vê na página inicial, arquivos e resultados de pesquisa. Estes não serão exibidos em posts e páginas individuais. Claro, você poderia substituir isso por algo como PageNavi, mas isso depende de você.
Se não houver postagens para exibir (possivelmente devido a um erro 404), o seguinte será exibido após o else
Desculpe, mas você está procurando algo que não está aqui.Não Encontrado
Isso exibirá a mensagem Não encontrado junto com o formulário de pesquisa. Neste caso, haveria um código de formulário de pesquisa localizado em um arquivo chamado searchform.php no diretório do tema, o que existe no tema padrão.
Hierarquia de Templates
Alguns arquivos de template terão prioridade sobre o index.php para certos tipos de páginas, se estiverem presentes no diretório do tema. Listados abaixo estão alguns exemplos de hierarquia de templates, listados em ordem de prioridade.
Página Inicial
- home.php
- index.php
Post Individual
- single.php
- index.php
Resultados da Pesquisa
- search.php
- index.php
Página 404
- 404.php
- index.php
Existem algumas técnicas mais avançadas listadas na página Hierarquia de Modelos no WordPress.org.
Então, qual é o ponto da hierarquia de templates? Basicamente, você pode usá-la para criar novos layouts para diferentes tipos de páginas do WordPress sem mexer muito no seu arquivo index.php.
Conclusão
Então, agora você (esperançosamente) tem uma melhor compreensão do que é o Loop do WordPress. Sinta-se à vontade para deixar um comentário se gostou, odiou, não entendeu, o que for – recebo todos os feedbacks. Assine o feed para todas as últimas atualizações sobre lançamentos de temas do Theme Lab e novos tutoriais. Obrigado pela leitura.
[…] assine nosso feed! Você também pode receber atualizações deste blog por e-mail. Todos nós sabemos o que é o Loop do WordPress, certo? Se não, existem muitos ótimos tutoriais na web que explicam o WordPress […]
Guia muito útil, vou tentar imediatamente.
@Fernando: Obrigado por me avisar…
É um guia muito bom e eu o traduzi para o espanhol aqui para compartilhá-lo com pessoas que não falam inglês 🙂
Obrigado 😉
[…] O Guia Definitivo do Loop do WordPress: O Loop é bastante desafiador. Este link irá ajudá-lo com isso. […]
[…] Uma ótima área para começar é aprender como o loop do WordPress funciona. Esta é uma função básica de blog usada para exibir o número X mais recente de posts na página inicial do seu blog (para blogs tradicionais). Em vez de entrar em muitos detalhes aqui, gostaria de indicar um novo post do Themelab que foi projetado para ser o Guia Definitivo do loop do WordPress. […]
[…] dois artigos recentes que achei úteis são: O Guia Definitivo do Loop do WordPress e outro chamado Variáveis Globais e o WordPress […]
@RSS Filter: Isso é possível… mas vou deixar isso para um tutorial futuro.
[…] ensinar tudo o que você precisa saber sobre o Loop do WordPress. O que é, como usá-lo e mais. leia mais | história do digg Compartilhe e Aproveite: Estes ícones levam a sites de marcação social onde os leitores podem […]
Então, como você diria ao loop para exibir apenas o último post em uma página inicial estática ou arquivo de índice?
Guia incrível sobre um aspecto importante do desenvolvimento de temas do Wordpress. Obrigado!
[…] O Guia Definitivo para o Loop do WordPress […]
[…] O Guia Definitivo do Loop do WordPress (tags: wordpress) […]
[…] propaganda press em 6 de abril de 2008 ok, muito parecido com combolombo, acabamos de descobrir um novo site com um artigo incrível sobre o loop do wordpress. você definitivamente quer ler e marcar este. Marcado com: wordpress « African […]
[…] Guia definitivo do Loop do WordPress… Obtenha os detalhes de todos os globais e o que […]
[…] O Guia Definitivo do Loop do WordPress | Theme Lab (tags: wordpress howto php guide programming theme blog) […]
[…] Guia do loop do WordPress […]
[…] O Guia Definitivo do Loop do WordPress – Theme Lab […]
[…] O Guia Definitivo do Loop do WordPress (tags: loop wordpress) […]
Cara, isso é um achado. Eu poderia ter usado isso seriamente quando estava tentando descobrir alguns ajustes de plugin.
Eles continuavam dizendo: “coloque este código fora do loop”
E agora eu sei o que diabos é um loop 🙂
[…] é um guia para o Loop do WordPress. Especialmente útil para criadores de temas WordPress iniciantes e desenvolvedores WordPress. Compartilhe e […]
E aí Leland, off-topic, mas parabéns pelo seu aumento de inscritos!
– Sean Pollock
guia muito útil.. obrigado!
[…] O Guia Definitivo do Loop do WordPress – Este site realmente detalha o Loop para você entender. […]
[…] WordPress. Vá em frente, assine nosso feed! Você também pode receber atualizações deste blog por e-mail. O Guia Definitivo do Loop do WordPress: Ah, o famoso loop do WordPress que executa tudo. Ronald fez um ótimo trabalho em identificar […]