Obtener el ID de página por plantilla

Si tu plantilla de página reside dentro de una subcarpeta, como theme-folder/page-templates/page-template.php, entonces la siguiente consulta funcionará:

$page_details = get_pages( array(
 'post_type' => 'page',
 'meta_key' => '_wp_page_template',
 'hierarchical' => 0,
 'meta_value' => 'page-templates/page-template.php'
));

El código anterior también muestra las subpáginas.

Gracias

Aquí hay una función completa que funciona con WPML y Polylang. Créditos a https://github.com/cyrale/

/**
* Busca una página con una plantilla específica.
*
* @param string $template Nombre del archivo de plantilla.
* @param array  $args     (Opcional) Ver también get_posts() para ejemplo de uso de parámetros.
* @param bool   $single   (Opcional) Si se debe devolver un solo valor.
*
* @return Será un array de WP_Post si $single es false. Será un objeto WP_Post si se encuentra la página, FALSE en caso contrario
*/
if (!function_exists('get_page_by_template')) {
    function get_page_by_template($template, $args = array(), $single = true) {
        $pages_by_template = wp_cache_get('pages_by_template', 'cyrale');
        if (empty($pages_by_template) || !is_array($pages_by_template)) {
            $pages_by_template = array();
        }
        if (!isset($pages_by_template[$template])) {
            $args = wp_parse_args(array(
                'posts_per_page' => -1,
                'post_type'      => 'page',
                'suppress_filters'  => 0,
                'meta_query'     => array(
                    array(
                        'key'   => '_wp_page_template',
                        'value' => $template,
                    ),
                ),
            ), $args);
            $pages = get_posts($args);
            $pages_by_template[$template]= array(
                'single' => !empty($pages) && is_array($pages) ? reset($pages) : false,
                'pages'  => $pages,
            );
        }
        wp_cache_set('pages_by_template', $pages_by_template, 'cyrale');
        return $pages_by_template[$template][$single ? 'single' : 'pages'];
    }
}

El siguiente es un script un poco más articulado que tiene en cuenta un idioma, si es necesario. NOTA: asume el uso de Polylang, no WPML.

function get_post_id_by_template($template,$lang_slug = null){
  global $wpdb;
  $wh = ($lang_slug) ? " AND t.slug = %s" : "";

  $query = $wpdb->prepare(
    "SELECT DISTINCT p.ID
    FROM $wpdb->posts p
    INNER JOIN $wpdb->postmeta meta ON meta.post_id = p.ID
    INNER JOIN $wpdb->term_relationships tr ON meta.post_id = tr.object_id
    INNER JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id
    INNER JOIN $wpdb->terms t ON tt.term_id = t.term_id
    WHERE p.post_status = 'publish' AND meta.meta_key = %s AND meta.meta_value = %s" . $wh,
    '_wp_page_template',
    $template,
    $lang_slug
  );

  $ids = $wpdb->get_results($query);

  if($ids && isset($ids[0])){
    $p = $ids[0];
    return $p->ID;
  } else {
    return false;
  }
}// get_post_id_by_template

function kavkaz_get_page($page_template_filename){
    
    // Obtener páginas con la plantilla especificada
    $pages = get_pages( array(
        'meta_key' => '_wp_page_template',
        'meta_value' => $page_template_filename
    ) );

    $url = null;
    
    // Si existe al menos una página con esa plantilla
    if(isset($pages[0])) {
        $url = $pages[0]->guid;
    }
    
    // Retornar la URL escapada
    return esc_url( $url );
}

Puedes consultar directamente la tabla postmeta:

global $wpdb;
$template = 'page-special';
$sql = "select post_id from {$wpdb->postmeta} where meta_key = '{$template}.php'";
$pages = $wpdb->get_col($sql);
var_dump($pages);