1. 首页
  2. WordPress 函数手册

is_page_template()

is_page_template( string|array $template =  )

确定当前是否在页面模板中。
Determines whether currently in a page template.

目录锚点:#说明#参数#返回#源码#笔记


说明(Description)

此模板标记允许您确定是否在页面模板中。您可以选择提供模板文件名或模板文件名数组,然后检查将特定于该模板。

有关此主题函数和类似主题函数的更多信息,请参阅主题开发人员手册中的条件标记文章。


参数(Parameters)

参数 类型 必填 说明
$template (string | array) 可选 要匹配的特定模板文件名或模板数组。

返回(Return)

(bool)成功时正确,失败时错误。


源码(Source)

/**
 * Whether currently in a page template.
 *
 * This template tag allows you to determine if you are in a page template.
 * You can optionally provide a template name or array of template names
 * and then the check will be specific to that template.
 *
 * @since 2.5.0
 * @since 4.2.0 The `$template` parameter was changed to also accept an array of page templates.
 *
 * @param string|array $template The specific template name or array of templates to match.
 * @return bool True on success, false on failure.
 */
function is_page_template( $template = '' ) {
	if ( ! is_page() )
		return false;

	$page_template = get_page_template_slug( get_queried_object_id() );

	if ( empty( $template ) )
		return (bool) $page_template;

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

	if ( is_array( $template ) ) {
		if ( ( in_array( 'default', $template, true ) && ! $page_template )
			|| in_array( $page_template, $template, true )
		) {
			return true;
		}
	}

	return ( 'default' === $template && ! $page_template );
}
更新版本 源码位置 使用 被使用
4.7.0 wp-includes/post-template.php:1747 1 function 3

笔记(Notes)

是否正在使用页面模板“关于”?注意,与其他条件不同,如果要指定特定的页面模板,则需要使用文件名,例如关于.php或我的网页_模板.php.
如果页面模板位于目录中,则可以使用以下内容:
还可以通过传递模板名称数组来指定多个模板。

is_page_template() 为WP2原创文章,链接:https://www.wp2.cn/functions/is_page_template/

发表评论

您的电子邮箱地址不会被公开。