wordpress学习三：wordpress自带的模板学习
在《学习二》里，大概说了下怎么去查找模板，本节我们以一个简单的模板为例子，继续说说wordpress的模板机制，看看做一个自己的模板需要哪些知识点。
页面模板渲染
wordpress的模板位于wp-content/themes目录下，wordpress可以自动加载新增的模板目录。通过上一节的简单介绍，知道wordpress默认打开时会查找home.php或者index.php。我们先看看wordpress自带的模板twentyfifteen的index.php页面。
<?php get_header(); ?> <div id="primary" class="content-area"> <div id="content" class="site-content" role="main"> <?php if ( have_posts() ) : ?> <?php /* The loop */ ?> <?php while ( have_posts() ) : the_post(); ?> <?php get_template_part( 'content', get_post_format() ); ?> <?php endwhile; ?> <?php twentythirteen_paging_nav(); ?> <?php else : ?> <?php get_template_part( 'content', 'none' ); ?> <?php endif; ?> </div><!-- #content --> </div><!-- #primary --> <?php get_sidebar(); ?> <?php get_footer(); ?>
这个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 */ ?> <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>> <header class="entry-header"> <?php if ( has_post_thumbnail() && ! post_password_required() && ! is_attachment() ) : ?> <div class="entry-thumbnail"> <?php the_post_thumbnail(); ?> </div> <?php endif; ?> <?php if ( is_single() ) : ?> <h1 class="entry-title"><?php the_title(); ?></h1> <?php else : ?> <h1 class="entry-title"> <a href="<?php the_permalink(); ?>" rel="bookmark"><?php the_title(); ?></a> </h1> <?php endif; // is_single() ?> <div class="entry-meta"> <?php twentythirteen_entry_meta(); ?> <?php edit_post_link( __( 'Edit', 'twentythirteen' ), '<span class="edit-link">', '</span>' ); ?> </div><!-- .entry-meta --> </header><!-- .entry-header --> <?php if ( is_search() ) : // Only display Excerpts for Search ?> <div class="entry-summary"> <?php the_excerpt(); ?> </div><!-- .entry-summary --> <?php else : ?> <div class="entry-content"> <?php /* translators: %s: Name of current post */ the_content( sprintf( __( 'Continue reading %s <span class="meta-nav">→</span>', 'twentythirteen' ), the_title( '<span class="screen-reader-text">', '</span>', false ) ) ); wp_link_pages( array( 'before' => '<div class="page-links"><span class="page-links-title">' . __( 'Pages:', 'twentythirteen' ) . '</span>', 'after' => '</div>', 'link_before' => '<span>', 'link_after' => '</span>' ) ); ?> </div><!-- .entry-content --> <?php endif; ?> <footer class="entry-meta"> <?php if ( comments_open() && ! is_single() ) : ?> <div class="comments-link"> <?php comments_popup_link( '<span class="leave-reply">' . __( 'Leave a comment', 'twentythirteen' ) . '</span>', __( 'One comment so far', 'twentythirteen' ), __( 'View all % comments', 'twentythirteen' ) ); ?> </div><!-- .comments-link --> <?php endif; // comments_open() ?> <?php if ( is_single() && get_the_author_meta( 'description' ) && is_multi_author() ) : ?> <?php get_template_part( 'author-bio' ); ?> <?php endif; ?> </footer><!-- .entry-meta --> </article><!-- #post -->
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的一个简单封装。
