深入解析WordPress中加载模板的get_template_part函数

 更新时间:2016年01月11日 16:35:25   作者:稍息少年  
这篇文章主要介绍了WordPress中加载模板的get_template_part函数,其中重点讲解了其函数钩子的使用,需要的朋友可以参考下

最近研究官方主题 Twenty Eleven ,有一些东西网上现成的中文资料不好找,在博客里记载下来,算是分享,也算是备忘,wordpress 3.0 以后就开始便有了get_template_part() 这个函数 ,应该是为文章呈现形式提供更为多样化的选择而给出的新功能。

Twenty Eleven 中 实例如下:

Twenty Eleven index.php 文件
 行:21

<?php if ( have_posts() ) : ?>
 <?php twentyeleven_content_nav( 'nav-above' ); ?>
 <?php /* Start the Loop 在循环中使用以调用不同类型的文章 */ ?>
 <?php while ( have_posts() ) : the_post(); ?>
 <?php get_template_part( 'content', get_post_format() ); ?>
 <?php endwhile; ?>
............................
<?php endif; ?>

描述:
加载一个制定的模板到另一个模板里面(不同于包含header,sidebar,footer).
使得一个主题使用子模板来实现代码段重用变得简单

用于在模板中包含指定的模板文件,只需用指定参数slug和name就可以包含文件{slug}-{name}.php,最重要的功能是如果没有这个文件就包含没有{name}的.php文件文件

使用方法:

<?php get_template_part( $slug, $name ) ?>

参数:

  • $slug (必须) 通用的模板名
  • $name (可选) 指定的模板名

示例:

使用 loop.php 在子主题里面

假设主题文件夹wp-content/themes下父主题是twentyten子主题twentytenchild,那么下面的代码:

<?php get_template_part( 'loop', 'index' ); ?>

php 的require()函数将按下面优先级包含文件

1. wp-content/themes/twentytenchild/loop-index.php
2. wp-content/themes/twentytenchild/loop.php
3. wp-content/themes/twentyten/loop-index.php
4. wp-content/themes/twentyten/loop.php

导航(这个例子很烂,但却是另一种使用思路)
使用通用的nav.php文件给主题添加导航条:

<?php get_template_part( 'nav' );      // Navigation bar (nav.php) ?>
<?php get_template_part( 'nav', '2' );   // Navigation bar #2 (nav-2.php) ?>
<?php get_template_part( 'nav', 'single' ); // Navigation bar to use in single pages (nav-single.php) ?>

get_template_part() 的钩子详解
因为在官方主题(Twenty Eleven)中 get_template_part() 函数被大量使用,所以就目前来看,该函数应该算是比较热门的一个函数了,之前有写过一篇文章讲述该函数的具体使用方法,在这里也就不便再赘述,本文主要针对该函数的 add_action 中的 hook $tag 值进行探讨,因为,WP hook 中林林总总有那么些函数在$tag 值中比较让人费解。

与普通hook的区别
普通的hook的$tag 是一个固定值,而 get_template_part() 确是一个可变值,好吧先不说,wp这么做给我们实现一个简单功能带来多少麻烦,但如此设置确实给多样化的主题实现带来了不少方便之处。
实现这一原理的源代码如下,截取自 WordPress 源程序。

 function get_template_part( $slug, $name = null ) {
//$tag = "get_template_part_{$slug}" 
//也就是,get_template_part_+你当时设置的$slug值
 do_action( "get_template_part_{$slug}", $slug, $name );
 $templates = array();
 if ( isset($name) )
  $templates[] = "{$slug}-{$name}.php";
  $templates[] = "{$slug}.php";
  locate_template($templates, true, false);
}

实例
像上面那样说,可能也许基本上有点看不明白,好吧给点实例

 

//复习一下get_template_part($slug, $name)的用法,
//如果你在主题里这样
get_template_part( 'index' , 'photo');
//那么 WP 会去找主题根目录下 index-photo.php 文件
 
//那么我们想挂一个函数的话就得像如下
function addFunction ($slug, $name){
echo $slug;
}
add_action("get_template_part_index","addFunction",10,2);

get_template_part() 函数详解备忘

相关文章

  • php算开始时间到过期时间的相隔的天数

    php算开始时间到过期时间的相隔的天数

    php算开始时间到过期时间的相隔的天数,同理可以实现相隔年,小时,分,秒等数
    2011-01-01
  • php使用preg_match()函数验证ip地址的方法

    php使用preg_match()函数验证ip地址的方法

    这篇文章主要介绍了php使用preg_match()函数验证ip地址的方法,涉及php针对数字及字符串的正则匹配操作相关技巧,需要的朋友可以参考下
    2017-01-01
  • windows服务器使用IIS时thinkphp搜索中文无效问题

    windows服务器使用IIS时thinkphp搜索中文无效问题

    在用ThinkPHP开发的网站,在linux服务器下使用过一段时间,一切正常。但是更换到windows服务器时,发现搜索的时候,无法搜索中文,查不出相应的结果。查看数据库发现数据是存在的。linux服务器下正常,而且搜索数字或字母程序正常,说明程序是没有任何问题的。
    2023-06-06
  • PHPStorm+Xdebug进行emote Debug时无法进入断点问题排查

    PHPStorm+Xdebug进行emote Debug时无法进入断点问题排查

    这篇文章主要介绍了PHPStorm+Xdebug进行emote Debug时无法进入断点问题排查,遇到类似问题的同学,可以详细参考下
    2021-04-04
  • 深入了解 register_globals (附register_globals=off 网站打不开的解决方法)

    深入了解 register_globals (附register_globals=off 网站打不开的解决方法)

    由于register_globals设置控制PHP变量访问范围,如果开启会引起不必要的安全问题,所以这里对其进行了强制关闭,如果站长的空间不支持,可以采用以下几种办法进行修改,供广大站长参考
    2012-06-06
  • PHP函数用法详解【初始化、嵌套、内置函数等】

    PHP函数用法详解【初始化、嵌套、内置函数等】

    这篇文章主要介绍了PHP函数用法,结合实例形式详细分析了PHP函数初始化、嵌套、内置函数等相关定义、原理与操作注意事项,需要的朋友可以参考下
    2020-06-06
  • PHP实现二维数组根据key进行排序

    PHP实现二维数组根据key进行排序

    这篇文章主要介绍了PHP实现二维数组根据key进行排序,在PHP中内置了很多对数组进行处理的函数,有很多时候我们直接使用其内置函数就能达到我们的需求,得到我们所想要的结果,需要的朋友可以参考下
    2023-10-10
  • 详解PHP排序函数的使用方法

    详解PHP排序函数的使用方法

    这篇文章主要给大家介绍了PHP排序函数的使用方法,文章通过代码示例介绍的非常详细,PHP排序函数的使用方法,需要的朋友可以参考下
    2023-09-09
  • PHP使用XMLWriter读写xml文件操作详解

    PHP使用XMLWriter读写xml文件操作详解

    这篇文章主要介绍了PHP使用XMLWriter读写xml文件操作,结合实例形式分析了php基于XMLWriter针对xml文件进行读写操作相关实现技巧,并附带相关源码供读者下载参考,需要的朋友可以参考下
    2018-07-07
  • PHP实现防重复提交(防抖)的方法总结

    PHP实现防重复提交(防抖)的方法总结

    当涉及到处理表单提交或用户点击按钮等操作时,防抖(Debounce)是一种重要的技术,它可以有效地防止不必要的重复操作,本文为大家整理了 PHP 中防抖的多种实现方法,需要的可以参考下
    2023-09-09

最新评论