Unlimited Plugins, WordPress themes, videos & courses! Unlimited asset downloads! From $16.50/m
Advertisement
  1. Code
  2. WordPress
Code

Dominando WP_Query: Usando o Loop

by
Difficulty:IntermediateLength:ShortLanguages:
This post is part of a series called Mastering WP_Query.
Mastering WP_Query: An Introduction
Mastering WP_Query: Related Functions

Portuguese (Português) translation by João Fagner (you can also view the original English article)

Como foi esboçado na introdução a esta série, a classe WP_Query tem quatro elementos principais:

  • os argumentos para a consulta, utilizando parâmetros que serão abordados em detalhes nesta série
  • a consulta em si
  • o loop, que vai exibir o conteúdo de saída, como títulos ou o que você desejá exibir
  • terminações: fechando os if e while tags e resetando dados post

Neste tutorial eu vou mostrar como usar o loop com WP_Query, incluindo as duas principais maneiras de estruturar o seu loop e como usar multiplos loops.

Quando o loop se encaixa

Sem um loop, nada será exibido na sua página. Depois que o Wordpress executar a consulta, usando os argumentos que você definiu, ele precisara dizer o que deve ser exibido através dos dados que foram percorridos. Este é o lugar onde o loop entra.

O loop vem após a sua consulta, e ele usa três tags:

  • if( $query->have_posts() ) verifica se existem posts.
  • while( $query->have_posts() ) enquanto houver posts para retornar, repete o loop para cada post.
  • $query->the_post() acessa um post específico.

Portanto, este é o lugar em que o loop se encaixa na classe WP_Query:

Depois de executar o loop, tudo o que resta a fazer é arrumar as coisas usando wp_reset_postdata().

Estrutura do Loop

A forma como o loop está estruturado vai depender dos dados que você deseja exibir do seu post. Aqui está um exemplo de loop que exibi o título do post, a imagem de destaque e um resumo. Você usaria um loop como este em uma página de arquivo.

Este loop exibe exatamente o que eu descrevi acima: a imagem de destaque, título e resumo.

Extendendo o seu Loop: Verificando o Conteúdo

Mas talvez você quisesse ter adicionado um título antes da lista dos posts, ou quisesse ter colocado todos eles dentro de um elemento de conteúdo. Se você simplesmente tivesse feito isto antes, o seu loop teria sido exibido independentemente se a consulta retornasse algum dado, o que significa que você poderia ter um título sem nada em baixo, ou alguma marcação desnecessária.

Isso é muito fácil de se contornar, colocando o elemento delimitador ou o título dentro de seu tag if:

Aqui você pode ver, verifiquei se existem posts retornados em minha consulta e se houver abri um elemento de conteudo e acrescentei um título.

Isso também é útil se você quiser exibir os resultados da consulta como uma lista. Vamos dizer que eu quero criar uma lista de todos os posts de uma determinada categoria. O elemento ul não está dentro do meu loop, uma vez que não diz respeito a um post específico, mas eu quero apenas exibir se existir posts. Então, eu faço o seguinte:

Isto verifica se a consulta tem buscado quaisquer posts e se caso sim, ele abre o elemento da ul e em seguida, executa o loop.

Executando Múltiplos Loops

Tome cuidado quando estiver usando o WP_Query para executar mais de um loop, você precisará resetar os dados do post para depois iniciar uma segunda  consulta WP_Query. Isso ocorre porque cada um de seus loops terão saída de dados com base em diferentes argumentos.

Este exemplo exibi o resumo e imagem de destaque para o primeiro post e em seguida, apenas o título de cada post subsequente:

Eu usei dois argumentos-chave aqui:

  • 'posts_per_page' => '1', usado com a primeira consulta, produz apenas o post mais recente.
  • 'offset' = '1', usado com a segunda consulta, salta para a primeiro post, garantindo que não é repetido na lista abaixo.
  • Como você pode ver no código acima, o loop é um pouco diferente para cada consulta. Na primeira saída exibi uma imagem de destaque, título e resumo, enquanto a segunda verifica se a consulta retornou os posts se sim, abri o elemento ul que junta cada título de post no elemento li com um link para sua página.

Você também vai notar que eu usei wp_reset_postdata() depois de ambos os loops. Se eu não tivesse feito isso, o segundo loop exibiria dados do primeiro loop.

Resumo

Sem um loop, WP_Query realmente não faz muito coisa. O loop é o código que você usa para exibir os dados que o WordPress tem buscado a partir do banco de dados com base em seus argumentos de consulta.

Como já demonstrado, existem algumas variações de loop. Um loop simples irá apenas exibir todos os posts na ordem que você especificou em seus argumentos de consulta (ou por data, em ordem decrescente por padrão). Se você separar if( $query->have_posts() ) e while( $query->have_posts() ), você pode inserir uma marcação adicional fora do seu loop, mas apenas se sua consulta retorna dados. E finalmente, especificando argumentos alternativos e usando wp_reset_postdata() depois de cada loop, você pode usar WP_Query mais de uma vez para criar múltiplos loops em sua página.

Seja o primeiro a saber sobre novas traduções–siga @tutsplus_pt no Twitter!

Advertisement
Advertisement
Looking for something to help kick start your next project?
Envato Market has a range of items for sale to help get you started.