Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

O que é: WP_Query

WP_Query é uma classe definida no WordPress. Ela permite que os desenvolvedores escrevam consultas personalizadas e exibam posts usando parâmetros diferentes. É possível que os desenvolvedores consultem diretamente o banco de dados do WordPress. No entanto, a WP_Query é uma das formas recomendadas para consultar posts do banco de dados do WordPress.

Abaixo está um exemplo de uma WP_Query simples que exibe posts da categoria de filmes:

<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );

?>

O código de exemplo acima não exibe automaticamente as postagens. Para exibir os resultados da consulta, o usuário precisaria usar o loop do WordPress. Assim:

<?php
// The Query
$the_query = new WP_Query( 'category_name=movies' );

// The Loop
if ( $the_query->have_posts() ) {
        echo '<ul>';
	while ( $the_query->have_posts() ) {
		$the_query->the_post();
		echo '<li>' . get_the_title() . '</li>';
	}
        echo '</ul>';
} else {
	// no posts found
}
/* Restore original Post Data */
wp_reset_postdata();

?>

O WP_Query é uma ferramenta poderosa, pois há muitos parâmetros que podem ser usados para escrever consultas mais complexas e avançadas. O WP_Query pode ser usado para criar loops aninhados (um loop do WordPress dentro de um loop). Os desenvolvedores do WordPress podem usá-lo em seus plugins e temas para criar suas próprias exibições personalizadas de posts.

Uma lista completa dos parâmetros do WP_Query está disponível no WordPress Codex.

Leitura adicional

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!