当我们进行 WordPress 开发的时候,首先我们必须要了解主循环和全局变量,这样才知道可以访问哪个全局变量。下面就讲解下 WordPress 主循环,以便能更好理解哪些全局变量可以被主循环中的模板函数调用。
WordPress 主循环
WordPress 主循环(The Loop)是用来显示日志列表,和在单篇日志页面页显示留言列表的。
在默认主题的 index.php 中,主循环的代码如下:
<?php if (have_posts()) : ?><?php while (have_posts()) : the_post(); ?>
have_posts()
和 the_post()
这两个函数都是类 WP_Query 的方法。
have_posts 这个函数去查看当前显示的日志数是否达到了在 WordPress 后台设置的要显示的日志数,这个主循环将会继续直到达到为止。
如果你看过过 the_post 函数的源代码,就会发现它会搜索 $post 这个全局变量。 the_post 函数获取第一篇日志(随后的日志通过每次循环获取下一个),并设置日志的数据(如作者,多重-页面,等等),这些数据是 WordPress 赋给 $post 这个全局变量的,所以我们可以访问它。
the_post() 函数被调用之后,我们就可以使用许多模板函数和全局变量。
下面就是现在可用的部分模板函数:
- the_author:获取作者的名字。
- the_title:显示当前日志的标题。
- the_content:显示日志的内容。
- the_permalink:显示日志的永久链接的 URL 。
- the_ID:显示日志的 ID 。
下面是在主循环中可用的全局变量:
全局变量 authordata:
global $authordata; echo $authordata->display_name;
通过 authordata 这个全局变量还可以获取作者的下面这些信息:last_name,first_name,ID,user_email,user_url,user_login,description 和其他。
全局变量 post:
global $post; echo $post->post_content;
通过 post 这个全局变量还可以获取文章的这些信息:ID,post_title, post_author,post_date,post_excerpt,comment_count 和其他。
注意通过这种方法获取的日志内容是没有经过过虑的。如果你想自己去操纵日志的内容,比如自己设置日志内容的显示方式,通过这种方式获取的日志内容非常有用。
全局变量 id:
global $id; echo $id;
制作你自己的模板函数
假设我们写了一个叫做 get_my_trackback 自定义的模板函数,它能够在文章的留言循环中每次检测到留言如果是 trackback 的时候做出一些动作。我们可以把这个函数放入 comment.php 模板文件的 foreach 留言循环中。
<?php foreach ($comments as $comment) : ?><?php get_my_trackback();?><?php endforeach; /* end for each comment */ ?>
然后在当前主题的 function 文件中添加 get_my_trackback 函数代码:
<?php function get_my_trackback() {
global $comment;
if (empty($comment))
return;
if ($comment->comment_type != 'comment') {
//do trackback stuff
}
}
?>
comments 这个全局变量能够让我们访问到当前留言的所有数据,所以可以让我们对留言做任何事情。