Buscando informações exclusivas das páginas: com o get_queried_object_id() no WordPress

A +A −

No desenvolvimento de temas e plugins para WordPress, um dos desafios comuns que programadores enfrentam é garantir que as informações exibidas em uma página sejam coerentes com o template desenvolvido. Uma dessas situações por exemplo envolve a obtenção do título e do permalink de uma página.

Você já deve ter usado funções como the_title() e the_permalink(), mas talvez tenha se deparado com problemas em que essas funções retornam valores inesperados, especialmente ao trabalhar com loops secundários na página, e os valores do título e permalink, que deveriam vir da págia atual, pegam de algum post do loop. É aqui que entra a importância de usar get_queried_object_id().

Por que usar get_queried_object_id()?

A função get_queried_object_id() retorna o ID do objeto principal da consulta atual, ou seja, a página ou post que o WordPress está processando no momento. Com isso, você pode usar funções como get_the_title() e get_permalink() para obter informações confiáveis, sem depender do loop principal.

Exemplo prático:

<?php echo get_the_title( get_queried_object_id() ); ?> 
<?php echo get_permalink( get_queried_object_id() ); ?>

<?php echo get_the_title( get_queried_object_id() ); ?> 
<?php echo get_permalink( get_queried_object_id() ); ?>

Essas linhas garantem que o título e o link correspondam à página ou post atual, mesmo que você tenha outros loops no código.

Como get_queried_object_id() resolve esses problemas

Ao usar get_queried_object_id(), você garante que está sempre trabalhando com o contexto principal da página atual, independente de outros loops ou consultas.

No exemplo a seguir, no botão do Whatsapp que fica pinado em todas as páginas de um site, ao usar o get_queried_object_id() você irá garantir que as informações sejam daquela página exclusivamente, e não será influenciada por interferência de algum loop.

<a href="https://api.whatsapp.com/send/?text=<?php echo get_the_title( get_queried_object_id() ); ?> - <?php echo get_permalink( get_queried_object_id() ); ?>">

<a href="https://api.whatsapp.com/send/?text=<?php echo get_the_title( get_queried_object_id() ); ?> - <?php echo get_permalink( get_queried_object_id() ); ?>">

Vantagens

• Precisão: O título e o link sempre refletem a página atual.
• Evita conflitos: Funções globais como the_title() e the_permalink() não são influenciadas por loops secundários.
• Código mais limpo e reutilizável: Não é necessário criar workarounds manuais.

Insights dos ratos

O uso de get_queried_object_id() é top para garantir a consistência e a precisão dos dados exibidos quando você está desenvolvendo um tema ou plugin WordPress. Ele resolve problemas causados por loops secundários e torna o código mais confiável, especialmente em cenários complexos.

Se você é um programador que trabalha com WordPress, adotar essa prática pode poupar muitas dores de cabeça e melhorar a qualidade do seu trabalho. 🚀

Se você precisa de ajuda com seu site WordPress entre em contato com a Pink and Brain. Somos ratos quando o assunto é desenvolvimento WordPress.