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
}

我认为混乱是由于两件事造成的：

1. 该文档含糊地提及“名称”。指定“文件名”将使文档更加清晰。
2. 后面的代码is_page_template()显示了该get_page_template_slug()功能的核心。该函数实际上返回文件名，而不是模板段。 https://codex.wordpress.org/Function_Reference/get_page_template_slug

在为is_page_template()函数指定参数时（如上例所示），文件路径是相对于主题根目录的。

此功能在循环内不起作用。

我认为最好说的是，它检查文件名，在您的情况下为page-homepage.php。所以：

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

其他需要考虑的事情是模板文件是否实际存储在主题内的另一个文件夹中。 阅读更多

还有一件事，Template Name: Homepage通常是在创建页面或帖子时用来标识模板的内容。