is_page_template()
is_page_template( string|array $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.
如果页面模板位于目录中,则可以使用以下内容:
还可以通过传递模板名称数组来指定多个模板。
类别:WordPress 函数手册、
本文收集自互联网,转载请注明来源。
如有侵权,请联系 wper_net@163.com 删除。
还没有任何评论,赶紧来占个楼吧!