Con cosa si confronta is_page_template ()?

Guardando attraverso la documentazione di Wordpress , si dice che si is_page_template()confronta con un "nome modello", se fornito.

Ho un modello memorizzato in page-homepage.phpchiamato Homepage:

/*
 * Template Name: Homepage
 * Description: The template for displaying the homepage
 */

E ho un po 'di codice che vorrei eseguire nel mio function.php quando sto usando quel modello:

if (is_page_template('Homepage')) { 
   ...

Ma non viene attivato quando sono su una pagina che utilizza quel modello.

Quando guardo il codice per cui Wordpress esegue is_page_template(), sembra che in realtà controlla il nome del documento, non il nome del modello ...?

function is_page_template( $template = '' ) {

    $page_template = get_page_template_slug( get_queried_object_id() );

    if ( $template == $page_template )
        return true;

Nel mio caso sembra che $page_templatesia page-homepage.php- non il nome del modello, come la documentazione suggerisce ...?

Sto facendo qualcosa di sbagliato?

La tua condizione dovrebbe essere scritta in questo modo:

if (is_page_template('path/file.php')) { 
    // Do stuff
}

Credo che la confusione sia il risultato di due cose:

1. I documenti si riferiscono al "nome" in modo ambiguo. Specificare "nome file" renderebbe la documentazione molto più chiara.
2. Il codice dietro is_page_template()mostra la get_page_template_slug()funzione al suo interno. Questa funzione restituisce effettivamente un nome di file, non la lumaca di modello. https://codex.wordpress.org/Function_Reference/get_page_template_slug

Quando si specifica un argomento per la is_page_template()funzione (come nell'esempio sopra), il percorso del file è relativo alla radice del tema.

Questa funzione non funzionerà all'interno del loop.

Penso che la cosa migliore da dire sia che controlla il nome del FILE e nel tuo caso sarebbe page-homepage.php. così:

if (is_page_template('page-homepage.php')) { 
  ...

Altre cose a cui pensare è se il file modello è effettivamente archiviato in un'altra cartella all'interno del tema. leggi di più

Un'altra cosa, Template Name: Homepageè generalmente quello che è usato per identificare il modello quando si crea una pagina o un post.