WP_Query — Loop customizado com paginação – repositoriofull.studioway.com.br

Tipo Funções nativas

Nome do erro WP_Query — Loop customizado com paginação

Severidade Informativo

Desde WordPress 1.5

Descrição Classe principal do WordPress para construir consultas ao banco de dados. Suporta paginação, filtros por taxonomia, meta e muito mais.

Causa

O loop padrão do WordPress não é suficiente quando você precisa de múltiplos loops ou consultas complexas com filtros combinados.

Como resolver

Instancie WP_Query com os argumentos necessários. Sempre chame wp_reset_postdata() ao final para restaurar o post global.

PHP

<?php
$paged = get_query_var('paged') ? get_query_var('paged') : 1;

$query = new WP_Query([
    'post_type'      => 'produto',
    'posts_per_page' => 12,
    'paged'          => $paged,
    'post_status'    => 'publish',
    'tax_query'      => [[
        'taxonomy' => 'categoria_produto',
        'field'    => 'slug',
        'terms'    => 'eletronicos',
    ]],
    'meta_query'     => [[
        'key'     => '_preco',
        'value'   => 100,
        'compare' => '>=',
        'type'    => 'NUMERIC',
    ]],
]);

if ($query->have_posts()) {
    while ($query->have_posts()) {
        $query->the_post();
        echo '<div>' . get_the_title() . '</div>';
    }
    echo paginate_links(['total' => $query->max_num_pages]);
}
wp_reset_postdata();

get_post_meta() — Recuperar campos personalizados

Recupera o valor de um campo meta de um post. Aceita um terceiro parâmetro para retornar valor único ou array.

wp_enqueue_script() — Carregar scripts com dependências

Enfileira um arquivo JavaScript de forma correta, gerenciando dependências e evitando carregamentos duplicados.

get_posts() — Buscar posts com parâmetros avançados

Retorna um array de objetos WP_Post com base nos argumentos fornecidos. Alternativa simples ao WP_Query para listagens pontuais.

wp_remote_get() — Requisições HTTP externas

Realiza uma requisição HTTP GET para uma URL externa de forma assíncrona e segura usando a WordPress HTTP API.

get_template_part() — Modularizar templates de tema

Carrega um template parcial dentro de outro template de forma organizada, permitindo reutilização de componentes e facilitando a manutenção do tema.

the_posts_pagination() — Paginação nativa do WordPress

Gera links de paginação para a query principal de forma acessível, semântica e compatível com SEO, sem necessidade de plugins extras.

WP_Query — Loop customizado com paginação