Alterando a query principal com segurança usando pre_get_posts
Como modificar a consulta principal do WordPress sem quebrar o painel administrativo nem outras queries da página.
Causa
Alterar parâmetros como meta_query, tax_query ou posts_per_page sem checar is_admin() e is_main_query() acaba afetando widgets, buscas internas e telas de listagem do wp-admin.
Como resolver
Sempre combine !is_admin() com $query->is_main_query() (e, se necessário, $query->is_home()/is_archive()) antes de alterar os parâmetros da query.
add_action( 'pre_get_posts', function ( $query ) {
if ( is_admin() || ! $query->is_main_query() ) {
return;
}
if ( $query->is_post_type_archive( 'produto' ) ) {
$query->set( 'posts_per_page', 12 );
$query->set( 'orderby', 'title' );
}
} );meta_query deixando consultas lentas em listagens com muitos filtros
Por que filtros baseados em meta_query podem se tornar um gargalo de performance em sites com muitos posts.
Fatal error: Maximum execution time of 30 seconds exceeded
Erro fatal quando um script ultrapassa o tempo máximo de execução configurado no PHP.
get_template_part() carregando o template errado
Comportamento de hierarquia e cache ao usar get_template_part() em temas filhos.
Tratando erros de wp_remote_get e wp_remote_post corretamente
Como consumir APIs externas com a HTTP API do WordPress sem provocar fatal errors.
Inserindo scripts e meta tags com wp_head e wp_footer
Forma recomendada de adicionar meta tags, scripts de terceiros ou pixels de rastreamento ao tema sem editar arquivos do core.
Como enfileirar scripts e estilos com wp_enqueue_scripts
Forma correta de carregar CSS e JS no front-end sem conflitar com o tema ou outros plugins.