Se você é um desenvolvedor de temas WordPress, um programador ou apenas um entusiasta geral ansioso para aprender o que é um loop WordPress, este artigo é para você! Sem mais delongas, vamos começar com o básico: O que é um loop?
O loop do WordPress é um código PHP que mostra os posts do WordPress ou simplesmente; ele é usado em vários temas para exibir postagens em qualquer página da web. Não apenas ele é executado na maioria das páginas que você vê, mas também permite modificá-lo e personalizá-lo ao seu gosto.
Esses loops de site podem ser usados para listar postagens por contagem de comentários, mostrar postagens com imagens e assim por diante.
Quando você olha para o loop, pode ver que algumas funções são executadas por padrão para mostrar as postagens. Os desenvolvedores de temas podem usar essas funções e tags de modelo para personalizar como cada postagem no loop é exibida.
Essas tags de modelo funcionam apenas dentro do loop padrão do WordPress e são usadas para formatar, organizar e publicar dados de postagem.
O loop do WordPress é, sem dúvida, a parte mais crucial do código do WordPress, e vamos nos aprofundar em como o seu site faz o loop.
Loop de página do WordPress para iniciantes
Como já mencionamos, o post loop é um código que gera todas as informações que o WordPress tem sobre um post ou posts. Ele é executado em segundo plano em cada post e encontra o banco de dados um por um, o que permite fornecer informações sobre todos os posts encontrados.
Aqui está um exemplo de como o WordPress percorre as postagens:
- você inicia o loop,
- agir com cada postagem ou página encontrada,
- feche o ciclo.
Essas três etapas representam a lógica básica por trás do loop. A partir deste ponto, você pode ser criativo e filtrar as postagens que encontrou usando a consulta. A consulta informa ao loop o que estamos procurando. No nosso exemplo, ficaria assim:
- definir o que estamos procurando,
- iniciar o ciclo,
- agir com cada postagem ou página encontrada,
- feche o ciclo.
Se você tem experiência com código PHP, pode estar familiarizado com a função “while" que é usada em loops para executar a consulta do banco de dados e exibir dinamicamente as informações sem precisar inserir cada linha do banco de dados manualmente.
O loop while do WordPress funciona da mesma maneira.
Exemplo de um loop padrão do WordPress
Abaixo está um exemplo de um loop padrão do WordPress que pode ser usado em qualquer página.
<?php if (have_posts() ): ?> <?php while (have_posts() ): the_post() ?> // Post display here <?php endwhile ?> <?php else: ?> // Content if there are no posts to show <?php endif ?>
Dê uma olhada nas funções have_posts() e the_post(). O primeiro determina se há algum post para mostrar, e o segundo configura dados e pontos internos que auxiliam a função have_posts().
Se não houver nada para mostrar, a função deve exibir uma mensagem informando aos usuários.
Se houver as postagens que estamos procurando, o loop as exibirá uma a uma.
Aqui, tenha um bloco de código que realmente mostrará as postagens, é por nossa conta!
`<?php if (have_posts() ): ?>
<?php while (have_posts() ): the_post() ?>
<div <?php post_class() ?>>
<a href=”>
<div class=’post-excerpt’>
<?php the_excerpt() ?>
<div class=’post-meta’>
<?php the_time( ‘Ym-d’) ?>
<?php if (has_category() ): ?>
<span class=’post-categories’><?php the_category( ‘, ‘) ?>
<?php endif ?>
<?php endwhile ?>
<?php else: ?>
Não há postagens aqui
Deseja voltar para a <a href=”>página inicial?
`
O conteúdo mostrado aqui é determinado pela consulta sobre a qual já falamos, e como esse conteúdo é mostrado depende do loop. Essa quantidade de personalização é incrível e é o que faz o WordPress se destacar.
Bom trabalho! Agora você sabe o que é um post loop!
### Usando código para alterar a consulta principal
Antes de começarmos, temos que avisá-lo que alterar a consulta principal pode ter consequências não intencionais se você não souber o que está fazendo. Tome cuidado ao experimentar!
Temos que olhar para os ganchos se quisermos modificar a funcionalidade principal. Os ganchos nos permitem alterar o comprimento do texto, alterar a tela de login, reformular mensagens de erro, alterar tipos de postagem personalizados e muito mais.
add_action( 'pre_get_posts', 'my_exclude_category'); function my_exclude_category( $query) { if ($query->is_home() && $query->is_main_query()) { $query->set( 'cat', '-92' ); } }
Observe que usamos o gancho pre_get_post para modificar o parâmetro da consulta principal antes que ela seja executada. O código acima faz a mesma coisa que o anterior, mas desta vez exclui a categoria 92 da nossa página inicial. Assim, a consulta principal é modificada
Dê uma olhada nas funções is_home() e is_main_query(). Eles estão aqui para garantir que a consulta seja modificada apenas na página inicial e se for a consulta principal.
Aqui está outro código que pode ser útil em um loop de blog do WordPress.
Digamos que um autor em seu site plagiou parte (ou todo) de seu conteúdo e você deseja remover todas as postagens dele permanentemente ou até que o problema seja resolvido.
Isso pode ser feito adicionando um código como este:
add_action( 'pre_get_posts', 'my_exclude_author'); function my_exclude_author( $consulta) { $consulta->set( 'autor', '-23'); }
Com esta função condicional, você remove a postagem do autor do seu site e do seu back-end. Você pode encontrar todas as tags condicionais no WordPress Codex. Aqui está como o último código deve ficar no final:
add_action( 'pre_get_posts', 'my_exclude_author'); function my_exclude_author( $query) { if( !is_admin()) { $query->set( 'author', '-23' ); } }
### Terminando os pensamentos sobre o loop do WordPress
Usar o loop do WordPress é uma ótima maneira de personalizar suas postagens, páginas ou simplesmente – seu site. O loop exige que você tenha um entendimento básico de como o WordPress funciona e a lógica do código.
A menos que você queira fazer um teste rápido, não recomendamos usar a função query_posts(). Você pode usar vários ganchos caso precise modificar a consulta original. Sempre seja cauteloso ao alterar o código de loop do WordPress.
Esperamos que este artigo tenha sido um bom primeiro passo para o seu domínio do loop do WordPress!
Se você gostou deste artigo sobre o loop do WordPress, você também deve ler estes:
– erro 504 no WordPress: como corrigi-lo
– 12 dicas para criar um plugin premium WordPress bem-sucedido ou Tema
– Como aproveitar o cache do navegador no WordPress? Etapas a seguir