您现在的位置是:首页 > 教程 > WordPress教程WordPress教程

wordpress模板机制分析介绍

秋翠2025-03-25 15:42:01WordPress教程已有2人查阅

导读我们以一个简单的模板为例子,继续说说wordpress的模板机制,看看做一个自己的模板需要哪些知识点。页面模板渲染wordpress的模板位于wp-content/themes目录下,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的代码。

本文标签:

很赞哦! (0)

暂无内容
暂无内容
暂无内容
暂无内容
留言与评论 (共有 0 条评论)
昵称:
匿名发表 登录账号
         
验证码: