{"id":33474,"date":"2023-03-14T19:24:16","date_gmt":"2023-03-14T22:24:16","guid":{"rendered":"\/tutoriais\/?p=33474"},"modified":"2025-04-09T05:00:42","modified_gmt":"2025-04-09T08:00:42","slug":"wp_query","status":"publish","type":"post","link":"\/br\/tutoriais\/wp_query\/","title":{"rendered":"WP_Query: como usar + exemplos com c\u00f3digos"},"content":{"rendered":"

Por padrão, o WordPress automaticamente classifica seus posts dos mais recentes para os mais antigos. Ainda que os visitantes possam buscar por publicações específicas utilizando categorias e tags, eles podem não conseguir encontrar o conteúdo que desejam. Para organizar seus posts e fazer uma curadoria para cada visitante, pode ser útil usar o WordPress WP_Query<\/strong>.<\/p>

Usando o WP_Query, você pode personalizar a exibição dos posts e páginas do seu site. Essa classe PHP permite que você simplifique solicitações complexas ao banco de dados. Como desenvolvedor ou dono de sites, o WP_Query pode te ajudar a customizar suas páginas para além do seu tema padrão. <\/p>

Neste tutorial vamos explicar o que é WP_Query. Depois, vamos te mostrar como utilizar essa função no seu site WordPress. Por fim, oferecemos alguns exemplos de como implementar essas práticas em seu blog. Vamos lá!<\/p>

\"\"<\/a><\/figure>

\n\n\n\n\n\n\n<\/p>

Uma Introdução ao WP_Query<\/strong><\/h2>

No WordPress, os dados do seu site são armazenados em um banco de dados MySQL. Esse banco de dados inclui tudo, desde posts, páginas e comentários, até as configurações do site. <\/p>

Quando um visitante clica em qualquer botão ou link do seu site, essa ação envia uma solicitação para o seu banco de dados WordPress<\/strong><\/a>.<\/p>

Então, o seu banco de dados localiza e obtém a página ou post específico e exibe eles em seu site, baseado nessa solicitação — que é chamada de query<\/strong><\/a>. <\/p>

Como dono de um site, você pode tirar proveito das queries para buscar informações específicas no seu banco de dados. Apesar de ser possível construir queries SQL, esse não é o modo mais eficiente para obter informações. É aí que entra a WP_Query.<\/p>

A WP_Query<\/strong><\/a> é uma classe PHP que pode ser utilizada na construção de queries para seu banco de dados. Essa classe já vem integrada no WordPress, e é acionada a cada vez que alguém busca por seus conteúdos.<\/p>

\n
\"Captura<\/figure>\n<\/div>

De todo modo, implementar uma query WordPress personalizada pode permitir que os usuários encontrem algum conteúdo específico sem necessitar de uma pesquisa. Se você precisa renderizar um grupo específico de posts no front-end do seu site, é possível fazer isso facilmente utilizando um tipo de post personalizado WP_Query.<\/p>

Por exemplo, você pode querer criar posts personalizados no WordPress<\/strong><\/a>. Para exibir esses posts, você pode escrever uma query específica. Abaixo indicamos a estrutura de código<\/strong><\/a> básica que pode ser utilizada para isso:<\/p>

\/\/ WP QUERY\n\n$query = new WP_Query([\n\n'post_type' => 'press-release'\n\n\"posts_per_page => 25,\n\n'category_name' => 'health',\n\n]);<\/pre>
Esse código funciona ao personalizar o Loop<\/strong><\/a>. Basicamente, o Loop é um código PHP que o WordPress utiliza para exibir certas publicações. O WordPress sabe como processar e formatar cada post baseado em critérios específicos do seu tipo de post personalizado WP_Query.<\/p>
A WP_Query também é muito útil para desenvolvedores. Você pode personalizar temas do WordPress utilizando esta classe PHP sem consultar diretamente o banco de dados.<\/p>
Como Usar a WP_Query do WordPress (4 Métodos)<\/strong><\/h2>
Agora que você já sabe o básico sobre o que é WP_Query, vamos discutir como criar sua primeira query. Desse modo, você poderá personalizar a exibição do seu site de forma simples e rápida!<\/p>
1. Crie um Loop<\/strong><\/h3>
Você precisará se familiarizar com o WordPress Loop para começar. Como mencionado anteriormente, o Loop é responsável por extrair os dados de um post a partir do banco de dados. Ele determina como seu conteúdo será exibido de acordo com os arquivos de template do seu tema. <\/p>
Baseado nos parâmetros que você definir, abaixo indicamos o que o Loop é capaz de exibir:<\/p>