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.

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.:

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.

• See also is_page()

is_page_template() 注意

添加于 版本 2.5.0

is_page_template() 历史

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

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() 相关