Como listar páginas de determinado template no WordPress

Este é um daqueles snippets que estou sempre precisando lembrar durante o meu desenvolvimento WordPress. Estava mais do que na hora de documentar aqui no blog! 👨‍💻

Você já precisou listar as páginas de um certo template? Vamos supor que você criou o template Notícias com o nome template__noticias.php dentro de uma pasta templates.

Veja abaixo uma forma fácil de fazer isso utilizando a função get_posts().

$templateNoticias = get_posts([
  'post_type' => 'page',
  'meta_key' => '_wp_page_template',
  'meta_value' => 'templates/template__noticias.php'
]);
Code language: PHP (php)

O valor padrão para post_type é post, mas você pode alterar para page ou qualquer outro custom post type.

O importante aqui é que o meta_key tenha o valor de _wp_page_template para que possa filtrar pelos templates e que o meta_value seja o caminho do template dentro do seu tema.

Como a pasta templates está na raiz do tema nesse exemplo – o valor do meta_value será de templates/template__noticias.php.

Snippet rápido para ajudar o seu desenvolvimento WordPress de hoje! 🙂