is_page_template（）は何と比較しますか？

Wordpressのドキュメントを見るis_page_template()と、「テンプレート名」が提供されている場合は、それと比較されます。

とpage-homepage.php呼ばれるに保存されているテンプレートがありHomepageます：

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

そして、そのテンプレートを使用しているときにfunctions.phpで実行したいコードがいくつかあります。

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

しかし、そのテンプレートを使用するページにいるときはトリガーされません。

Wordpressが実行するコードを見ると、is_page_template()実際にはテンプレート名ではなくドキュメント名をチェックしているように見えます...？

function is_page_template( $template = '' ) {

    $page_template = get_page_template_slug( get_queried_object_id() );

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

私のインスタンスでは、ドキュメントのようにテンプレート名で$page_templateはpage-homepage.phpないようです...？

私は何か間違ったことをしていますか？

あなたの状態は次のように書かれるべきです：

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

混乱の原因は2つあります。

1. ドキュメントは「名前」を曖昧に参照しています。「ファイル名」を指定すると、ドキュメントがより明確になります。
2. 背後のコードis_page_template()は、get_page_template_slug()その中心にある機能を示しています。この関数は、実際にはテンプレートスラッグではなくファイル名を返します。 https://codex.wordpress.org/Function_Reference/get_page_template_slug

is_page_template()（上記の例のように）関数の引数を指定する場合、ファイルパスはテーマルートからの相対パスです。

この関数はループ内では機能しません。

一番いいのは、FILE名をチェックすることです。あなたの場合は、page-homepage.phpになります。そう：

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

テンプレートファイルがテーマ内の別のフォルダーに実際に格納されている場合は、他に考えなければならないことがあります。 続きを読む

もう1つ、一般的にはTemplate Name: Homepage、ページまたは投稿を作成するときにテンプレートを識別するために使用されるものです。