Conheça a classe WP_Term_Query no WordPress 4.6
E como é de costume, a nova versão do WordPress trouxe novidades. Uma delas é a introdução de uma nova classe: a WP_Term_Query.
O WordPress↳WordPress9 conteúdosAndroid push notifications com Quasar Framework, Firebase e integração com WordPressDev (Back & Front) · mai 2019Simplificando a acessibilidade de documentos: introduzindo a integração do ONLYOFFICE DocSpace com WordPress e DrupalDev (Back & Front) · abr 2024Como criar seu site WordPress com um único prompt de IA em minutos?Dev (Back & Front) · mar 2025Ver tudo em Dev (Back & Front) → 4.6 está aí. E como é de costume em novas versões, sempre muitas novidades acompanham esse release. Uma delas, que vamos tratar nesse artigo, é a introdução de uma nova classe: a WP_Term_Query.
Referências para sua criação
O WordPress gradativamente vai introduzindo novas classes para melhorar a filtragem de seus diversos elementos. WP_Query para posts, WP_User_Query para usuários, WP_Comment_query para comentários, faltava justamente a WP_Term_Query para completar a família.
Todas essas classes tem em comum sua função de filtrar elementos no banco de dados↳Banco de dados134 conteúdosSQL ou NoSQL: eis a questão!!Data · mar 2020Banco de dados: como organizar e dar segurança para milhões de dados de loteriasData · mai 20215 serviços gratuitos na cloud para bancos de dados PostgresData · fev 2025Ver tudo em Data → de forma mais intuitiva para o desenvolvedor, tornando o código mais fácil de ser implementado, melhorado e mantido.
Mas o que, afinal, a classe WP_Term_Query filtra?
Intuitivamente ela filtra termos. Mas o que são esses termos, afinal? No WordPress termos referem a um item de uma taxonomia. Por exemplo, em uma taxonomia personalizada de cor, cada cor cadastrada seria um termo.
Até o WordPress 4.5 era utilizada a função get_terms() para recuperar termos de uma taxonomia. Essa função retorna um array de objetos da classe WP_Term, desde a versão 4.4, mas seu uso ainda era um embaraço para os desenvolvedores, tornando get_terms() o patinho feio da família.
Compatibilidade com códigos já desenvolvidos
Não se preocupe, aquele seu código legado que ainda utiliza get_terms() não vai quebrar e seu site não vai parar de uma hora para outra. Essa função continua existindo, mas agora como um wrapper para a classe WP_Term_Query, que passará a ser a principal ferramenta para retornar termos de uma taxonomia. De qualquer forma, é sempre muito importante manter toda sua instalação atualizada.
é entusiasta da plataforma WordPress e Analista de Sistemas na Apiki WordPress, empresa referência em WordPress no Brasil. É graduado em Sistemas de Informação e já foi palestrante em edições do WordCamp Brasil.
