is_page_template()判断是否使用了一个页面模版

• 描述
• 用法
• 参数
• 返回值
• 示例
• 注意
• 历史
• 源文件
• 相关

This Conditional Tag allows you to determine if you are in any page template. Optionally checks if a specific Page Template is being used in a Page. This is a boolean function, meaning it returns either TRUE or FALSE. This tag must be used BEFORE The Loop and does not work inside The Loop (see Notes below).

is_page_template() 描述

<?php is_page_template( $template ); ?>

is_page_template() 用法

$template

(string|array) (可选) The specific template name or array of templates to match.

默认值: None

is_page_template() 参数

(boolean) 

True on success, false on failure.

is_page_template() 返回值

Is Page Template 'about' being used? Note that unlike with other conditionals, if you want to specify a particular Page Template, you need to use the filename, such as about.php or my_page_template.php.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

if ( is_page_template( 'about.php' ) ) {
	// Returns true when 'about.php' is being used.
} else {
	// Returns false when 'about.php' is not being used.
}

is_page_template() 示例

Page template in subdirectory

If the page template is located in a subdirectory of the theme (since WP 3.4), prepend the folder name and a slash to the template filename, e.g.:

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

is_page_template( 'templates/about.php' );

Cannot Be Used Inside The Loop

Due to certain global variables being overwritten during The Loop is_page_template() will not work. In order to use it after The Loop you must call wp_reset_query() after The Loop.

Alternative

Since the page template slug is stored inside the post_meta for any post that has been assigned to a page template, it is possible to directly query the post_meta to see whether any given page has been assigned a page template. This is the method that is_page_template() uses internally.

The function get_page_template_slug( $post_id ) will return the slug of the currently assigned page template (or an empty string if no template has been assigned - or false if the $post_id does not correspond to an actual page). You can easily use this anywhere (in The Loop, or outside) to determine whether any page has been assigned a page template.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */

<?php 
  // in the loop:
  if ( get_page_template_slug( get_the_ID() ) ){
     // Yep, this page has a page template
  }

  // anywhere:
  if ( get_page_template_slug( $some_post_ID ) ){
     // Uh-huh.
  }
?>

• See also is_page()

is_page_template() 注意

添加于 版本 2.5.0

is_page_template() 历史

is_page_template() 函数的代码位于 wp-includes/post-template.php.

/* ----------------------------------
 * wordpress之魂 © http://wphun.com
 * ---------------------------------- */
/**
 * 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 );
}

is_page_template() 源文件

• Article(文章): Introduction to WordPress conditional functions
• Function(方法): comments_open()
• Function(方法): is_404()
• Function(方法): is_admin()
• Function(方法): is_admin_bar_showing()
• Function(方法): is_archive()
• Function(方法): is_attachment()
• Function(方法): is_author()
• Function(方法): is_category()
• Function(方法): is_comments_popup()
• Function(方法): is_date()
• Function(方法): is_day()
• Function(方法): is_feed()
• Function(方法): is_front_page()
• Function(方法): is_home()
• Function(方法): is_local_attachment()
• Function(方法): is_main_query
• Function(方法): is_multi_author
• Function(方法): is_month()
• Function(方法): is_new_day()
• Function(方法): is_page()
• Function(方法): is_page_template()
• Function(方法): is_paged()
• Function(方法): is_plugin_active()
• Function(方法): is_plugin_active_for_network()
• Function(方法): is_plugin_inactive()
• Function(方法): is_plugin_page()
• Function(方法): is_post_type_archive()
• Function(方法): is_preview()
• Function(方法): is_search()
• Function(方法): is_single()
• Function(方法): is_singular()
• Function(方法): is_sticky()
• Function(方法): is_tag()
• Function(方法): is_tax()
• Function(方法): is_taxonomy_hierarchical()
• Function(方法): is_time()
• Function(方法): is_trackback()
• Function(方法): is_year()
• Function(方法): in_category()
• Function(方法): in_the_loop()
• Function(方法): is_active_sidebar()
• Function(方法): is_active_widget()
• Function(方法): is_blog_installed()
• Function(方法): is_rtl()
• Function(方法): is_dynamic_sidebar()
• Function(方法): is_user_logged_in()
• Function(方法): has_excerpt()
• Function(方法): has_post_thumbnail()
• Function(方法): has_tag()
• Function(方法): pings_open()
• Function(方法): email exists()
• Function(方法): post_type_exists()
• Function(方法): taxonomy_exists()
• Function(方法): term_exists()
• Function(方法): username exists()
• Function(方法): wp_attachment_is_image()
• Function(方法): wp_script_is()

is_page_template() 相关