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">&rarr;</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的一个简单封装。