在《学习二》里,大概说了下怎么去查找模板,本节我们以一个简单的模板为例子,继续说说wordpress的模板机制,看看做一个自己的模板需要哪些知识点。
页面模板渲染
wordpress的模板位于wp-content/themes目录下,wordpress可以自动加载新增的模板目录。通过上一节的简单介绍,知道wordpress默认打开时会查找home.php或者index.php。我们先看看wordpress自带的模板twentyfifteen的index.php页面。
这个index.php里的代码很简单,只描述了怎么去展示首页的逻辑。代码中有get_header(), get_sidebar(), get_footer()三个加载函数,分别加载页面的头部,尾部和侧边栏。一般来说,网站的这三个部分是公用的,所以wordpress抽象了三个函数,来实现代码的重用。以 get_sidebar()的代码为例,看看是如何加载页面的不同部分的。
function get_sidebar( $name = null ) {
/**
* Fires before the sidebar template file is loaded.
*
* The hook allows a specific sidebar template file to be used in place of the
* default sidebar template file. If your file is called sidebar-new.php,
* you would specify the filename in the hook as get_sidebar( 'new' ).
*
* @since 2.2.0
* @since 2.8.0 $name parameter added.
*
* @param string $name Name of the specific sidebar file to use.
*/
do_action( 'get_sidebar', $name );
$templates = array();
$name = (string) $name;
if ( '' !== $name )
$templates[] = "sidebar-{$name}.php";
$templates[] = 'sidebar.php';
// Backward compat code will be removed in a future release
if ('' == locate_template($templates, true))
load_template( ABSPATH . WPINC . '/theme-compat/sidebar.php');
}
这个函数默认加载的是sidebar.php文件,也可以传入不同的$name,来加载sidebar-{$name}.php类型的php文件,实现不同的页面可以load不同的侧边栏,头部和尾部的代码与侧边栏的代码类似。wordpress中模板的php文件加载均采用了类似的罗辑。
除了加载模板的php文件,index.php中还调用了wordpress中定义的一些函数,下面我们看看这些函数是 干什么的。
function have_posts() { global $wp_query; return $wp_query->have_posts(); }
$wp_query是在初始化时创建的WP_Query对象;
$GLOBALS['wp_query'] = new WP_Query();
在wp-setting.php中执行。该对象的have_posts()返回当前的url查询罗辑下是否还是需要显示的post。
the_post()将全局的$post对象设置为下一个选择的post。
function get_template_part( $slug, $name = null ) { /** * Fires before the specified template part file is loaded. * * The dynamic portion of the hook name, `$slug`, refers to the slug name * for the generic template part. * * @since 3.0.0 * * @param string $slug The slug name for the generic template. * @param string $name The name of the specialized template. */ do_action( "get_template_part_{$slug}", $slug, $name ); $templates = array(); $name = (string) $name; if ( '' !== $name ) $templates[] = "{$slug}-{$name}.php"; $templates[] = "{$slug}.php"; locate_template($templates, true, false); }
上面的代码是一个通用的加载模板php文件的函数,类似于get_header,但是比他们更通用。通过槽位和name的限定,来实现更灵活的加载模板。
get_template_part( 'content', get_post_format() );
上面这行代码会加载 content.php模板文件,其中包含了一个post显示的html代码
php /** * The default template for displaying content * * Used for both single and index/archive/search. * * @package WordPress * @subpackage Twenty_Thirteen * @since Twenty Thirteen 1.0 */ ?>> <header class="entry-header"> if ( has_post_thumbnail() && ! post_password_required() && ! is_attachment() ) : ?> class="entry-thumbnail">endif; ?> if ( is_single() ) : ?>class="entry-title">
else : ?>class="entry-title">
endif; // is_single() ?>class="entry-meta"> ', '' ); ?>header> if ( is_search() ) : // Only display Excerpts for Search ?>class="entry-summary">else : ?>class="entry-content"> php /* translators: %s: Name of current post */ the_content( sprintf( __( 'Continue reading %s ', 'twentythirteen' ), the_title( '', '', false ) ) ); wp_link_pages( array( 'before' => 'endif; ?>' . __( 'Pages:', 'twentythirteen' ) . '', 'after' => '', 'link_before' => '', 'link_after' => '' ) ); ?>
content.php是页面里一个post的显示模板,排版什么的我们先不关心, 看看里面用到的wordpress的函数。这些函数主要在post-template.php中
- the_ID(): echo当前post的id
- post_class(): Display the classes for the post div.
- the_title: Display or retrieve the current post title with optional content.
- the_permalink():Display the permalink for the current post.
- the_excerpt():Display the post excerpt.
- the_content(): Display the post content.
只列出了几个要紧的函数,wordpress就是通过这些一个个的代码片段,最终拼接出一个完整的显示页面。
页面的数据获取
上面主要说了在获取数据后,如何用数据拼接成一个完整的页面。继续来看看数据是如何获取的。
wordpress在query.php文件中定以了一个WP_Query类,这个类负责对GET和POST请求的参数进行解析,维护在一个页面显示周期里所需要的数据读取。封装了基本的数据读取工作。
主要的数据读取在WP_Query的 get_posts()函数中,该函数有一千多行,主要就是利用$wpdb从数据库读取数据,封装到对应的POST对象中。get_posts()函数可能在 在WP_Query构造时调用,主要依赖于是否传入了查询字符串。
public function __construct($query = '') { if ( ! empty($query) ) { $this->query($query); } }
public function query( $query ) { $this->init(); $this->query = $this->query_vars = wp_parse_args( $query ); return $this->get_posts(); }
WP_Query的 init函数主要建立一个干净的变量环境。get_posts函数中有大量的各种参数的解析罗辑。
WP类的main函数是调用页面数据的入口。其中会建立查询字符串,然后调用上面的query函数来检索相应的post。打开首页是传入的查询字符串对象为空。
函数get_posts中会按照查询参数,拼接处要使用的sql语句,代码很长,杂,逻辑比较多。拼好字符串后,在用$wpdb这个wpdb类实例(wp-db.php文件中)来进行数据库操作。这个类中封装了读取mysql的代码。具体的文档可以参看
https://codex.wordpress.org/Function_Reference/wpdb_Class
这个文章我大概看了下,主要是对mysql的一个简单封装。